EVOLUTION-MANAGER
Edit File: class-kirki-init.php
<?php /** * Initializes Kirki * * @package Kirki * @category Core * @author Ari Stathopoulos (@aristath) * @copyright Copyright (c) 2020, David Vongries * @license https://opensource.org/licenses/MIT * @since 1.0 */ /** * Initialize Kirki */ class Kirki_Init { /** * Control types. * * @access private * @since 3.0.0 * @var array */ private $control_types = array(); /** * Should we show a nag for the deprecated fontawesome field? * * @static * @access private * @since 3.0.42 * @var bool */ private static $show_fa_nag = false; /** * The class constructor. */ public function __construct() { self::set_url(); add_action( 'after_setup_theme', array( $this, 'set_url' ) ); add_action( 'wp_loaded', array( $this, 'add_to_customizer' ), 1 ); add_filter( 'kirki_control_types', array( $this, 'default_control_types' ) ); add_action( 'customize_register', array( $this, 'remove_panels' ), 99999 ); add_action( 'customize_register', array( $this, 'remove_sections' ), 99999 ); add_action( 'customize_register', array( $this, 'remove_controls' ), 99999 ); add_action( 'admin_notices', array( $this, 'admin_notices' ) ); add_action( 'admin_init', array( $this, 'dismiss_nag' ) ); new Kirki_Values(); new Kirki_Sections(); } /** * Properly set the Kirki URL for assets. * * @static * @access public */ public static function set_url() { if ( Kirki_Util::is_plugin() ) { return; } // Get correct URL and path to wp-content. $content_url = untrailingslashit( dirname( dirname( get_stylesheet_directory_uri() ) ) ); $content_dir = wp_normalize_path( untrailingslashit( WP_CONTENT_DIR ) ); Kirki::$url = str_replace( $content_dir, $content_url, wp_normalize_path( Kirki::$path ) ); // Apply the kirki_config filter. $config = apply_filters( 'kirki_config', array() ); if ( isset( $config['url_path'] ) ) { Kirki::$url = $config['url_path']; } // Make sure the right protocol is used. Kirki::$url = set_url_scheme( Kirki::$url ); } /** * Add the default Kirki control types. * * @access public * @since 3.0.0 * @param array $control_types The control types array. * @return array */ public function default_control_types( $control_types = array() ) { $this->control_types = array( 'checkbox' => 'Kirki_Control_Checkbox', 'kirki-background' => 'Kirki_Control_Background', 'code_editor' => 'Kirki_Control_Code', 'kirki-color' => 'Kirki_Control_Color', 'kirki-color-palette' => 'Kirki_Control_Color_Palette', 'kirki-custom' => 'Kirki_Control_Custom', 'kirki-date' => 'Kirki_Control_Date', 'kirki-dashicons' => 'Kirki_Control_Dashicons', 'kirki-dimension' => 'Kirki_Control_Dimension', 'kirki-dimensions' => 'Kirki_Control_Dimensions', 'kirki-editor' => 'Kirki_Control_Editor', 'kirki-image' => 'Kirki_Control_Image', 'kirki-multicolor' => 'Kirki_Control_Multicolor', 'kirki-multicheck' => 'Kirki_Control_MultiCheck', 'kirki-number' => 'Kirki_Control_Number', 'kirki-palette' => 'Kirki_Control_Palette', 'kirki-radio' => 'Kirki_Control_Radio', 'kirki-radio-buttonset' => 'Kirki_Control_Radio_ButtonSet', 'kirki-radio-image' => 'Kirki_Control_Radio_Image', 'repeater' => 'Kirki_Control_Repeater', 'kirki-select' => 'Kirki_Control_Select', 'kirki-slider' => 'Kirki_Control_Slider', 'kirki-sortable' => 'Kirki_Control_Sortable', 'kirki-spacing' => 'Kirki_Control_Dimensions', 'kirki-switch' => 'Kirki_Control_Switch', 'kirki-generic' => 'Kirki_Control_Generic', 'kirki-toggle' => 'Kirki_Control_Toggle', 'kirki-typography' => 'Kirki_Control_Typography', 'image' => 'Kirki_Control_Image', 'cropped_image' => 'Kirki_Control_Cropped_Image', 'upload' => 'Kirki_Control_Upload', ); return array_merge( $this->control_types, $control_types ); } /** * Helper function that adds the fields, sections and panels to the customizer. */ public function add_to_customizer() { $this->fields_from_filters(); add_action( 'customize_register', array( $this, 'register_control_types' ) ); add_action( 'customize_register', array( $this, 'add_panels' ), 97 ); add_action( 'customize_register', array( $this, 'add_sections' ), 98 ); add_action( 'customize_register', array( $this, 'add_fields' ), 99 ); } /** * Register control types */ public function register_control_types() { global $wp_customize; $section_types = apply_filters( 'kirki_section_types', array() ); foreach ( $section_types as $section_type ) { $wp_customize->register_section_type( $section_type ); } $this->control_types = $this->default_control_types(); if ( ! class_exists( 'WP_Customize_Code_Editor_Control' ) ) { unset( $this->control_types['code_editor'] ); } foreach ( $this->control_types as $key => $classname ) { if ( ! class_exists( $classname ) ) { unset( $this->control_types[ $key ] ); } } $skip_control_types = apply_filters( 'kirki_control_types_exclude', array( 'Kirki_Control_Repeater', 'WP_Customize_Control', ) ); foreach ( $this->control_types as $control_type ) { if ( ! in_array( $control_type, $skip_control_types, true ) && class_exists( $control_type ) ) { $wp_customize->register_control_type( $control_type ); } } } /** * Register our panels to the WordPress Customizer. * * @access public */ public function add_panels() { if ( ! empty( Kirki::$panels ) ) { foreach ( Kirki::$panels as $panel_args ) { // Extra checks for nested panels. if ( isset( $panel_args['panel'] ) ) { if ( isset( Kirki::$panels[ $panel_args['panel'] ] ) ) { // Set the type to nested. $panel_args['type'] = 'kirki-nested'; } } new Kirki_Panel( $panel_args ); } } } /** * Register our sections to the WordPress Customizer. * * @var object The WordPress Customizer object */ public function add_sections() { if ( ! empty( Kirki::$sections ) ) { foreach ( Kirki::$sections as $section_args ) { // Extra checks for nested sections. if ( isset( $section_args['section'] ) ) { if ( isset( Kirki::$sections[ $section_args['section'] ] ) ) { // Set the type to nested. $section_args['type'] = 'kirki-nested'; // We need to check if the parent section is nested inside a panel. $parent_section = Kirki::$sections[ $section_args['section'] ]; if ( isset( $parent_section['panel'] ) ) { $section_args['panel'] = $parent_section['panel']; } } } new Kirki_Section( $section_args ); } } } /** * Create the settings and controls from the $fields array and register them. * * @var object The WordPress Customizer object. */ public function add_fields() { global $wp_customize; foreach ( Kirki::$fields as $args ) { // Create the settings. new Kirki_Settings( $args ); // Check if we're on the customizer. // If we are, then we will create the controls, add the scripts needed for the customizer // and any other tweaks that this field may require. if ( $wp_customize ) { // Create the control. new Kirki_Control( $args ); } } } /** * Process fields added using the 'kirki_fields' and 'kirki_controls' filter. * These filters are no longer used, this is simply for backwards-compatibility. * * @access private * @since 2.0.0 */ private function fields_from_filters() { $fields = apply_filters( 'kirki_controls', array() ); $fields = apply_filters( 'kirki_fields', $fields ); if ( ! empty( $fields ) ) { foreach ( $fields as $field ) { Kirki::add_field( 'global', $field ); } } } /** * Alias for the is_plugin static method in the Kirki_Util class. * This is here for backwards-compatibility purposes. * * @static * @access public * @since 3.0.0 * @return bool */ public static function is_plugin() { return Kirki_Util::is_plugin(); } /** * Alias for the get_variables static method in the Kirki_Util class. * This is here for backwards-compatibility purposes. * * @static * @access public * @since 2.0.0 * @return array Formatted as array( 'variable-name' => value ). */ public static function get_variables() { // Log error for developers. _doing_it_wrong( __METHOD__, esc_html__( 'We detected you\'re using Kirki_Init::get_variables(). Please use Kirki_Util::get_variables() instead.', 'kirki' ), '3.0.10' ); return Kirki_Util::get_variables(); } /** * Remove panels. * * @since 3.0.17 * @param object $wp_customize The customizer object. * @return void */ public function remove_panels( $wp_customize ) { foreach ( Kirki::$panels_to_remove as $panel ) { $wp_customize->remove_panel( $panel ); } } /** * Remove sections. * * @since 3.0.17 * @param object $wp_customize The customizer object. * @return void */ public function remove_sections( $wp_customize ) { foreach ( Kirki::$sections_to_remove as $section ) { $wp_customize->remove_section( $section ); } } /** * Remove controls. * * @since 3.0.17 * @param object $wp_customize The customizer object. * @return void */ public function remove_controls( $wp_customize ) { foreach ( Kirki::$controls_to_remove as $control ) { $wp_customize->remove_control( $control ); } } /** * Shows an admin notice. * * @access public * @since 3.0.42 * @return void */ public function admin_notices() { // No need for a nag if we don't need to recommend installing the FA plugin. if ( ! self::$show_fa_nag ) { return; } // No need for a nag if FA plugin is already installed. if ( defined( 'FONTAWESOME_DIR_PATH' ) ) { return; } // No need for a nag if current user can't install plugins. if ( ! current_user_can( 'install_plugins' ) ) { return; } // No need for a nag if user has dismissed it. $dismissed = get_user_meta( get_current_user_id(), 'kirki_fa_nag_dismissed', true ); if ( true === $dismissed || 1 === $dismissed || '1' === $dismissed ) { return; } ?> <div class="notice notice-info is-dismissible"> <p> <?php esc_html_e( 'Your theme uses a Font Awesome field for icons. To avoid issues with missing icons on your frontend we recommend you install the official Font Awesome plugin.', 'kirki' ); ?> </p> <p> <a class="button button-primary" href="<?php echo esc_url( admin_url( 'plugin-install.php?tab=plugin-information&plugin=font-awesome&TB_iframe=true&width=600&height=550' ) ); ?>"><?php esc_html_e( 'Install Plugin', 'kirki' ); ?></a> <a class="button button-secondary" href="<?php echo esc_url( wp_nonce_url( admin_url( '?dismiss-nag=font-awesome-kirki' ), 'kirki-dismiss-nag', 'nonce' ) ); ?>"><?php esc_html_e( 'Don\'t show this again', 'kirki' ); ?></a> </p> </div> <?php } /** * Dismisses the nag. * * @access public * @since 3.0.42 * @return void */ public function dismiss_nag() { if ( isset( $_GET['nonce'] ) && wp_verify_nonce( $_GET['nonce'], 'kirki-dismiss-nag' ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput if ( get_current_user_id() && isset( $_GET['dismiss-nag'] ) && 'font-awesome-kirki' === $_GET['dismiss-nag'] ) { update_user_meta( get_current_user_id(), 'kirki_fa_nag_dismissed', true ); } } } /** * Handles showing a nag if the theme is using the deprecated fontawesome field * * @static * @access protected * @since 3.0.42 * @param array $args The field arguments. * @return void */ protected static function maybe_show_fontawesome_nag( $args ) { // If we already know we want it, skip check. if ( self::$show_fa_nag ) { return; } // Check if the field is fontawesome. if ( isset( $args['type'] ) && in_array( $args['type'], array( 'fontawesome', 'kirki-fontawesome' ), true ) ) { // Skip check if theme has disabled FA enqueueing via a filter. if ( ! apply_filters( 'kirki_load_fontawesome', true ) ) { return; } // If we got this far, we need to show the nag. self::$show_fa_nag = true; } } }