WordPress.org

Make WordPress Core

Ticket #21303: diff.patch

File diff.patch, 2.9 KB (added by bananastalktome, 3 years ago)

Updated tabs

  • wp-includes/class-wp-customize-control.php

     
    66 * @subpackage Customize 
    77 * @since 3.4.0 
    88 */ 
    9  
    109class WP_Customize_Control { 
     10        /** 
     11         * @access public 
     12         * @var WP_Customize_Manager 
     13         */ 
    1114        public $manager; 
     15         
     16        /** 
     17         * @access public 
     18         * @var int 
     19         */ 
    1220        public $id; 
    1321 
    14         // All settings tied to the control. 
     22        /** 
     23         * All settings tied to the control. 
     24         * 
     25         * @access public 
     26         * @var array 
     27         */ 
    1528        public $settings; 
    1629 
    17         // The primary setting for the control (if there is one). 
     30        /** 
     31         * The primary setting for the control (if there is one). 
     32         * 
     33         * @access public 
     34         * @var string 
     35         */ 
    1836        public $setting = 'default'; 
    1937 
     38        /** 
     39         * @access public 
     40         * @var int 
     41         */ 
    2042        public $priority          = 10; 
     43         
     44        /** 
     45         * @access public 
     46         * @var string 
     47         */ 
    2148        public $section           = ''; 
     49         
     50        /** 
     51         * @access public 
     52         * @var string 
     53         */ 
    2254        public $label             = ''; 
    23         // @todo: remove choices 
     55         
     56        /** 
     57         * @todo: Remove choices 
     58         * 
     59         * @access public 
     60         * @var array 
     61         */ 
    2462        public $choices           = array(); 
    2563 
     64        /** 
     65         * @access public 
     66         * @var array 
     67         */ 
    2668        public $json = array(); 
    2769 
     70        /** 
     71         * @access public 
     72         * @var string 
     73         */ 
    2874        public $type = 'text'; 
    2975 
    3076 
     
    3480         * If $args['settings'] is not defined, use the $id as the setting ID. 
    3581         * 
    3682         * @since 3.4.0 
     83         * 
     84         * @param WP_Customize_Manager $manager 
     85         * @param int $id 
     86         * @param array $args 
    3787         */ 
    3888        function __construct( $manager, $id, $args = array() ) { 
    3989                $keys = array_keys( get_object_vars( $this ) ); 
     
    75125         * Grabs the main setting by default. 
    76126         * 
    77127         * @since 3.4.0 
     128         * 
     129         * @param string $setting_key 
     130         * @return mixed The requested setting's value, if the setting exists. 
    78131         */ 
    79132        public final function value( $setting_key = 'default' ) { 
    80133                if ( isset( $this->settings[ $setting_key ] ) ) 
     
    119172         * Check capabilities and render the control. 
    120173         * 
    121174         * @since 3.4.0 
     175         * @see render() 
    122176         */ 
    123177        public final function maybe_render() { 
    124178                if ( ! $this->check_capabilities() ) 
     
    143197                        <?php $this->render_content(); ?> 
    144198                </li><?php 
    145199        } 
    146  
     200         
     201        /** 
     202         * Get the data link parameter for a setting. 
     203         * 
     204         * @since 3.4.0 
     205         * 
     206         * @param string $setting_key 
     207         * @return string Data link parameter, if $setting_key is a valid setting, empty string otherwise. 
     208         */ 
    147209        public function get_link( $setting_key = 'default' ) { 
    148210                if ( ! isset( $this->settings[ $setting_key ] ) ) 
    149211                        return ''; 
    150212 
    151213                return 'data-customize-setting-link="' . esc_attr( $this->settings[ $setting_key ]->id ) . '"'; 
    152214        } 
    153  
     215         
     216        /** 
     217         * Render the data link parameter for a setting 
     218         * 
     219         * @since 3.4.0 
     220         * @see get_link() 
     221         * 
     222         * @param string $setting_key 
     223         */ 
    154224        public function link( $setting_key = 'default' ) { 
    155225                echo $this->get_link( $setting_key ); 
    156226        }