관리-도구

편집 파일: Typography.php

<?php
/**
 * Override field methods
 *
 * @package   kirki-framework/control-typography
 * @copyright Copyright (c) 2023, Themeum
 * @license   https://opensource.org/licenses/MIT
 * @since     1.0
 */

namespace Kirki\Field;

use Kirki\Util\Helper;
use Kirki\Field;
use Kirki\GoogleFonts;
use Kirki\Module\Webfonts\Fonts;

/**
 * Field overrides.
 *
 * @since 1.0
 */
class Typography extends Field {

/**
	 * The field type.
	 *
	 * @access public
	 * @since 1.0
	 * @var string
	 */
	public $type = 'kirki-typography';

/**
	 * Has the glogal fonts var been added already?
	 *
	 * @static
	 * @access private
	 * @since 1.0
	 * @var bool
	 */
	private static $fonts_var_added = false;

/**
	 * Has the preview related var been added already?
	 *
	 * @static
	 * @access private
	 * @since 1.0
	 * @var bool
	 */
	private static $preview_var_added = false;

/**
	 * An array of typography controls.
	 *
	 * This is used by the typography script for any custom logic
	 * that has to be applied to typography controls.
	 *
	 * @static
	 * @access private
	 * @since 1.0
	 * @var array
	 */
	private static $typography_controls = [];

/**
	 * An array of standard font variants.
	 *
	 * @access private
	 * @since 1.0.1
	 *
	 * @var array
	 */
	private static $std_variants;

/**
	 * An array of complete font variants.
	 *
	 * @access private
	 * @since 1.0.1
	 *
	 * @var array
	 */
	private static $complete_variants;

/**
	 * An array of complete font variant labels.
	 *
	 * @access private
	 * @since 1.0.2
	 *
	 * @var array
	 */
	private static $complete_variant_labels = [];

/**
	 * Extra logic for the field.
	 *
	 * Adds all sub-fields.
	 *
	 * @access public
	 * @param array $args The arguments of the field.
	 */
	public function init( $args = [] ) {

self::$typography_controls[] = $args['settings'];

self::$std_variants = [
			[
				'value' => 'regular',
				'label' => __( 'Regular', 'kirki' ),
			],
			[
				'value' => 'italic',
				'label' => __( 'Italic', 'kirki' ),
			],
			[
				'value' => '700',
				'label' => __( '700', 'kirki' ),
			],
			[
				'value' => '700italic',
				'label' => __( '700 Italic', 'kirki' ),
			],
		];

self::$complete_variants = [
			[
				'value' => 'regular',
				'label' => __( 'Regular', 'kirki' ),
			],
			[
				'value' => 'italic',
				'label' => __( 'Italic', 'kirki' ),
			],
			[
				'value' => '100',
				'label' => __( '100', 'kirki' ),
			],
			[
				'value' => '100italic',
				'label' => __( '100 Italic', 'kirki' ),
			],
			[
				'value' => '200',
				'label' => __( '200', 'kirki' ),
			],
			[
				'value' => '200italic',
				'label' => __( '200 Italic', 'kirki' ),
			],
			[
				'value' => '300',
				'label' => __( '300', 'kirki' ),
			],
			[
				'value' => '300italic',
				'label' => __( '300 Italic', 'kirki' ),
			],
			[
				'value' => '500',
				'label' => __( '500', 'kirki' ),
			],
			[
				'value' => '500italic',
				'label' => __( '500 Italic', 'kirki' ),
			],
			[
				'value' => '600',
				'label' => __( '600', 'kirki' ),
			],
			[
				'value' => '600italic',
				'label' => __( '600 Italic', 'kirki' ),
			],
			[
				'value' => '700',
				'label' => __( '700', 'kirki' ),
			],
			[
				'value' => '700italic',
				'label' => __( '700 Italic', 'kirki' ),
			],
			[
				'value' => '800',
				'label' => __( '800', 'kirki' ),
			],
			[
				'value' => '800italic',
				'label' => __( '800 Italic', 'kirki' ),
			],
			[
				'value' => '900',
				'label' => __( '900', 'kirki' ),
			],
			[
				'value' => '900italic',
				'label' => __( '900 Italic', 'kirki' ),
			],
		];

foreach ( self::$complete_variants as $variants ) {
			self::$complete_variant_labels[ $variants['value'] ] = $variants['label'];
		}

$this->add_sub_fields( $args );

add_action( 'customize_controls_enqueue_scripts', [ $this, 'enqueue_control_scripts' ] );
		add_action( 'customize_preview_init', [ $this, 'enqueue_preview_scripts' ] );
		add_filter( 'kirki_output_control_classnames', [ $this, 'output_control_classnames' ] );
	}

/**
	 * Add sub-fields.
	 *
	 * @access private
	 * @since 1.0
	 * @param array $args The field arguments.
	 * @return void
	 */
	private function add_sub_fields( $args ) {

$args['kirki_config'] = isset( $args['kirki_config'] ) ? $args['kirki_config'] : 'global';

$defaults = isset( $args['default'] ) ? $args['default'] : [];

/**
		 * Add a hidden field, the label & description.
		 */
		new \Kirki\Field\Generic(
			wp_parse_args(
				[
					'sanitize_callback' => isset( $args['sanitize_callback'] ) ? $args['sanitize_callback'] : [ __CLASS__, 'sanitize' ],
					'wrapper_opts'      => [
						'gap' => 'small',
					],
					'input_attrs'       => '',
					'choices'           => [
						'type'        => 'hidden',
						'parent_type' => 'kirki-typography',
					],
				],
				$args
			)
		);

$args['parent_setting'] = $args['settings'];
		$args['output']         = [];
		$args['wrapper_attrs']  = [
			'data-kirki-parent-control-type' => 'kirki-typography',
		];

if ( isset( $args['transport'] ) && 'auto' === $args['transport'] ) {
			$args['transport'] = 'postMessage';
		}

/**
		 * Add font-family selection controls.
		 * These include font-family and variant.
		 * They are grouped here because all they are required.
		 * in order to get the right googlefont variant.
		 */
		if ( isset( $args['default']['font-family'] ) ) {

$args['wrapper_attrs']['kirki-typography-subcontrol-type'] = 'font-family';

/**
			 * Add font-family control.
			 */
			new \Kirki\Field\ReactSelect(
				wp_parse_args(
					[
						'label'       => esc_html__( 'Font Family', 'kirki' ),
						'description' => '',
						'settings'    => $args['settings'] . '[font-family]',
						'default'     => isset( $args['default']['font-family'] ) ? $args['default']['font-family'] : '',
						'input_attrs' => $this->filter_preferred_choice_setting( 'input_attrs', 'font-family', $args ),
						'choices'     => [], // The choices will be populated later inside `get_font_family_choices` function in this file.
						'css_vars'    => [],
						'output'      => [],
					],
					$args
				)
			);

/**
			 * Add font variant.
			 */
			$font_variant = isset( $args['default']['variant'] ) ? $args['default']['variant'] : 'regular';

if ( isset( $args['default']['font-weight'] ) ) {
				$font_variant = 400 === $args['default']['font-weight'] || '400' === $args['default']['font-weight'] ? 'regular' : $args['default']['font-weight'];
			}

$args['wrapper_attrs']['kirki-typography-subcontrol-type'] = 'font-variant';

new \Kirki\Field\ReactSelect(
				wp_parse_args(
					[
						'label'       => esc_html__( 'Font Variant', 'kirki' ),
						'description' => '',
						'settings'    => $args['settings'] . '[variant]',
						'default'     => $font_variant,
						'input_attrs' => $this->filter_preferred_choice_setting( 'input_attrs', 'variant', $args ),
						'choices'     => [], // The choices will be populated later inside `get_variant_choices` function in this file.
						'css_vars'    => [],
						'output'      => [],
					],
					$args
				)
			);

}

$font_size_field_specified = isset( $defaults['font-size'] );
		$color_field_specified     = isset( $defaults['color'] );

if ( $font_size_field_specified || $color_field_specified ) {
			$group = [
				'font-size' => [
					'type'         => 'dimension',
					'label'        => esc_html__( 'Font Size', 'kirki' ),
					'is_specified' => $font_size_field_specified,
				],
				'color'     => [
					'type'         => 'react-colorful',
					'label'        => esc_html__( 'Font Color', 'kirki' ),
					'is_specified' => $color_field_specified,
					'choices'      => [
						'alpha'       => true,
						'label_style' => 'top',
					],
				],
			];