--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/wp/wp-includes/class-wp-customize-manager.php Wed Nov 06 03:21:17 2013 +0000
@@ -0,0 +1,1059 @@
+<?php
+/**
+ * Customize Manager.
+ *
+ * @package WordPress
+ * @subpackage Customize
+ * @since 3.4.0
+ */
+final class WP_Customize_Manager {
+ protected $theme;
+ protected $original_stylesheet;
+
+ protected $previewing = false;
+
+ protected $settings = array();
+ protected $sections = array();
+ protected $controls = array();
+
+ protected $nonce_tick;
+
+ protected $customized;
+
+ private $_post_values;
+
+ /**
+ * Constructor.
+ *
+ * @since 3.4.0
+ */
+ public function __construct() {
+ require( ABSPATH . WPINC . '/class-wp-customize-setting.php' );
+ require( ABSPATH . WPINC . '/class-wp-customize-section.php' );
+ require( ABSPATH . WPINC . '/class-wp-customize-control.php' );
+
+ add_filter( 'wp_die_handler', array( $this, 'wp_die_handler' ) );
+
+ add_action( 'setup_theme', array( $this, 'setup_theme' ) );
+ add_action( 'wp_loaded', array( $this, 'wp_loaded' ) );
+
+ // Run wp_redirect_status late to make sure we override the status last.
+ add_action( 'wp_redirect_status', array( $this, 'wp_redirect_status' ), 1000 );
+
+ // Do not spawn cron (especially the alternate cron) while running the customizer.
+ remove_action( 'init', 'wp_cron' );
+
+ // Do not run update checks when rendering the controls.
+ remove_action( 'admin_init', '_maybe_update_core' );
+ remove_action( 'admin_init', '_maybe_update_plugins' );
+ remove_action( 'admin_init', '_maybe_update_themes' );
+
+ add_action( 'wp_ajax_customize_save', array( $this, 'save' ) );
+
+ add_action( 'customize_register', array( $this, 'register_controls' ) );
+ add_action( 'customize_controls_init', array( $this, 'prepare_controls' ) );
+ add_action( 'customize_controls_enqueue_scripts', array( $this, 'enqueue_control_scripts' ) );
+ }
+
+ /**
+ * Return true if it's an AJAX request.
+ *
+ * @since 3.4.0
+ *
+ * @return bool
+ */
+ public function doing_ajax() {
+ return isset( $_POST['customized'] ) || ( defined( 'DOING_AJAX' ) && DOING_AJAX );
+ }
+
+ /**
+ * Custom wp_die wrapper. Returns either the standard message for UI
+ * or the AJAX message.
+ *
+ * @since 3.4.0
+ *
+ * @param mixed $ajax_message AJAX return
+ * @param mixed $message UI message
+ */
+ protected function wp_die( $ajax_message, $message = null ) {
+ if ( $this->doing_ajax() )
+ wp_die( $ajax_message );
+
+ if ( ! $message )
+ $message = __( 'Cheatin’ uh?' );
+
+ wp_die( $message );
+ }
+
+ /**
+ * Return the AJAX wp_die() handler if it's a customized request.
+ *
+ * @since 3.4.0
+ *
+ * @return string
+ */
+ public function wp_die_handler() {
+ if ( $this->doing_ajax() )
+ return '_ajax_wp_die_handler';
+
+ return '_default_wp_die_handler';
+ }
+
+ /**
+ * Start preview and customize theme.
+ *
+ * Check if customize query variable exist. Init filters to filter the current theme.
+ *
+ * @since 3.4.0
+ */
+ public function setup_theme() {
+ send_origin_headers();
+
+ if ( is_admin() && ! $this->doing_ajax() )
+ auth_redirect();
+ elseif ( $this->doing_ajax() && ! is_user_logged_in() )
+ $this->wp_die( 0 );
+
+ show_admin_bar( false );
+
+ if ( ! current_user_can( 'edit_theme_options' ) )
+ $this->wp_die( -1 );
+
+ $this->original_stylesheet = get_stylesheet();
+
+ $this->theme = wp_get_theme( isset( $_REQUEST['theme'] ) ? $_REQUEST['theme'] : null );
+
+ if ( $this->is_theme_active() ) {
+ // Once the theme is loaded, we'll validate it.
+ add_action( 'after_setup_theme', array( $this, 'after_setup_theme' ) );
+ } else {
+ if ( ! current_user_can( 'switch_themes' ) )
+ $this->wp_die( -1 );
+
+ // If the theme isn't active, you can't preview it if it is not allowed or has errors.
+ if ( $this->theme()->errors() )
+ $this->wp_die( -1 );
+
+ if ( ! $this->theme()->is_allowed() )
+ $this->wp_die( -1 );
+ }
+
+ $this->start_previewing_theme();
+ }
+
+ /**
+ * Callback to validate a theme once it is loaded
+ *
+ * @since 3.4.0
+ */
+ function after_setup_theme() {
+ if ( ! $this->doing_ajax() && ! validate_current_theme() ) {
+ wp_redirect( 'themes.php?broken=true' );
+ exit;
+ }
+ }
+
+ /**
+ * Start previewing the selected theme.
+ *
+ * Adds filters to change the current theme.
+ *
+ * @since 3.4.0
+ */
+ public function start_previewing_theme() {
+ // Bail if we're already previewing.
+ if ( $this->is_preview() )
+ return;
+
+ $this->previewing = true;
+
+ if ( ! $this->is_theme_active() ) {
+ add_filter( 'template', array( $this, 'get_template' ) );
+ add_filter( 'stylesheet', array( $this, 'get_stylesheet' ) );
+ add_filter( 'pre_option_current_theme', array( $this, 'current_theme' ) );
+
+ // @link: http://core.trac.wordpress.org/ticket/20027
+ add_filter( 'pre_option_stylesheet', array( $this, 'get_stylesheet' ) );
+ add_filter( 'pre_option_template', array( $this, 'get_template' ) );
+
+ // Handle custom theme roots.
+ add_filter( 'pre_option_stylesheet_root', array( $this, 'get_stylesheet_root' ) );
+ add_filter( 'pre_option_template_root', array( $this, 'get_template_root' ) );
+ }
+
+ do_action( 'start_previewing_theme', $this );
+ }
+
+ /**
+ * Stop previewing the selected theme.
+ *
+ * Removes filters to change the current theme.
+ *
+ * @since 3.4.0
+ */
+ public function stop_previewing_theme() {
+ if ( ! $this->is_preview() )
+ return;
+
+ $this->previewing = false;
+
+ if ( ! $this->is_theme_active() ) {
+ remove_filter( 'template', array( $this, 'get_template' ) );
+ remove_filter( 'stylesheet', array( $this, 'get_stylesheet' ) );
+ remove_filter( 'pre_option_current_theme', array( $this, 'current_theme' ) );
+
+ // @link: http://core.trac.wordpress.org/ticket/20027
+ remove_filter( 'pre_option_stylesheet', array( $this, 'get_stylesheet' ) );
+ remove_filter( 'pre_option_template', array( $this, 'get_template' ) );
+
+ // Handle custom theme roots.
+ remove_filter( 'pre_option_stylesheet_root', array( $this, 'get_stylesheet_root' ) );
+ remove_filter( 'pre_option_template_root', array( $this, 'get_template_root' ) );
+ }
+
+ do_action( 'stop_previewing_theme', $this );
+ }
+
+ /**
+ * Get the theme being customized.
+ *
+ * @since 3.4.0
+ *
+ * @return WP_Theme
+ */
+ public function theme() {
+ return $this->theme;
+ }
+
+ /**
+ * Get the registered settings.
+ *
+ * @since 3.4.0
+ *
+ * @return array
+ */
+ public function settings() {
+ return $this->settings;
+ }
+
+ /**
+ * Get the registered controls.
+ *
+ * @since 3.4.0
+ *
+ * @return array
+ */
+ public function controls() {
+ return $this->controls;
+ }
+
+ /**
+ * Get the registered sections.
+ *
+ * @since 3.4.0
+ *
+ * @return array
+ */
+ public function sections() {
+ return $this->sections;
+ }
+
+ /**
+ * Checks if the current theme is active.
+ *
+ * @since 3.4.0
+ *
+ * @return bool
+ */
+ public function is_theme_active() {
+ return $this->get_stylesheet() == $this->original_stylesheet;
+ }
+
+ /**
+ * Register styles/scripts and initialize the preview of each setting
+ *
+ * @since 3.4.0
+ */
+ public function wp_loaded() {
+ do_action( 'customize_register', $this );
+
+ if ( $this->is_preview() && ! is_admin() )
+ $this->customize_preview_init();
+ }
+
+ /**
+ * Prevents AJAX requests from following redirects when previewing a theme
+ * by issuing a 200 response instead of a 30x.
+ *
+ * Instead, the JS will sniff out the location header.
+ *
+ * @since 3.4.0
+ *
+ * @param $status
+ * @return int
+ */
+ public function wp_redirect_status( $status ) {
+ if ( $this->is_preview() && ! is_admin() )
+ return 200;
+
+ return $status;
+ }
+
+ /**
+ * Decode the $_POST attribute used to override the WP_Customize_Setting values.
+ *
+ * @since 3.4.0
+ *
+ * @param mixed $setting A WP_Customize_Setting derived object
+ * @return string Sanitized attribute
+ */
+ public function post_value( $setting ) {
+ if ( ! isset( $this->_post_values ) ) {
+ if ( isset( $_POST['customized'] ) )
+ $this->_post_values = json_decode( wp_unslash( $_POST['customized'] ), true );
+ else
+ $this->_post_values = false;
+ }
+
+ if ( isset( $this->_post_values[ $setting->id ] ) )
+ return $setting->sanitize( $this->_post_values[ $setting->id ] );
+ }
+
+ /**
+ * Print javascript settings.
+ *
+ * @since 3.4.0
+ */
+ public function customize_preview_init() {
+ $this->nonce_tick = check_ajax_referer( 'preview-customize_' . $this->get_stylesheet(), 'nonce' );
+
+ $this->prepare_controls();
+
+ wp_enqueue_script( 'customize-preview' );
+ add_action( 'wp_head', array( $this, 'customize_preview_base' ) );
+ add_action( 'wp_head', array( $this, 'customize_preview_html5' ) );
+ add_action( 'wp_footer', array( $this, 'customize_preview_settings' ), 20 );
+ add_action( 'shutdown', array( $this, 'customize_preview_signature' ), 1000 );
+ add_filter( 'wp_die_handler', array( $this, 'remove_preview_signature' ) );
+
+ foreach ( $this->settings as $setting ) {
+ $setting->preview();
+ }
+
+ do_action( 'customize_preview_init', $this );
+ }
+
+ /**
+ * Print base element for preview frame.
+ *
+ * @since 3.4.0
+ */
+ public function customize_preview_base() {
+ ?><base href="<?php echo home_url( '/' ); ?>" /><?php
+ }
+
+ /**
+ * Print a workaround to handle HTML5 tags in IE < 9
+ *
+ * @since 3.4.0
+ */
+ public function customize_preview_html5() { ?>
+ <!--[if lt IE 9]>
+ <script type="text/javascript">
+ var e = [ 'abbr', 'article', 'aside', 'audio', 'canvas', 'datalist', 'details',
+ 'figure', 'footer', 'header', 'hgroup', 'mark', 'menu', 'meter', 'nav',
+ 'output', 'progress', 'section', 'time', 'video' ];
+ for ( var i = 0; i < e.length; i++ ) {
+ document.createElement( e[i] );
+ }
+ </script>
+ <![endif]--><?php
+ }
+
+ /**
+ * Print javascript settings for preview frame.
+ *
+ * @since 3.4.0
+ */
+ public function customize_preview_settings() {
+ $settings = array(
+ 'values' => array(),
+ 'channel' => esc_js( $_POST['customize_messenger_channel'] ),
+ );
+
+ if ( 2 == $this->nonce_tick ) {
+ $settings['nonce'] = array(
+ 'save' => wp_create_nonce( 'save-customize_' . $this->get_stylesheet() ),
+ 'preview' => wp_create_nonce( 'preview-customize_' . $this->get_stylesheet() )
+ );
+ }
+
+ foreach ( $this->settings as $id => $setting ) {
+ $settings['values'][ $id ] = $setting->js_value();
+ }
+
+ ?>
+ <script type="text/javascript">
+ var _wpCustomizeSettings = <?php echo json_encode( $settings ); ?>;
+ </script>
+ <?php
+ }
+
+ /**
+ * Prints a signature so we can ensure the customizer was properly executed.
+ *
+ * @since 3.4.0
+ */
+ public function customize_preview_signature() {
+ echo 'WP_CUSTOMIZER_SIGNATURE';
+ }
+
+ /**
+ * Removes the signature in case we experience a case where the customizer was not properly executed.
+ *
+ * @since 3.4.0
+ */
+ public function remove_preview_signature( $return = null ) {
+ remove_action( 'shutdown', array( $this, 'customize_preview_signature' ), 1000 );
+
+ return $return;
+ }
+
+ /**
+ * Is it a theme preview?
+ *
+ * @since 3.4.0
+ *
+ * @return bool True if it's a preview, false if not.
+ */
+ public function is_preview() {
+ return (bool) $this->previewing;
+ }
+
+ /**
+ * Retrieve the template name of the previewed theme.
+ *
+ * @since 3.4.0
+ *
+ * @return string Template name.
+ */
+ public function get_template() {
+ return $this->theme()->get_template();
+ }
+
+ /**
+ * Retrieve the stylesheet name of the previewed theme.
+ *
+ * @since 3.4.0
+ *
+ * @return string Stylesheet name.
+ */
+ public function get_stylesheet() {
+ return $this->theme()->get_stylesheet();
+ }
+
+ /**
+ * Retrieve the template root of the previewed theme.
+ *
+ * @since 3.4.0
+ *
+ * @return string Theme root.
+ */
+ public function get_template_root() {
+ return get_raw_theme_root( $this->get_template(), true );
+ }
+
+ /**
+ * Retrieve the stylesheet root of the previewed theme.
+ *
+ * @since 3.4.0
+ *
+ * @return string Theme root.
+ */
+ public function get_stylesheet_root() {
+ return get_raw_theme_root( $this->get_stylesheet(), true );
+ }
+
+ /**
+ * Filter the current theme and return the name of the previewed theme.
+ *
+ * @since 3.4.0
+ *
+ * @param $current_theme {@internal Parameter is not used}
+ * @return string Theme name.
+ */
+ public function current_theme( $current_theme ) {
+ return $this->theme()->display('Name');
+ }
+
+ /**
+ * Switch the theme and trigger the save action of each setting.
+ *
+ * @since 3.4.0
+ */
+ public function save() {
+ if ( ! $this->is_preview() )
+ die;
+
+ check_ajax_referer( 'save-customize_' . $this->get_stylesheet(), 'nonce' );
+
+ // Do we have to switch themes?
+ if ( ! $this->is_theme_active() ) {
+ // Temporarily stop previewing the theme to allow switch_themes()
+ // to operate properly.
+ $this->stop_previewing_theme();
+ switch_theme( $this->get_stylesheet() );
+ $this->start_previewing_theme();
+ }
+
+ do_action( 'customize_save', $this );
+
+ foreach ( $this->settings as $setting ) {
+ $setting->save();
+ }
+
+ do_action( 'customize_save_after', $this );
+
+ die;
+ }
+
+ /**
+ * Add a customize setting.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the setting. Can be a
+ * theme mod or option name.
+ * @param array $args Setting arguments.
+ */
+ public function add_setting( $id, $args = array() ) {
+ if ( is_a( $id, 'WP_Customize_Setting' ) )
+ $setting = $id;
+ else
+ $setting = new WP_Customize_Setting( $this, $id, $args );
+
+ $this->settings[ $setting->id ] = $setting;
+ }
+
+ /**
+ * Retrieve a customize setting.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the setting.
+ * @return object The settings object.
+ */
+ public function get_setting( $id ) {
+ if ( isset( $this->settings[ $id ] ) )
+ return $this->settings[ $id ];
+ }
+
+ /**
+ * Remove a customize setting.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the setting.
+ */
+ public function remove_setting( $id ) {
+ unset( $this->settings[ $id ] );
+ }
+
+ /**
+ * Add a customize section.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the section.
+ * @param array $args Section arguments.
+ */
+ public function add_section( $id, $args = array() ) {
+ if ( is_a( $id, 'WP_Customize_Section' ) )
+ $section = $id;
+ else
+ $section = new WP_Customize_Section( $this, $id, $args );
+
+ $this->sections[ $section->id ] = $section;
+ }
+
+ /**
+ * Retrieve a customize section.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the section.
+ * @return object The section object.
+ */
+ public function get_section( $id ) {
+ if ( isset( $this->sections[ $id ] ) )
+ return $this->sections[ $id ];
+ }
+
+ /**
+ * Remove a customize section.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the section.
+ */
+ public function remove_section( $id ) {
+ unset( $this->sections[ $id ] );
+ }
+
+ /**
+ * Add a customize control.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the control.
+ * @param array $args Setting arguments.
+ */
+ public function add_control( $id, $args = array() ) {
+ if ( is_a( $id, 'WP_Customize_Control' ) )
+ $control = $id;
+ else
+ $control = new WP_Customize_Control( $this, $id, $args );
+
+ $this->controls[ $control->id ] = $control;
+ }
+
+ /**
+ * Retrieve a customize control.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the control.
+ * @return object The settings object.
+ */
+ public function get_control( $id ) {
+ if ( isset( $this->controls[ $id ] ) )
+ return $this->controls[ $id ];
+ }
+
+ /**
+ * Remove a customize setting.
+ *
+ * @since 3.4.0
+ *
+ * @param string $id A specific ID of the control.
+ */
+ public function remove_control( $id ) {
+ unset( $this->controls[ $id ] );
+ }
+
+ /**
+ * Helper function to compare two objects by priority.
+ *
+ * @since 3.4.0
+ *
+ * @param object $a Object A.
+ * @param object $b Object B.
+ * @return int
+ */
+ protected final function _cmp_priority( $a, $b ) {
+ $ap = $a->priority;
+ $bp = $b->priority;
+
+ if ( $ap == $bp )
+ return 0;
+ return ( $ap > $bp ) ? 1 : -1;
+ }
+
+ /**
+ * Prepare settings and sections.
+ *
+ * @since 3.4.0
+ */
+ public function prepare_controls() {
+ // Prepare controls
+ // Reversing makes uasort sort by time added when conflicts occur.
+
+ $this->controls = array_reverse( $this->controls );
+ $controls = array();
+
+ foreach ( $this->controls as $id => $control ) {
+ if ( ! isset( $this->sections[ $control->section ] ) || ! $control->check_capabilities() )
+ continue;
+
+ $this->sections[ $control->section ]->controls[] = $control;
+ $controls[ $id ] = $control;
+ }
+ $this->controls = $controls;
+
+ // Prepare sections
+ $this->sections = array_reverse( $this->sections );
+ uasort( $this->sections, array( $this, '_cmp_priority' ) );
+ $sections = array();
+
+ foreach ( $this->sections as $section ) {
+ if ( ! $section->check_capabilities() || ! $section->controls )
+ continue;
+
+ usort( $section->controls, array( $this, '_cmp_priority' ) );
+ $sections[] = $section;
+ }
+ $this->sections = $sections;
+ }
+
+ /**
+ * Enqueue scripts for customize controls.
+ *
+ * @since 3.4.0
+ */
+ public function enqueue_control_scripts() {
+ foreach ( $this->controls as $control ) {
+ $control->enqueue();
+ }
+ }
+
+ /**
+ * Register some default controls.
+ *
+ * @since 3.4.0
+ */
+ public function register_controls() {
+
+ /* Site Title & Tagline */
+
+ $this->add_section( 'title_tagline', array(
+ 'title' => __( 'Site Title & Tagline' ),
+ 'priority' => 20,
+ ) );
+
+ $this->add_setting( 'blogname', array(
+ 'default' => get_option( 'blogname' ),
+ 'type' => 'option',
+ 'capability' => 'manage_options',
+ ) );
+
+ $this->add_control( 'blogname', array(
+ 'label' => __( 'Site Title' ),
+ 'section' => 'title_tagline',
+ ) );
+
+ $this->add_setting( 'blogdescription', array(
+ 'default' => get_option( 'blogdescription' ),
+ 'type' => 'option',
+ 'capability' => 'manage_options',
+ ) );
+
+ $this->add_control( 'blogdescription', array(
+ 'label' => __( 'Tagline' ),
+ 'section' => 'title_tagline',
+ ) );
+
+ /* Colors */
+
+ $this->add_section( 'colors', array(
+ 'title' => __( 'Colors' ),
+ 'priority' => 40,
+ ) );
+
+ $this->add_setting( 'header_textcolor', array(
+ 'theme_supports' => array( 'custom-header', 'header-text' ),
+ 'default' => get_theme_support( 'custom-header', 'default-text-color' ),
+
+ 'sanitize_callback' => array( $this, '_sanitize_header_textcolor' ),
+ 'sanitize_js_callback' => 'maybe_hash_hex_color',
+ ) );
+
+ // Input type: checkbox
+ // With custom value
+ $this->add_control( 'display_header_text', array(
+ 'settings' => 'header_textcolor',
+ 'label' => __( 'Display Header Text' ),
+ 'section' => 'title_tagline',
+ 'type' => 'checkbox',
+ ) );
+
+ $this->add_control( new WP_Customize_Color_Control( $this, 'header_textcolor', array(
+ 'label' => __( 'Header Text Color' ),
+ 'section' => 'colors',
+ ) ) );
+
+ // Input type: Color
+ // With sanitize_callback
+ $this->add_setting( 'background_color', array(
+ 'default' => get_theme_support( 'custom-background', 'default-color' ),
+ 'theme_supports' => 'custom-background',
+
+ 'sanitize_callback' => 'sanitize_hex_color_no_hash',
+ 'sanitize_js_callback' => 'maybe_hash_hex_color',
+ ) );
+
+ $this->add_control( new WP_Customize_Color_Control( $this, 'background_color', array(
+ 'label' => __( 'Background Color' ),
+ 'section' => 'colors',
+ ) ) );
+
+
+ /* Custom Header */
+
+ $this->add_section( 'header_image', array(
+ 'title' => __( 'Header Image' ),
+ 'theme_supports' => 'custom-header',
+ 'priority' => 60,
+ ) );
+
+ $this->add_setting( new WP_Customize_Filter_Setting( $this, 'header_image', array(
+ 'default' => get_theme_support( 'custom-header', 'default-image' ),
+ 'theme_supports' => 'custom-header',
+ ) ) );
+
+ $this->add_setting( new WP_Customize_Header_Image_Setting( $this, 'header_image_data', array(
+ // 'default' => get_theme_support( 'custom-header', 'default-image' ),
+ 'theme_supports' => 'custom-header',
+ ) ) );
+
+ $this->add_control( new WP_Customize_Header_Image_Control( $this ) );
+
+ /* Custom Background */
+
+ $this->add_section( 'background_image', array(
+ 'title' => __( 'Background Image' ),
+ 'theme_supports' => 'custom-background',
+ 'priority' => 80,
+ ) );
+
+ $this->add_setting( 'background_image', array(
+ 'default' => get_theme_support( 'custom-background', 'default-image' ),
+ 'theme_supports' => 'custom-background',
+ ) );
+
+ $this->add_setting( new WP_Customize_Background_Image_Setting( $this, 'background_image_thumb', array(
+ 'theme_supports' => 'custom-background',
+ ) ) );
+
+ $this->add_control( new WP_Customize_Background_Image_Control( $this ) );
+
+ $this->add_setting( 'background_repeat', array(
+ 'default' => 'repeat',
+ 'theme_supports' => 'custom-background',
+ ) );
+
+ $this->add_control( 'background_repeat', array(
+ 'label' => __( 'Background Repeat' ),
+ 'section' => 'background_image',
+ 'type' => 'radio',
+ 'choices' => array(
+ 'no-repeat' => __('No Repeat'),
+ 'repeat' => __('Tile'),
+ 'repeat-x' => __('Tile Horizontally'),
+ 'repeat-y' => __('Tile Vertically'),
+ ),
+ ) );
+
+ $this->add_setting( 'background_position_x', array(
+ 'default' => 'left',
+ 'theme_supports' => 'custom-background',
+ ) );
+
+ $this->add_control( 'background_position_x', array(
+ 'label' => __( 'Background Position' ),
+ 'section' => 'background_image',
+ 'type' => 'radio',
+ 'choices' => array(
+ 'left' => __('Left'),
+ 'center' => __('Center'),
+ 'right' => __('Right'),
+ ),
+ ) );
+
+ $this->add_setting( 'background_attachment', array(
+ 'default' => 'fixed',
+ 'theme_supports' => 'custom-background',
+ ) );
+
+ $this->add_control( 'background_attachment', array(
+ 'label' => __( 'Background Attachment' ),
+ 'section' => 'background_image',
+ 'type' => 'radio',
+ 'choices' => array(
+ 'fixed' => __('Fixed'),
+ 'scroll' => __('Scroll'),
+ ),
+ ) );
+
+ // If the theme is using the default background callback, we can update
+ // the background CSS using postMessage.
+ if ( get_theme_support( 'custom-background', 'wp-head-callback' ) === '_custom_background_cb' ) {
+ foreach ( array( 'color', 'image', 'position_x', 'repeat', 'attachment' ) as $prop ) {
+ $this->get_setting( 'background_' . $prop )->transport = 'postMessage';
+ }
+ }
+
+ /* Nav Menus */
+
+ $locations = get_registered_nav_menus();
+ $menus = wp_get_nav_menus();
+ $menu_locations = get_nav_menu_locations();
+ $num_locations = count( array_keys( $locations ) );
+
+ $this->add_section( 'nav', array(
+ 'title' => __( 'Navigation' ),
+ 'theme_supports' => 'menus',
+ 'priority' => 100,
+ 'description' => sprintf( _n('Your theme supports %s menu. Select which menu you would like to use.', 'Your theme supports %s menus. Select which menu appears in each location.', $num_locations ), number_format_i18n( $num_locations ) ) . "\n\n" . __('You can edit your menu content on the Menus screen in the Appearance section.'),
+ ) );
+
+ if ( $menus ) {
+ $choices = array( 0 => __( '— Select —' ) );
+ foreach ( $menus as $menu ) {
+ $choices[ $menu->term_id ] = wp_html_excerpt( $menu->name, 40, '…' );
+ }
+
+ foreach ( $locations as $location => $description ) {
+ $menu_setting_id = "nav_menu_locations[{$location}]";
+
+ $this->add_setting( $menu_setting_id, array(
+ 'sanitize_callback' => 'absint',
+ 'theme_supports' => 'menus',
+ ) );
+
+ $this->add_control( $menu_setting_id, array(
+ 'label' => $description,
+ 'section' => 'nav',
+ 'type' => 'select',
+ 'choices' => $choices,
+ ) );
+ }
+ }
+
+ /* Static Front Page */
+ // #WP19627
+
+ $this->add_section( 'static_front_page', array(
+ 'title' => __( 'Static Front Page' ),
+ // 'theme_supports' => 'static-front-page',
+ 'priority' => 120,
+ 'description' => __( 'Your theme supports a static front page.' ),
+ ) );
+
+ $this->add_setting( 'show_on_front', array(
+ 'default' => get_option( 'show_on_front' ),
+ 'capability' => 'manage_options',
+ 'type' => 'option',
+ // 'theme_supports' => 'static-front-page',
+ ) );
+
+ $this->add_control( 'show_on_front', array(
+ 'label' => __( 'Front page displays' ),
+ 'section' => 'static_front_page',
+ 'type' => 'radio',
+ 'choices' => array(
+ 'posts' => __( 'Your latest posts' ),
+ 'page' => __( 'A static page' ),
+ ),
+ ) );
+
+ $this->add_setting( 'page_on_front', array(
+ 'type' => 'option',
+ 'capability' => 'manage_options',
+ // 'theme_supports' => 'static-front-page',
+ ) );
+
+ $this->add_control( 'page_on_front', array(
+ 'label' => __( 'Front page' ),
+ 'section' => 'static_front_page',
+ 'type' => 'dropdown-pages',
+ ) );
+
+ $this->add_setting( 'page_for_posts', array(
+ 'type' => 'option',
+ 'capability' => 'manage_options',
+ // 'theme_supports' => 'static-front-page',
+ ) );
+
+ $this->add_control( 'page_for_posts', array(
+ 'label' => __( 'Posts page' ),
+ 'section' => 'static_front_page',
+ 'type' => 'dropdown-pages',
+ ) );
+ }
+
+ /**
+ * Callback for validating the header_textcolor value.
+ *
+ * Accepts 'blank', and otherwise uses sanitize_hex_color_no_hash().
+ * Returns default text color if hex color is empty.
+ *
+ * @since 3.4.0
+ *
+ * @param string $color
+ * @return string
+ */
+ public function _sanitize_header_textcolor( $color ) {
+ if ( 'blank' === $color )
+ return 'blank';
+
+ $color = sanitize_hex_color_no_hash( $color );
+ if ( empty( $color ) )
+ $color = get_theme_support( 'custom-header', 'default-text-color' );
+
+ return $color;
+ }
+};
+
+/**
+ * Validates a hex color.
+ *
+ * Returns either '', a 3 or 6 digit hex color (with #), or null.
+ * For validating values without a #, see sanitize_hex_color_no_hash().
+ *
+ * @since 3.4.0
+ *
+ * @param string $color
+ * @return string|null
+ */
+function sanitize_hex_color( $color ) {
+ if ( '' === $color )
+ return '';
+
+ // 3 or 6 hex digits, or the empty string.
+ if ( preg_match('|^#([A-Fa-f0-9]{3}){1,2}$|', $color ) )
+ return $color;
+
+ return null;
+}
+
+/**
+ * Sanitizes a hex color without a hash. Use sanitize_hex_color() when possible.
+ *
+ * Saving hex colors without a hash puts the burden of adding the hash on the
+ * UI, which makes it difficult to use or upgrade to other color types such as
+ * rgba, hsl, rgb, and html color names.
+ *
+ * Returns either '', a 3 or 6 digit hex color (without a #), or null.
+ *
+ * @since 3.4.0
+ * @uses sanitize_hex_color()
+ *
+ * @param string $color
+ * @return string|null
+ */
+function sanitize_hex_color_no_hash( $color ) {
+ $color = ltrim( $color, '#' );
+
+ if ( '' === $color )
+ return '';
+
+ return sanitize_hex_color( '#' . $color ) ? $color : null;
+}
+
+/**
+ * Ensures that any hex color is properly hashed.
+ * Otherwise, returns value untouched.
+ *
+ * This method should only be necessary if using sanitize_hex_color_no_hash().
+ *
+ * @since 3.4.0
+ *
+ * @param string $color
+ * @return string
+ */
+function maybe_hash_hex_color( $color ) {
+ if ( $unhashed = sanitize_hex_color_no_hash( $color ) )
+ return '#' . $unhashed;
+
+ return $color;
+}