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

Timestamp:

10/19/2016 06:14:21 PM (8 years ago)

Author:

westonruter

Message:

Customize: Introduce custom CSS for extending theme styles.

• Custom CSS is associated with a given theme and is displayed in an inline style element at the wp_head hook after the wp_print_styles is called so that it overrides any enqueued stylesheets.
• A wp_get_custom_css() function is used for accessing the CSS associated with the current theme (or another theme) and a wp_get_custom_css filter for manipulating it.
• CSS is managed in customizer via a new "Additional CSS" section with a single textarea control.
• WP_Customize_Section::$description_hidden is introduced for hiding extended descriptions in customizer sections behind a help toggle as done with panels.
• CSS is stored in a custom_css post type with the theme (stylesheet) slug as the post_name.
• WP_Customize_Custom_CSS_Setting is introduced to handle validation of CSS, previewing, and persisting the CSS to the custom_css post type.
• The custom_css setting is tied to a new unfiltered_css capability which maps to unfiltered_html by default.
• Escaping the message in the notification template is removed to allow markup (code tags) to be rendered.

See ​https://make.wordpress.org/core/2016/10/11/feature-proposal-better-theme-customizations-via-custom-css-with-live-previews/

Props johnregan3, celloexpressions, folletto, westonruter.
Fixes #35395.

File:

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

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

@@ -301 +301 @@
         require_once( ABSPATH . WPINC . '/customize/class-wp-customize-new-menu-section.php' );
 
+        require_once( ABSPATH . WPINC . '/customize/class-wp-customize-custom-css-setting.php' );
         require_once( ABSPATH . WPINC . '/customize/class-wp-customize-filter-setting.php' );
         require_once( ABSPATH . WPINC . '/customize/class-wp-customize-header-image-setting.php' );
@@ -2494 +2495 @@
             <ul>
                 <# _.each( data.notifications, function( notification ) { #>
-                    <li class="notice notice-{{ notification.type || 'info' }} {{ data.altNotice ? 'notice-alt' : '' }}" data-code="{{ notification.code }}" data-type="{{ notification.type }}">{{ notification.message || notification.code }}</li>
+                    <li class="notice notice-{{ notification.type || 'info' }} {{ data.altNotice ? 'notice-alt' : '' }}" data-code="{{ notification.code }}" data-type="{{ notification.type }}">{{{ notification.message || notification.code }}}</li>
                 <# } ); #>
             </ul>
@@ -3221 +3222 @@
         ) ) );
 
-
         /* Custom Header */
 
@@ -3367 +3367 @@
             'type' => 'dropdown-pages',
         ) );
+
+        /* Custom CSS */
+        $this->add_section( 'custom_css', array(
+            'title'              => __( 'Additional CSS' ),
+            'priority'           => 140,
+            'description_hidden' => true,
+            'description'        => sprintf( '%s<br /><a href="%s" class="external-link" target="_blank">%s<span class="screen-reader-text">%s</span></a>',
+                __( 'CSS allows you to customize the appearance and layout of your site with code. Separate CSS is saved for each of your themes.' ),
+                'https://codex.wordpress.org/Know_Your_Sources#CSS',
+                __( 'Learn more about CSS' ),
+                __( '(link opens in a new window)' )
+            ),
+        ) );
+
+        $custom_css_setting = new WP_Customize_Custom_CSS_Setting( $this, sprintf( 'custom_css[%s]', get_stylesheet() ), array(
+            'capability' => 'unfiltered_css',
+        ) );
+        $this->add_setting( $custom_css_setting );
+
+        $this->add_control( 'custom_css', array(
+            'type'     => 'textarea',
+            'section'  => 'custom_css',
+            'settings' => array( 'default' => $custom_css_setting->id ),
+        ) );
     }
 
@@ -3389 +3413 @@
             }
         }
-
         return 0 !== count( get_pages() );
     }