Ticket #26196: 26196.diff

src/wp-includes/class-wp-customize-section.php

@@ -1 +1 @@
 <?php
 /**
+ * The WP_Customize_Section class
+ *
+ * This class represents a section within the Customizer
+ *
+ * @since 3.4.0
+ *
+ * @package WordPress
+ * @subpackage Customize
+ */
+
+/**
  * Customize Section Class.
  *
  * @package WordPress
@@ -7 +18 @@
  * @since 3.4.0
  */
 class WP_Customize_Section {
+
+        /**
+         * The Customize Manager.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var WP_Customize_Manager $manager The Customize Manager this section relates to
+         */
         public $manager;
+
+        /**
+         * The specific ID of the section.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var string $id The specific ID of the section.
+         */
         public $id;
+
+        /**
+         * The priority of this secion relative to others.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var int $priority The priority of this secion relative to others.
+         *                    Lower numbers are displayed first.
+         */
         public $priority       = 10;
+
+        /**
+         * The capability required to access this section.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var int $capability The capability required to access this section.
+         */
         public $capability     = 'edit_theme_options';
+
+        /**
+         * A theme feature that this section relates to.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var string $theme_supports A theme feature that this section relates to
+         */
         public $theme_supports = '';
+
+        /**
+         * The title of this section.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var string $title The title of this section.
+         */
         public $title          = '';
+
+        /**
+         * The description of this section.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var string $description The description of this section.
+         */
         public $description    = '';
+
+        /**
+         * An array of controls in this section.
+         *
+         * @since 3.4.0
+         * @access public
+         * @var array $controls An array of controls in this section.
+         */
         public $controls;
 
         /**
@@ -66 +142 @@
                 if ( ! $this->check_capabilities() )
                         return;
 
+                /**
+                 * Called before rendering customizer sections.
+                 *
+                 * @since 3.4.0
+                 * @param WP_Customize_Section $var The WP_Customize_Section object.
+                 */
                 do_action( 'customize_render_section', $this );
+                /**
+                 * Called before rendering customizer sections.
+                 *
+                 * @since 3.4.0
+                 * @param string $var The ID of the section about to be rendered.
+                 */
                 do_action( 'customize_render_section_' . $this->id );
 
                 $this->render();