Changeset 20248 for trunk/wp-includes/class-wp-customize-section.php

Timestamp:

03/21/2012 10:55:43 PM (13 years ago)

Author:

koopersmith

Message:

Theme Customizer: Numerous API refinements and bugfixes. Add a theme_supports check for header_textcolor. see #19910.

• prepare_controls() now removes any settings and sections that return false for check_capabilities().
• Added maybe_render() methods to both settings and sections that call the protected render() methods.
• Stop firing front-end preview functionality when rendering the controls.
• Merged the WP_Customize_Setting->_render_type() method into WP_Customize_Setting->render().
• Removed the 'customize_render_control-' hook; use 'customize_render_setting' instead.
• Added a property to sections and settings so they no longer rely on the global. Hooray for dependency injection.
• Shifted calls to WP_Customize_Setting->enqueue() to the 'customize_controls_enqueue_scripts' action.
• Added a theme_supports check for the header_textcolor setting.

File:

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

trunk/wp-includes/class-wp-customize-section.php

@@ -9 +9 @@
 
 class WP_Customize_Section {
+    public $manager;
     public $id;
     public $priority       = 10;
@@ -25 +26 @@
      * @param array $args Section arguments.
      */
-    function __construct( $id, $args = array() ) {
-        $this->id = $id;
-
+    function __construct( $manager, $id, $args = array() ) {
         $keys = array_keys( get_class_vars( __CLASS__ ) );
         foreach ( $keys as $key ) {
@@ -33 +32 @@
                 $this->$key = $args[ $key ];
         }
+
+        $this->manager = $manager;
+        $this->id = $id;
 
         $this->settings = array(); // Users cannot customize the $settings array.
@@ -46 +48 @@
      * @return bool False if theme doesn't support the section or user doesn't have the capability.
      */
-    function check_capabilities() {
+    public final function check_capabilities() {
         if ( $this->capability && ! call_user_func_array( 'current_user_can', (array) $this->capability ) )
             return false;
@@ -57 +59 @@
 
     /**
+     * Check capabiliites and render the section.
+     *
+     * @since 3.4.0
+     */
+    public final function maybe_render() {
+        if ( ! $this->check_capabilities() )
+            return;
+
+        do_action( 'customize_render_section', $this );
+        do_action( 'customize_render_section_' . $this->id );
+
+        $this->render();
+    }
+
+
+    /**
      * Render the section.
      *
      * @since 3.4.0
      */
-    function render() {
-        if ( ! $this->check_capabilities() )
-            return;
+    protected function render() {
         ?>
         <li id="customize-section-<?php echo esc_attr( $this->id ); ?>" class="control-section customize-section">
@@ -70 +86 @@
                 <?php foreach ( $this->settings as $setting ) : ?>
                 <li id="customize-control-<?php echo esc_attr( $setting->id ); ?>" class="customize-control customize-control-<?php echo esc_attr( $setting->control ); ?>">
-                    <?php $setting->_render(); ?>
+                    <?php $setting->maybe_render(); ?>
                 </li>
                 <?php endforeach; ?>