WordPress 3.4

[autoinstalls/wordpress.git] / wp-includes / class-wp-customize-section.php

diff --git a/wp-includes/class-wp-customize-section.php b/wp-includes/class-wp-customize-section.php
new file mode 100644 (file)
index 0000000..b1b7d5f
--- /dev/null
+++ b/wp-includes/class-wp-customize-section.php
@@ -0,0 +1,94 @@
+<?php
+/**
+ * Customize Section Class
+ *
+ * @package WordPress
+ * @subpackage Customize
+ * @since 3.4.0
+ */
+
+class WP_Customize_Section {
+       public $manager;
+       public $id;
+       public $priority       = 10;
+       public $capability     = 'edit_theme_options';
+       public $theme_supports = '';
+       public $title          = '';
+       public $description    = '';
+       public $controls;
+
+       /**
+        * Constructor.
+        *
+        * @since 3.4.0
+        *
+        * @param string $id An specific ID of the section.
+        * @param array $args Section arguments.
+        */
+       function __construct( $manager, $id, $args = array() ) {
+               $keys = array_keys( get_class_vars( __CLASS__ ) );
+               foreach ( $keys as $key ) {
+                       if ( isset( $args[ $key ] ) )
+                               $this->$key = $args[ $key ];
+               }
+
+               $this->manager = $manager;
+               $this->id = $id;
+
+               $this->controls = array(); // Users cannot customize the $controls array.
+
+               return $this;
+       }
+
+       /**
+        * Check if the theme supports the section and check user capabilities.
+        *
+        * @since 3.4.0
+        *
+        * @return bool False if theme doesn't support the section or user doesn't have the capability.
+        */
+       public final function check_capabilities() {
+               if ( $this->capability && ! call_user_func_array( 'current_user_can', (array) $this->capability ) )
+                       return false;
+
+               if ( $this->theme_supports && ! call_user_func_array( 'current_theme_supports', (array) $this->theme_supports ) )
+                       return false;
+
+               return true;
+       }
+
+       /**
+        * Check capabilities 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
+        */
+       protected function render() {
+               ?>
+               <li id="customize-section-<?php echo esc_attr( $this->id ); ?>" class="control-section customize-section">
+                       <h3 class="customize-section-title" title="<?php echo esc_attr( $this->description ); ?>"><?php echo esc_html( $this->title ); ?></h3>
+                       <ul class="customize-section-content">
+                               <?php
+                               foreach ( $this->controls as $control )
+                                       $control->maybe_render();
+                               ?>
+                       </ul>
+               </li>
+               <?php
+       }
+}