Changeset 36698 for trunk/src/wp-includes/class-wp-customize-manager.php

Timestamp:

02/24/2016 10:09:54 PM (9 years ago)

Author:

obenland

Message:

Customize: Introduce Logo support for themes.

Allows a common theme feature to have a common implementation provided by core and available in a consistent location for users.
See ​https://make.wordpress.org/core/2016/02/24/theme-logo-support/

Props kwight, enejb, jeherve, bhubbard, samhotchkiss, zinigor, eliorivero, adamsilverstein, melchoyce, ryan, mikeschroder, westonruter, pento, karmatosed, celloexpressions, obenland.
See #33755.

File:

• trunk/src/wp-includes/class-wp-customize-manager.php (modified) (6 diffs)

trunk/src/wp-includes/class-wp-customize-manager.php

@@ -218 +218 @@
         require_once( ABSPATH . WPINC . '/customize/class-wp-customize-cropped-image-control.php' );
         require_once( ABSPATH . WPINC . '/customize/class-wp-customize-site-icon-control.php' );
+        require_once( ABSPATH . WPINC . '/customize/class-wp-customize-site-logo-control.php' );
         require_once( ABSPATH . WPINC . '/customize/class-wp-customize-header-image-control.php' );
         require_once( ABSPATH . WPINC . '/customize/class-wp-customize-theme-control.php' );
@@ -829 +830 @@
             'activeControls' => array(),
             'nonce' => $this->get_nonces(),
+            'l10n' => array(
+                'shiftClickToEdit' => __( 'Shift-click to edit this element.' ),
+            ),
             '_dirty' => array_keys( $this->unsanitized_post_values() ),
         );
@@ -1858 +1862 @@
         $this->register_control_type( 'WP_Customize_Cropped_Image_Control' );
         $this->register_control_type( 'WP_Customize_Site_Icon_Control' );
+        $this->register_control_type( 'WP_Customize_Site_Logo_Control' );
         $this->register_control_type( 'WP_Customize_Theme_Control' );
 
@@ -1932 +1937 @@
             'section'    => 'title_tagline',
         ) );
+
+        // Add a setting to hide header text if the theme isn't supporting the feature itself.
+        // @todo
+        if ( ! current_theme_supports( 'custom-header' ) ) {
+            $this->add_setting( 'header_text', array(
+                'default'           => 1,
+                'sanitize_callback' => 'absint',
+                'transport'         => 'postMessage',
+            ) );
+
+            $this->add_control( 'header_text', array(
+                'label'    => __( 'Display Site Title and Tagline' ),
+                'section'  => 'title_tagline',
+                'settings' => 'header_text',
+                'type'     => 'checkbox',
+            ) );
+        }
 
         $this->add_setting( 'site_icon', array(
@@ -1952 +1974 @@
         ) ) );
 
+        $this->add_setting( 'site_logo', array(
+            'theme_supports' => array( 'site-logo' ),
+            'transport'      => 'postMessage',
+        ) );
+
+        $this->add_control( new WP_Customize_Site_Logo_Control( $this, 'site_logo', array(
+            'label'    => __( 'Logo' ),
+            'section'  => 'title_tagline',
+            'priority' => 0,
+        ) ) );
+
+        if ( isset( $this->selective_refresh ) ) {
+            $this->selective_refresh->add_partial( 'site_logo', array(
+                'settings'            => array( 'site_logo' ),
+                'selector'            => '.site-logo-link',
+                'render_callback'     => array( $this, '_render_site_logo_partial' ),
+                'container_inclusive' => true,
+            ) );
+        }
+
         /* Colors */
 
@@ -2180 +2222 @@
 
         return $color;
+    }
+
+    /**
+     * Callback for rendering the site logo, used in the site_logo partial.
+     *
+     * This method exists because the partial object and context data are passed
+     * into a partial's render_callback so we cannot use get_the_site_logo() as
+     * the render_callback directly since it expects a blog ID as the first
+     * argument. When WP no longer supports PHP 5.3, this method can be removed
+     * in favor of an anonymous function.
+     *
+     * @see WP_Customize_Manager::register_controls()
+     *
+     * @since 4.5.0
+     * @access private
+     *
+     * @return string Site logo.
+     */
+    public function _render_site_logo_partial() {
+        return get_the_site_logo();
     }
 }