WordPress.org

Make WordPress Core

Ticket #21303: diff.patch

File diff.patch, 2.9 KB (added by bananastalktome, 6 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        }