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

Timestamp:

03/21/2012 10:55:43 PM (14 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; ?>