/
var
/
www
/
barefootlaw.org
/
wp-content
/
plugins
/
pods
/
tribe-common
/
src
/
Tribe
/
Customizer
/
Upload File
HOME
<?php // Don't load directly defined( 'WPINC' ) or die; /** * The Events Calendar Customizer Section Abstract * Extend this when you are trying to create a new The Events Calendar Section * on the Customize from WordPress * * @package Common * @subpackage Customizer * @since 4.0 */ abstract class Tribe__Customizer__Section { /** * ID of the section * * @since 4.0 * * @access public * @var string */ public $ID; /** * Load this section by default * * @since 4.4 * * @access public * @var string */ public $load = true; /** * Default values for the settings on this class * * @since 4.0 * * @access private * @var array */ public $defaults = []; /** * Information to setup the Section * * @since 4.0 * * @access public * @var array */ public $arguments = [ 'priority' => 10, 'capability' => 'edit_theme_options', 'title' => null, 'description' => null, ]; /** * Overwrite this method to create the Fields/Settings for this section * * @param WP_Customize_Section $section The WordPress section instance * @param WP_Customize_Manager $manager The WordPress Customizer Manager * * @return void */ public function register_settings( WP_Customize_Section $section, WP_Customize_Manager $manager ) { } /** * Overwrite this method to be able to implement the CSS template related to this section * * @return string */ public function get_css_template( $template ) { return $template; } /** * Overwrite this method to be able to creaty dynamic settings * * @param array $settings The actual options on the database * @return array */ public function create_ghost_settings( $settings = [] ) { return $settings; } /** * This method will be executed when the Class in Initialized * Overwrite this method to be able to setup the arguments of your section * * @return void */ abstract public function setup(); /** * Private variable holding the class Instance * * @since 4.0 * * @access private * @var Tribe__Events__Pro__Customizer__Section */ private static $instances; /** * Get the section slug based on the Class name * * @param string $class_name The name of this Class * @return the slug for this class */ final public static function get_section_slug( $class_name ) { $abstract_name = __CLASS__; $reflection = new ReflectionClass( $class_name ); // Get the Slug without the Base name $slug = str_replace( $abstract_name . '_', '', $reflection->getName() ); if ( false !== strpos( $slug, '__Customizer__' ) ) { $slug = explode( '__Customizer__', $slug ); $slug = end( $slug ); } return strtolower( $slug ); } /** * Setup and Load hooks for this Section * * @since 4.0 * * @return Tribe__Customizer__Section */ final public function __construct() { $slug = self::get_section_slug( get_class( $this ) ); // If for weird reason we don't have the Section name if ( ! is_string( $this->ID ) ){ $this->ID = $slug; } // Allow child classes to setup the section $this->setup(); // Hook the Register methods add_action( "tribe_customizer_register_{$this->ID}_settings", [ $this, 'register_settings' ], 10, 2 ); add_filter( 'tribe_customizer_pre_sections', [ $this, 'register' ], 10, 2 ); // Append this section CSS template add_filter( 'tribe_customizer_css_template', [ $this, 'get_css_template' ], 15 ); add_filter( "tribe_customizer_section_{$this->ID}_defaults", [ $this, 'get_defaults' ], 10 ); // Create the Ghost Options add_filter( 'tribe_customizer_pre_get_option', [ $this, 'filter_settings' ], 10, 2 ); // By Default Invoking a new Section will load, unless `load` is set to false if ( true === (bool) $this->load ) { Tribe__Customizer::instance()->load_section( $this ); } } /** * A way to apply filters when getting the Customizer options * @return array */ public function get_defaults( $settings = [] ) { // Create Ghost Options return $this->create_ghost_settings( wp_parse_args( $settings, $this->defaults ) ); } /** * Get the Default Value requested * @return mixed */ public function get_default( $key ) { $defaults = $this->get_defaults(); if ( ! isset( $defaults[ $key ] ) ) { return null; } return $defaults[ $key ]; } /** * Hooks to the `tribe_customizer_pre_get_option`, this applies * the `$this->create_ghost_settings()` method to the settings on the correct section * * @param array $settings Values from the Database from Customizer actions * @param array $search Indexed search @see Tribe__Customizer::search_var() * * @return array */ public function filter_settings( $settings, $search ) { // Exit early. if ( null === $search ) { return $settings; } // Only Apply if getting the full options or Section if ( is_array( $search ) && count( $search ) > 1 ) { return $settings; } if ( is_array( $search ) && count( $search ) === 1 ) { $settings = $this->create_ghost_settings( $settings ); } else { $settings[ $this->ID ] = $this->create_ghost_settings( $settings[ $this->ID ] ); } return $settings; } /** * Register this Section * * @param array $sections Array of Sections * @param Tribe__Customizer $customizer Our internal Cutomizer Class Instance * * @return array Return the modified version of the Section array */ public function register( $sections, Tribe__Customizer $customizer ) { $sections[ $this->ID ] = $this->arguments; return $sections; } }