WordPress 4.7

[autoinstalls/wordpress.git] / wp-includes / class-wp-customize-section.php

diff --git a/wp-includes/class-wp-customize-section.php b/wp-includes/class-wp-customize-section.php
index 0a916f2f543c1faf54cde88ae8e01cdcc4d23e8c..68d677133ee95bd61df26f908d2db25119e2220c 100644 (file)
--- a/wp-includes/class-wp-customize-section.php
+++ b/wp-includes/class-wp-customize-section.php
@@ -145,6 +145,18 @@ class WP_Customize_Section {
         */
        public $active_callback = '';
 
+       /**
+        * Show the description or hide it behind the help icon.
+        *
+        * @since 4.7.0
+        * @access public
+        *
+        * @var bool Indicates whether the Section's description should be
+        *           hidden behind a help icon ("?") in the Section header,
+        *           similar to how help icons are displayed on Panels.
+        */
+       public $description_hidden = false;
+
        /**
         * Constructor.
         *
@@ -223,7 +235,7 @@ class WP_Customize_Section {
         * @return array The array to be exported to the client as JSON.
         */
        public function json() {
-               $array = wp_array_slice_assoc( (array) $this, array( 'id', 'description', 'priority', 'panel', 'type' ) );
+               $array = wp_array_slice_assoc( (array) $this, array( 'id', 'description', 'priority', 'panel', 'type', 'description_hidden' ) );
                $array['title'] = html_entity_decode( $this->title, ENT_QUOTES, get_bloginfo( 'charset' ) );
                $array['content'] = $this->get_content();
                $array['active'] = $this->active();
@@ -324,11 +336,11 @@ class WP_Customize_Section {
         * @see WP_Customize_Manager::render_template()
         */
        public function print_template() {
-        ?>
+               ?>
                <script type="text/html" id="tmpl-customize-section-<?php echo $this->type; ?>">
                        <?php $this->render_template(); ?>
                </script>
-        <?php
+               <?php
        }
 
        /**
@@ -350,7 +362,7 @@ class WP_Customize_Section {
                                <span class="screen-reader-text"><?php _e( 'Press return or enter to open this section' ); ?></span>
                        </h3>
                        <ul class="accordion-section-content">
-                               <li class="customize-section-description-container">
+                               <li class="customize-section-description-container section-meta <# if ( data.description_hidden ) { #>customize-info<# } #>">
                                        <div class="customize-section-title">
                                                <button class="customize-section-back" tabindex="-1">
                                                        <span class="screen-reader-text"><?php _e( 'Back' ); ?></span>
@@ -361,8 +373,15 @@ class WP_Customize_Section {
                                                        </span>
                                                        {{ data.title }}
                                                </h3>
+                                               <# if ( data.description && data.description_hidden ) { #>
+                                                       <button type="button" class="customize-help-toggle dashicons dashicons-editor-help" aria-expanded="false"><span class="screen-reader-text"><?php _e( 'Help' ); ?></span></button>
+                                                       <div class="description customize-section-description">
+                                                               {{{ data.description }}}
+                                                       </div>
+                                               <# } #>
                                        </div>
-                                       <# if ( data.description ) { #>
+
+                                       <# if ( data.description && ! data.description_hidden ) { #>
                                                <div class="description customize-section-description">
                                                        {{{ data.description }}}
                                                </div>