Update to Kirki 4.2.0

functions/kirki/kirki-packages/control-custom/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/kirki-packages/control-custom/src/Control/Custom.php

@@ -0,0 +1,64 @@
+<?php
+/**
+ * Customizer Control: custom.
+ *
+ * Creates a new custom control.
+ * Custom controls accept raw HTML/JS.
+ *
+ * @package   kirki-framework/control-custom
+ * @copyright Copyright (c) 2023, Themeum
+ * @license   https://opensource.org/licenses/MIT
+ * @since     1.0
+ */
+
+namespace Kirki\Control;
+
+use Kirki\Control\Base;
+
+/**
+ * The "custom" control allows you to add any raw HTML.
+ *
+ * @since 1.0
+ */
+class Custom extends Base {
+
+	/**
+	 * The control type.
+	 *
+	 * @access public
+	 * @since 1.0
+	 * @var string
+	 */
+	public $type = 'kirki-custom';
+
+	/**
+	 * 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() {
+		?>
+		<label>
+			<# if ( data.label ) { #><span class="customize-control-title">{{{ data.label }}}</span><# } #>
+			<# if ( data.description ) { #><span class="description customize-control-description">{{{ data.description }}}</span><# } #>
+			<?php
+				/**
+				 * The value is defined by the developer in the field configuration as 'default'.
+				 * There is no user input on this field, it's a raw HTML/JS field and we do not sanitize it.
+				 * Do not be alarmed, this is not a security issue.
+				 * In order for someone to be able to change this they would have to have access to your filesystem.
+				 * If that happens, they can change whatever they want anyways. This field is not a concern.
+				 */
+			?>
+			{{{ data.value }}}
+		</label>
+		<?php
+	}
+}

functions/kirki/kirki-packages/control-custom/src/Field/Custom.php

@@ -0,0 +1,84 @@
+<?php
+/**
+ * Override field methods when used with the Kirki API.
+ *
+ * @package   kirki-framework/control-custom
+ * @copyright Copyright (c) 2023, Themeum
+ * @license   https://opensource.org/licenses/MIT
+ * @since     1.0
+ */
+
+namespace Kirki\Field;
+
+use Kirki\Field;
+
+/**
+ * Field overrides.
+ *
+ * @since 1.0
+ */
+class Custom extends Field {
+
+	/**
+	 * The field type.
+	 *
+	 * @access public
+	 * @since 1.0
+	 * @var string
+	 */
+	public $type = 'kirki-custom';
+
+	/**
+	 * The control class-name.
+	 *
+	 * @access protected
+	 * @since 0.1
+	 * @var string
+	 */
+	protected $control_class = '\Kirki\Control\Custom';
+
+	/**
+	 * 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 );
+			if ( ! isset( $args['sanitize_callback'] ) || ! $args['sanitize_callback'] ) {
+				$args['sanitize_callback'] = '__return_null';
+			}
+		}
+		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-custom';
+		}
+		return $args;
+	}
+}