Update to Kirki 4.0.22

functions/kirki/packages/kirki-framework/control-multicheck/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 kirki-framework
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

functions/kirki/packages/kirki-framework/control-multicheck/README.md

@@ -0,0 +1,62 @@
+# control-multicheck
+
+## Installation
+
+First, install the package using composer:
+
+```bash
+composer require kirki-framework/control-multicheck
+```
+
+Make sure you include the autoloader:
+```php
+require_once get_parent_theme_file_path( 'vendor/autoload.php' );
+```
+
+To add a control using the customizer API:
+
+```php
+
+/**
+ * Registers the control and whitelists it for JS templating.
+ *
+ * @since 1.0
+ * @param WP_Customize_Manager $wp_customize The WP_Customize_Manager object.
+ * @return void
+ */
+add_action( 'customize_register', function( $wp_customize ) {
+	$wp_customize->register_control_type( '\Kirki\Control\Multicheck' );
+} );
+
+/**
+ * Add Customizer settings & controls.
+ * 
+ * @since 1.0
+ * @param WP_Customize_Manager $wp_customize The WP_Customize_Manager object.
+ * @return void
+ */
+add_action( 'customize_register', function( $wp_customize ) {
+
+	// Add setting.
+	$wp_customize->add_setting( 'my_control', [
+		'type'              => 'theme_mod',
+		'capability'        => 'edit_theme_options',
+		'default'           => [ 'option-1', 'option-3', 'option-4' ],
+		'transport'         => 'refresh', // Or postMessage.
+		'sanitize_callback' => 'sanitize_text_field', // Or a custom sanitization callback.
+	] );
+
+	// Add control.
+	$wp_customize->add_control( new \Kirki\Control\Multicheck( $wp_customize, 'my_control', [
+		'label'   => esc_html__( 'My Control', 'theme_textdomain' ),
+		'section' => 'my_section',
+		'choices' => [
+			'option-1' => esc_html__( 'Option 1', 'theme_textdomain' ),
+			'option-2' => esc_html__( 'Option 2', 'theme_textdomain' ),
+			'option-3' => esc_html__( 'Option 3', 'theme_textdomain' ),
+			'option-4' => esc_html__( 'Option 4', 'theme_textdomain' ),
+			'option-5' => esc_html__( 'Option 5', 'theme_textdomain' ),
+		],
+	] ) );
+} );
+```

functions/kirki/packages/kirki-framework/control-multicheck/dist/control.css

@@ -0,0 +1,2 @@
+
+/*# sourceMappingURL=control.css.map */

functions/kirki/packages/kirki-framework/control-multicheck/dist/control.js

@@ -0,0 +1,2 @@
+wp.customize.controlConstructor["kirki-multicheck"]=wp.customize.kirkiDynamicControl.extend({initKirkiControl:function(n){(n=n||this).container.on("change","input",(function(){var i=[],e=0;jQuery.each(n.params.choices,(function(t){n.container.find('input[value="'+t+'"]').is(":checked")?(n.container.find('input[value="'+t+'"]').parent().addClass("checked"),i[e]=t,e++):n.container.find('input[value="'+t+'"]').parent().removeClass("checked")})),n.setting.set(i)}))}});
+//# sourceMappingURL=control.js.map

functions/kirki/packages/kirki-framework/control-multicheck/src/Control/Multicheck.php

@@ -0,0 +1,93 @@
+<?php
+/**
+ * Customizer Control: multicheck.
+ *
+ * Multiple checkbox customize control class.
+ * Props @ Justin Tadlock: http://justintadlock.com/archives/2015/05/26/multiple-checkbox-customizer-control
+ *
+ * @package   kirki-framework/control-multicheck
+ * @copyright Copyright (c) 2019, Ari Stathopoulos (@aristath)
+ * @license   https://opensource.org/licenses/MIT
+ * @since     1.0
+ */
+
+namespace Kirki\Control;
+
+use Kirki\Control\Base;
+use Kirki\URL;
+
+// Exit if accessed directly.
+if ( ! defined( 'ABSPATH' ) ) {
+	exit;
+}
+
+/**
+ * Adds a multicheck control.
+ *
+ * @since 1.0
+ */
+class Multicheck extends Base {
+
+	/**
+	 * The control type.
+	 *
+	 * @access public
+	 * @since 1.0
+	 * @var string
+	 */
+	public $type = 'kirki-multicheck';
+
+	/**
+	 * The version. Used in scripts & styles for cache-busting.
+	 *
+	 * @static
+	 * @access public
+	 * @since 1.0
+	 * @var string
+	 */
+	public static $control_ver = '1.0';
+
+	/**
+	 * Enqueue control related scripts/styles.
+	 *
+	 * @access public
+	 * @since 1.0
+	 * @return void
+	 */
+	public function enqueue() {
+		parent::enqueue();
+
+		// Enqueue the script.
+		wp_enqueue_script( 'kirki-control-multicheck', URL::get_from_path( dirname( dirname( __DIR__ ) ) . '/dist/control.js' ), [ 'jquery', 'customize-base', 'kirki-control-base' ], self::$control_ver, false );
+
+		// Enqueue the style.
+		wp_enqueue_style( 'kirki-control-multicheck-style', URL::get_from_path( dirname( dirname( __DIR__ ) ) . '/dist/control.css' ), [], self::$control_ver );
+	}
+
+	/**
+	 * An Underscore (JS) template for this control's content (but not its container).
+	 *
+	 * Class variables for this control class are available in the `data` JS object;
+	 * export custom variables by overriding {@see WP_Customize_Control::to_json()}.
+	 *
+	 * @see WP_Customize_Control::print_template()
+	 *
+	 * @access protected
+	 * @since 1.0
+	 * @return void
+	 */
+	protected function content_template() {
+		?>
+		<# if ( ! data.choices ) { return; } #>
+
+		<# if ( data.label ) { #><span class="customize-control-title">{{{ data.label }}}</span><# } #>
+		<# if ( data.description ) { #><span class="description customize-control-description">{{{ data.description }}}</span><# } #>
+
+		<ul>
+			<# for ( key in data.choices ) { #>
+				<li><label<# if ( _.contains( data.value, key ) ) { #> class="checked"<# } #>><input {{{ data.inputAttrs }}} type="checkbox" value="{{ key }}"<# if ( _.contains( data.value, key ) ) { #> checked<# } #> />{{ data.choices[ key ] }}</label></li>
+			<# } #>
+		</ul>
+		<?php
+	}
+}

functions/kirki/packages/kirki-framework/control-multicheck/src/Field/Multicheck.php

@@ -0,0 +1,100 @@
+<?php
+/**
+ * Override field methods
+ *
+ * @package   kirki-framework/control-multicheck
+ * @copyright Copyright (c) 2019, Ari Stathopoulos (@aristath)
+ * @license   https://opensource.org/licenses/MIT
+ * @since     1.0
+ */
+
+namespace Kirki\Field;
+
+use Kirki\Field;
+
+/**
+ * Field overrides.
+ *
+ * @since 1.0
+ */
+class Multicheck extends Field {
+
+	/**
+	 * The field type.
+	 *
+	 * @access public
+	 * @since 1.0
+	 * @var string
+	 */
+	public $type = 'kirki-multicheck';
+
+	/**
+	 * The control class-name.
+	 *
+	 * @access protected
+	 * @since 0.1
+	 * @var string
+	 */
+	protected $control_class = '\Kirki\Control\Multicheck';
+
+	/**
+	 * Whether we should register the control class for JS-templating or not.
+	 *
+	 * @access protected
+	 * @since 0.1
+	 * @var bool
+	 */
+	protected $control_has_js_template = true;
+
+	/**
+	 * Filter arguments before creating the setting.
+	 *
+	 * @access public
+	 * @since 0.1
+	 * @param array                $args         The field arguments.
+	 * @param WP_Customize_Manager $wp_customize The customizer instance.
+	 * @return array
+	 */
+	public function filter_setting_args( $args, $wp_customize ) {
+		if ( $args['settings'] === $this->args['settings'] ) {
+			$args = parent::filter_setting_args( $args, $wp_customize );
+
+			// Set the sanitize-callback if none is defined.
+			if ( ! isset( $args['sanitize_callback'] ) || ! $args['sanitize_callback'] ) {
+				$args['sanitize_callback'] = [ __CLASS__, 'sanitize' ];
+			}
+		}
+		return $args;
+	}
+
+	/**
+	 * Filter arguments before creating the control.
+	 *
+	 * @access public
+	 * @since 0.1
+	 * @param array                $args         The field arguments.
+	 * @param WP_Customize_Manager $wp_customize The customizer instance.
+	 * @return array
+	 */
+	public function filter_control_args( $args, $wp_customize ) {
+		if ( $args['settings'] === $this->args['settings'] ) {
+			$args         = parent::filter_control_args( $args, $wp_customize );
+			$args['type'] = 'kirki-multicheck';
+		}
+		return $args;
+	}
+
+	/**
+	 * The sanitize method that will be used as a falback
+	 *
+	 * @static
+	 * @access public
+	 * @since 1.0
+	 * @param string|array $value The control's value.
+	 * @return array
+	 */
+	public static function sanitize( $value ) {
+		$value = ( ! is_array( $value ) ) ? explode( ',', $value ) : $value;
+		return ( ! empty( $value ) ) ? array_map( 'sanitize_text_field', $value ) : [];
+	}
+}

functions/kirki/packages/kirki-framework/control-multicheck/src/control.js

@@ -0,0 +1,28 @@
+import "./control.scss";
+
+wp.customize.controlConstructor['kirki-multicheck'] = wp.customize.kirkiDynamicControl.extend( {
+
+	initKirkiControl: function( control ) {
+		control = control || this;
+
+		// Save the value
+		control.container.on( 'change', 'input', function() {
+			var value = [],
+				i = 0;
+
+			// Build the value as an object using the sub-values from individual checkboxes.
+			jQuery.each( control.params.choices, function( key ) {
+				if ( control.container.find( 'input[value="' + key + '"]' ).is( ':checked' ) ) {
+					control.container.find( 'input[value="' + key + '"]' ).parent().addClass( 'checked' );
+					value[ i ] = key;
+					i++;
+				} else {
+					control.container.find( 'input[value="' + key + '"]' ).parent().removeClass( 'checked' );
+				}
+			} );
+
+			// Update the value in the customizer.
+			control.setting.set( value );
+		} );
+	}
+} );