All Projects → soderlind → class-customizer-toggle-control

soderlind / class-customizer-toggle-control

Licence: GPL-2.0 license
WordPress Customizer Toggle Control is a generic toggle control you can use to replace the checkbox control.

Programming Languages

CSS
56736 projects
PHP
23972 projects - #3 most used programming language
javascript
184084 projects - #8 most used programming language

WordPress Customizer Toggle Control

A generic toggle control you can use to replace the checkbox control.

Demo

I've added this control to my customizer demo theme.

Installing the control

Add the following to your composer.json file and run composer update

"require": {
	"soderlind/class-customizer-toggle-control": "dev-master"
},
"extra": {
	"installer-paths": {
		"inc/{$name}": [
			"soderlind/class-customizer-toggle-control"
		]
	}
}

If you want to install into the vendor folder, use

"require": {
	"soderlind/class-customizer-toggle-control": "dev-master"
},
"extra": {
	"installer-paths": {
		"vendor/soderlind/{$name}": [
			"soderlind/class-customizer-toggle-control"
		]
	}
}

or, clone the repo into inc

Include the class

/**
 * Check for WP_Customizer_Control existence before adding custom control because WP_Customize_Control
 * is loaded on customizer page only
 *
 * @see _wp_customize_include()
 */
if ( class_exists( 'WP_Customize_Control' ) ) {
	require_once  dirname( __FILE__ ) . '/inc/class-customizer-toggle-control/class-customizer-toggle-control.php';
}

Adding the control

$wp_customize->add_control( new Customizer_Toggle_Control( $wp_customize, 'my_control', array(
		'label'	      => esc_html__( 'Toggle me on or off', 'my-lang' ),
		'section'     => 'my_section',
		'settings'    => 'my_setting',
		'type'        => 'ios',// light, ios, flat
) ) );

Three different types are available

Toggling the control title

You must update the js/customizer-toggle-control.js file if you want to change the title color when a toggle is disabled/enabled.

Credits

The CSS is copyright (c) 2016 by Mauricio Allende

You can see his demo at CodePen.io

The CSS is licensed under the terms of the MIT license

Copyright and License

WordPress Customizer Toggle Control is copyright 2016 Per Soderlind

WordPress Customizer Toggle Control is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

WordPress Customizer Toggle Control is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with the Extension. If not, see http://www.gnu.org/licenses/.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].