aristath/kirki

<?php
/**
 * Injects tooltips to controls when the 'tooltip' argument is used.
 *
 * @package   Kirki
 * @category  Modules
 * @author    Ari Stathopoulos (@aristath)
 * @copyright Copyright (c) 2019, Ari Stathopoulos (@aristath)
 * @license   https://opensource.org/licenses/MIT
 * @since     1.0
 */

namespace Kirki\Module;

use Kirki\URL;

/**
 * Adds the tooltips.
 *
 * @since 1.0
 */
class Tooltips {

    /**
     * An array containing field identifieds and their tooltips.
     *
     * @access private
     * @since 1.0
     * @var array
     */
    private $tooltips_content = [];

    /**
     * The class constructor
     *
     * @access public
     * @since 1.0
     */
    public function __construct() {

        add_action( 'customize_controls_print_footer_scripts', [ $this, 'customize_controls_print_footer_scripts' ] );
        add_filter( 'kirki_field_add_control_args', [ $this, 'filter_control_args' ], 10, 2 );

    }

    /**
     * Enqueue scripts.
     *
     * @access public
     * @since 1.0
     */
    public function customize_controls_print_footer_scripts() {

        wp_enqueue_script( 'kirki-tooltip', URL::get_from_path( dirname( __DIR__ ) . '/dist/control.js' ), [ 'jquery' ], '4.0', false );
        wp_localize_script( 'kirki-tooltip', 'kirkiTooltips', $this->tooltips_content );
        wp_enqueue_style( 'kirki-tooltip', URL::get_from_path( dirname( __DIR__ ) . '/dist/control.css' ), [], '4.0' );

    }

    /**
     * Filter control args.
     *
     * @access public
     * @since 1.0
     * @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 ( isset( $args['tooltip'] ) && $args['tooltip'] ) {
            $this->tooltips_content[ $args['settings'] ] = [
                'id'      => sanitize_key( $args['settings'] ),
                'content' => wp_kses_post( $args['tooltip'] ),
            ];
        }
        return $args;
    }
}