soderlind/class-customizer-range-value-control

WordPress Customizer Range Value Control is a generic range with value control you can use to replace the default range control.

Fund package maintenance!
Ko Fi

Installs: 241

Dependents: 0

Suggesters: 0

Security: 0

Stars: 23

Watchers: 5

Forks: 13

Open Issues: 0

Language:CSS

Type:wordpress-dropin

dev-master 2019-05-24 13:21 UTC

This package is auto-updated.

Last update: 2024-04-25 06:40:12 UTC


README

A generic range with value control you can use to replace the range control.

customizer-range-value-suffix.png

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-range-value-control": "dev-master"
},
"extra": {
	"installer-paths": {
		"inc/{$name}": [
			"soderlind/class-customizer-range-value-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-range-value-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-range-value-control/class-customizer-range-value-control.php';
}

Adding the control

$wp_customize->add_control( new Customizer_Range_Value_Control( $wp_customize, 'my_control', array(
	'type'     => 'range-value',
	'section'  => 'my_section',
	'settings' => 'my_settings',
	'label'    => __( 'Width' ),
	'input_attrs' => array(
		'min'    => 1,
		'max'    => 240,
		'step'   => 1,
		'suffix' => 'px', //optional suffix
  	),
) ) );

Credits

The CSS and JavaScript is copyright (c) 2016 by Sean Stopnik

You can see his demo at CodePen.io

The CSS and JavaScript is licensed under the terms of the MIT license

Copyright and License

WordPress Customizer Range Value Control is copyright 2016 Per Soderlind

WordPress Customizer Range Value 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 Range Value 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/.