first commit

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

@@ -0,0 +1,93 @@
+<?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 WP_Customize_Manager $manager
+	 * @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" tabindex="0" 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
+	}
+}