<?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

	}

}