Ticket #34747: a842df4.diff

src/wp-admin/customize.php

@@ -128 +128 @@
                 </div>
 
                 <div id="widgets-right" class="wp-clearfix"><!-- For Widget Customizer, many widgets try to look for instances under div#widgets-right, so we have to add that ID to a container div in the Customizer for compat -->
-                <div class="wp-full-overlay-sidebar-content" tabindex="-1">
-                        <div id="customize-info" class="accordion-section customize-info">
-                                <div class="accordion-section-title">
-                                        <span class="preview-notice"><?php
-                                                echo sprintf( __( 'You are customizing %s' ), '<strong class="panel-title site-title">' . get_bloginfo( 'name' ) . '</strong>' );
-                                        ?></span>
-                                        <button class="customize-help-toggle dashicons dashicons-editor-help" aria-expanded="false"><span class="screen-reader-text"><?php _e( 'Help' ); ?></span></button>
-                                </div>
-                                <div class="customize-panel-description"><?php
-                                        _e( 'The Customizer allows you to preview changes to your site before publishing them. You can also navigate to different pages on your site to preview them.' );
-                                ?></div>
-                        </div>
+                        <div class="wp-full-overlay-sidebar-content" tabindex="-1"><?php
+
+                                $original_customizer_title = get_bloginfo( 'name' );
+
+                                /**
+                                 * Filter title in root Customizer panel.
+                                 *
+                                 * @since 4.6
+                                 *
+                                 * @param string $customizer_title Appears at top of root Customizer panel.
+                                 */
+                                $filtered_customizer_title = apply_filters( 'customize_root_panel_title', $original_customizer_title );
+
+                                if ( ! empty( $filtered_customizer_title ) ):
+                                ?>
+                                        <div id="customize-info" class="accordion-section customize-info">
+                                                <div class="accordion-section-title">
+                                                        <span class="preview-notice"><?php
+                                                                // If the title has been filtered, add a class so that JavaScript won't change it on updating the 'Site Title' control.
+                                                                $is_filtered_class = ( $filtered_customizer_title === $original_customizer_title ) ? '' : ' title-is-filtered';
+                                                                echo sprintf( __( 'You are customizing %s' ), '<strong class="panel-title site-title' . esc_attr( $is_filtered_class ) . '">' . $filtered_customizer_title . '</strong>' );
+                                                        ?></span><?php
+
+                                                        /**
+                                                         * Filter description in primary Customizer panel.
+                                                         *
+                                                         * @since 4.6
+                                                         *
+                                                         * @param string $customizer_description Appears at top of root Customizer panel, under Customizer title.
+                                                         */
+                                                        $customizer_description = apply_filters( 'customize_root_panel_description', __( 'The Customizer allows you to preview changes to your site before publishing them. You can also navigate to different pages on your site to preview them.' ) );
+                                                        if ( ! empty( $customizer_description ) ):
+                                                                ?>
+                                                                <button class="customize-help-toggle dashicons dashicons-editor-help" aria-expanded="false">
+                                                                        <span class="screen-reader-text"><?php _e( 'Help' ); ?></span>
+                                                                </button>
+                                                        <?php endif; ?>
+                                                </div>
+                                                <div class="customize-panel-description">
+                                                        <?php echo $customizer_description; ?>
+                                                </div>
+                                        </div>
+                                <?php endif; ?>
 
                         <div id="customize-theme-controls">
                                 <ul><?php // Panels and sections are managed here via JavaScript ?></ul>

src/wp-admin/js/customize-controls.js

@@ -3653 +3653 @@
                                 .addClass( 'preview-' + newDevice );
                 } );
 
-                // Bind site title display to the corresponding field.
-                if ( title.length ) {
+                // Bind site title display to the corresponding field, if the filter 'customize_root_panel_title' hasn't changed it.
+                if ( title.length && ( ! title.hasClass( 'title-is-filtered' ) ) ) {
                         api( 'blogname', function( setting ) {
                                 var updateTitle = function() {
                                         title.text( $.trim( setting() ) || api.l10n.untitledBlogName );