Changeset 30306

Timestamp:

11/11/2014 10:28:38 PM (10 years ago)

Author:

ocean90

Message:

Customizer: When navigating around the site within the Customizer preview, update the document title.

props westonruter.
fixes #28542.

Location:

trunk/src

Files:

• wp-admin/customize.php (modified) (2 diffs)
• wp-admin/js/customize-controls.js (modified) (2 diffs)
• wp-includes/js/customize-loader.js (modified) (6 diffs)
• wp-includes/js/customize-preview.js (modified) (1 diff)

trunk/src/wp-admin/customize.php

@@ -77 +77 @@
 $is_ios = wp_is_mobile() && preg_match( '/iPad|iPod|iPhone/', $_SERVER['HTTP_USER_AGENT'] );
 
-if ( $is_ios )
+if ( $is_ios ) {
     $body_class .= ' ios';
-
-if ( is_rtl() )
-    $body_class .=  ' rtl';
+}
+
+if ( is_rtl() ) {
+    $body_class .= ' rtl';
+}
 $body_class .= ' locale-' . sanitize_html_class( strtolower( str_replace( '_', '-', get_locale() ) ) );
 
-$admin_title = sprintf( __( '%1$s — WordPress' ), strip_tags( sprintf( __( 'Customize %s' ), $wp_customize->theme()->display('Name') ) ) );
+if ( $wp_customize->is_theme_active() ) {
+    $document_title_tmpl = _x( 'Customize: %s', 'Placeholder is the document title from the preview' );
+} else {
+    $document_title_tmpl = _x( 'Live Preview: %s', 'Placeholder is the document title from the preview' );
+}
+$document_title_tmpl = html_entity_decode( $document_title_tmpl, ENT_QUOTES, 'UTF-8' ); // because exported to JS and assigned to document.title
+$admin_title = sprintf( $document_title_tmpl, __( 'Loading…' ) );
+
 ?><title><?php echo $admin_title; ?></title>
 
@@ -254 +263 @@
         ),
         'autofocus' => array(),
+        'documentTitleTmpl' => $document_title_tmpl,
     );
 

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

@@ -1501 +1501 @@
 
     /**
+     * Set the document title of the customizer
+     *
+     * @param {string} documentTitle
+     */
+    api.setDocumentTitle = function ( documentTitle ) {
+        var tmpl, title;
+        tmpl = api.settings.documentTitleTmpl;
+        title = tmpl.replace( '%s', documentTitle );
+        document.title = title;
+        if ( window !== window.parent ) {
+            window.parent.document.title = document.title;
+        }
+    };
+
+    /**
      * @constructor
      * @augments wp.customize.Messenger
@@ -1618 +1633 @@
             // Update the URL when the iframe sends a URL message.
             this.bind( 'url', this.previewUrl );
+
+            // Update the document title when the preview changes
+            this.bind( 'documentTitle', function ( title ) {
+                api.setDocumentTitle( title );
+            } );
         },
 

trunk/src/wp-includes/js/customize-loader.js

@@ -79 +79 @@
             }
 
-            if ( ! hash && ! $.support.history ){
+            if ( ! hash && ! $.support.history ) {
                 Loader.close();
             }
@@ -105 +105 @@
                 return window.location = src;
             }
+
+            // Store the document title prior to opening the Live Preview
+            this.originalDocumentTitle = document.title;
 
             this.active = true;
@@ -135 +138 @@
                     Loader.close();
                 }
-            } );
+            });
 
             // Prompt AYS dialog when navigating away
@@ -159 +162 @@
 
         pushState: function ( src ) {
-            var hash;
+            var hash = src.split( '?' )[1];
 
             // Ensure we don't call pushState if the user hit the forward button.
@@ -165 +168 @@
                 history.pushState( { customize: src }, '', src );
             } else if ( ! $.support.history && $.support.hashchange && hash ) {
-                hash = src.split( '?' )[1];
                 window.location.hash = 'wp_customize=on&' + hash;
             }
+
+            this.trigger( 'open' );
         },
 
@@ -195 +199 @@
 
             this.trigger( 'close' );
+
+            // Restore document title prior to opening the Live Preview
+            if ( this.originalDocumentTitle ) {
+                document.title = this.originalDocumentTitle;
+            }
 
             // Return focus to link that was originally clicked.

trunk/src/wp-includes/js/customize-preview.js

@@ -102 +102 @@
         });
 
-        preview.bind( 'active', function() {
-            if ( api.settings.nonce )
-                preview.send( 'nonce', api.settings.nonce );
-        });
+        preview.bind( 'active', function() {
+            if ( api.settings.nonce ) {
+                preview.send( 'nonce', api.settings.nonce );
+            }
+
+            preview.send( 'documentTitle', document.title );
+        });
 
         preview.send( 'ready', {