X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/53f4633144ed68c8b8fb5861f992b5489894a940..refs/tags/wordpress-4.4:/wp-includes/class-wp-customize-control.php diff --git a/wp-includes/class-wp-customize-control.php b/wp-includes/class-wp-customize-control.php index 1e621462..3027a7b5 100644 --- a/wp-includes/class-wp-customize-control.php +++ b/wp-includes/class-wp-customize-control.php @@ -344,7 +344,7 @@ class WP_Customize_Control { * @since 3.4.0 */ protected function render() { - $id = 'customize-control-' . str_replace( '[', '-', str_replace( ']', '', $this->id ) ); + $id = 'customize-control-' . str_replace( array( '[', ']' ), array( '-', '' ), $this->id ); $class = 'customize-control customize-control-' . $this->type; ?>
  • @@ -386,7 +386,7 @@ class WP_Customize_Control { * @access public */ public function input_attrs() { - foreach( $this->input_attrs as $attr => $value ) { + foreach ( $this->input_attrs as $attr => $value ) { echo $attr . '="' . esc_attr( $value ) . '" '; } } @@ -474,7 +474,16 @@ class WP_Customize_Control { + + @@ -542,1430 +549,53 @@ class WP_Customize_Control { } -/** - * Customize Color Control class. - * - * @since 3.4.0 - * - * @see WP_Customize_Control - */ -class WP_Customize_Color_Control extends WP_Customize_Control { - /** - * @access public - * @var string - */ - public $type = 'color'; - - /** - * @access public - * @var array - */ - public $statuses; - - /** - * Constructor. - * - * @since 3.4.0 - * @uses WP_Customize_Control::__construct() - * - * @param WP_Customize_Manager $manager Customizer bootstrap instance. - * @param string $id Control ID. - * @param array $args Optional. Arguments to override class property defaults. - */ - public function __construct( $manager, $id, $args = array() ) { - $this->statuses = array( '' => __('Default') ); - parent::__construct( $manager, $id, $args ); - } - - /** - * Enqueue scripts/styles for the color picker. - * - * @since 3.4.0 - */ - public function enqueue() { - wp_enqueue_script( 'wp-color-picker' ); - wp_enqueue_style( 'wp-color-picker' ); - } - - /** - * Refresh the parameters passed to the JavaScript via JSON. - * - * @since 3.4.0 - * @uses WP_Customize_Control::to_json() - */ - public function to_json() { - parent::to_json(); - $this->json['statuses'] = $this->statuses; - $this->json['defaultValue'] = $this->setting->default; - } - - /** - * Don't render the control content from PHP, as it's rendered via JS on load. - * - * @since 3.4.0 - */ - public function render_content() {} - - /** - * Render a JS template for the content of the color picker control. - * - * @since 4.1.0 - */ - public function content_template() { - ?> - <# var defaultValue = ''; - if ( data.defaultValue ) { - if ( '#' !== data.defaultValue.substring( 0, 1 ) ) { - defaultValue = '#' + data.defaultValue; - } else { - defaultValue = data.defaultValue; - } - defaultValue = ' data-default-color=' + defaultValue; // Quotes added automatically. - } #> - - button_labels = array( - 'select' => __( 'Select File' ), - 'change' => __( 'Change File' ), - 'default' => __( 'Default' ), - 'remove' => __( 'Remove' ), - 'placeholder' => __( 'No file selected' ), - 'frame_title' => __( 'Select File' ), - 'frame_button' => __( 'Choose File' ), - ); - } - - /** - * Enqueue control related scripts/styles. - * - * @since 3.4.0 - * @since 4.2.0 Moved from WP_Customize_Upload_Control. - */ - public function enqueue() { - wp_enqueue_media(); - } - - /** - * Refresh the parameters passed to the JavaScript via JSON. - * - * @since 3.4.0 - * @since 4.2.0 Moved from WP_Customize_Upload_Control. - * - * @see WP_Customize_Control::to_json() - */ - public function to_json() { - parent::to_json(); - $this->json['label'] = html_entity_decode( $this->label, ENT_QUOTES, get_bloginfo( 'charset' ) ); - $this->json['mime_type'] = $this->mime_type; - $this->json['button_labels'] = $this->button_labels; - $this->json['canUpload'] = current_user_can( 'upload_files' ); - - $value = $this->value(); - - if ( is_object( $this->setting ) ) { - if ( $this->setting->default ) { - // Fake an attachment model - needs all fields used by template. - // Note that the default value must be a URL, NOT an attachment ID. - $type = in_array( substr( $this->setting->default, -3 ), array( 'jpg', 'png', 'gif', 'bmp' ) ) ? 'image' : 'document'; - $default_attachment = array( - 'id' => 1, - 'url' => $this->setting->default, - 'type' => $type, - 'icon' => wp_mime_type_icon( $type ), - 'title' => basename( $this->setting->default ), - ); - - if ( 'image' === $type ) { - $default_attachment['sizes'] = array( - 'full' => array( 'url' => $this->setting->default ), - ); - } - - $this->json['defaultAttachment'] = $default_attachment; - } - - if ( $value && $this->setting->default && $value === $this->setting->default ) { - // Set the default as the attachment. - $this->json['attachment'] = $this->json['defaultAttachment']; - } elseif ( $value ) { - $this->json['attachment'] = wp_prepare_attachment_for_js( $value ); - } - } - } - - /** - * Don't render any content for this control from PHP. - * - * @since 3.4.0 - * @since 4.2.0 Moved from WP_Customize_Upload_Control. - * - * @see WP_Customize_Media_Control::content_template() - */ - public function render_content() {} - - /** - * Render a JS template for the content of the media control. - * - * @since 4.1.0 - * @since 4.2.0 Moved from WP_Customize_Upload_Control. - */ - public function content_template() { - ?> - - - <# if ( data.attachment && data.attachment.id ) { #> -
    -
    -
    -
    - <# if ( 'image' === data.attachment.type && data.attachment.sizes && data.attachment.sizes.medium ) { #> - - <# } else if ( 'image' === data.attachment.type && data.attachment.sizes && data.attachment.sizes.full ) { #> - - <# } else if ( 'audio' === data.attachment.type ) { #> - <# if ( data.attachment.image && data.attachment.image.src && data.attachment.image.src !== data.attachment.icon ) { #> - - <# } else { #> - - <# } #> -

    “{{ data.attachment.title }}”

    - <# if ( data.attachment.album || data.attachment.meta.album ) { #> -

    {{ data.attachment.album || data.attachment.meta.album }}

    - <# } #> - <# if ( data.attachment.artist || data.attachment.meta.artist ) { #> -

    {{ data.attachment.artist || data.attachment.meta.artist }}

    - <# } #> - - <# } else if ( 'video' === data.attachment.type ) { #> -
    - -
    - <# } else { #> - -

    {{ data.attachment.title }}

    - <# } #> -
    -
    -
    -
    -
    - <# if ( data.canUpload ) { #> - - -
    - <# } #> -
    - <# } else { #> -
    -
    -
    -
    - - button_labels['placeholder']; ?> - -
    -
    -
    -
    -
    - <# if ( data.defaultAttachment ) { #> - - <# } #> - <# if ( data.canUpload ) { #> - - <# } #> -
    -
    - <# } #> - value(); - if ( $value ) { - // Get the attachment model for the existing file. - $attachment_id = attachment_url_to_postid( $value ); - if ( $attachment_id ) { - $this->json['attachment'] = wp_prepare_attachment_for_js( $attachment_id ); - } - } - } -} - -/** - * Customize Image Control class. - * - * @since 3.4.0 - * - * @see WP_Customize_Upload_Control - */ -class WP_Customize_Image_Control extends WP_Customize_Upload_Control { - public $type = 'image'; - public $mime_type = 'image'; - - /** - * Constructor. - * - * @since 3.4.0 - * @uses WP_Customize_Upload_Control::__construct() - * - * @param WP_Customize_Manager $manager Customizer bootstrap instance. - * @param string $id Control ID. - * @param array $args Optional. Arguments to override class property defaults. - */ - public function __construct( $manager, $id, $args = array() ) { - parent::__construct( $manager, $id, $args ); - - $this->button_labels = array( - 'select' => __( 'Select Image' ), - 'change' => __( 'Change Image' ), - 'remove' => __( 'Remove' ), - 'default' => __( 'Default' ), - 'placeholder' => __( 'No image selected' ), - 'frame_title' => __( 'Select Image' ), - 'frame_button' => __( 'Choose Image' ), - ); - } - - /** - * @since 3.4.2 - * @deprecated 4.1.0 - */ - public function prepare_control() {} - - /** - * @since 3.4.0 - * @deprecated 4.1.0 - * - * @param string $id - * @param string $label - * @param mixed $callback - */ - public function add_tab( $id, $label, $callback ) {} - - /** - * @since 3.4.0 - * @deprecated 4.1.0 - * - * @param string $id - */ - public function remove_tab( $id ) {} +/** WP_Customize_Color_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-color-control.php' ); - /** - * @since 3.4.0 - * @deprecated 4.1.0 - * - * @param string $url - * @param string $thumbnail_url - */ - public function print_tab_image( $url, $thumbnail_url = null ) {} -} +/** WP_Customize_Media_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-media-control.php' ); -/** - * Customize Background Image Control class. - * - * @since 3.4.0 - * - * @see WP_Customize_Image_Control - */ -class WP_Customize_Background_Image_Control extends WP_Customize_Image_Control { - public $type = 'background'; +/** WP_Customize_Upload_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-upload-control.php' ); - /** - * Constructor. - * - * @since 3.4.0 - * @uses WP_Customize_Image_Control::__construct() - * - * @param WP_Customize_Manager $manager Customizer bootstrap instance. - */ - public function __construct( $manager ) { - parent::__construct( $manager, 'background_image', array( - 'label' => __( 'Background Image' ), - 'section' => 'background_image', - ) ); - } +/** WP_Customize_Image_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-image-control.php' ); - /** - * Enqueue control related scripts/styles. - * - * @since 4.1.0 - */ - public function enqueue() { - parent::enqueue(); - - wp_localize_script( 'customize-controls', '_wpCustomizeBackground', array( - 'nonces' => array( - 'add' => wp_create_nonce( 'background-add' ), - ), - ) ); - } -} +/** WP_Customize_Background_Image_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-background-image-control.php' ); -/** - * Customize Cropped Image Control class. - * - * @since 4.3.0 - * - * @see WP_Customize_Media_Control - */ -class WP_Customize_Cropped_Image_Control extends WP_Customize_Media_Control { +/** WP_Customize_Cropped_Image_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-cropped-image-control.php' ); - /** - * Control type. - * - * @since 4.3.0 - * @access public - * @var string - */ - public $type = 'cropped_image'; +/** WP_Customize_Site_Icon_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-site-icon-control.php' ); - /** - * Suggested width for cropped image. - * - * @since 4.3.0 - * @access public - * @var int - */ - public $width = 150; +/** WP_Customize_Header_Image_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-header-image-control.php' ); - /** - * Suggested height for cropped image. - * - * @since 4.3.0 - * @access public - * @var int - */ - public $height = 150; +/** WP_Customize_Theme_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-theme-control.php' ); - /** - * Whether the width is flexible. - * - * @since 4.3.0 - * @access public - * @var bool - */ - public $flex_width = false; +/** WP_Widget_Area_Customize_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-widget-area-customize-control.php' ); - /** - * Whether the height is flexible. - * - * @since 4.3.0 - * @access public - * @var bool - */ - public $flex_height = false; +/** WP_Widget_Form_Customize_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-widget-form-customize-control.php' ); - /** - * Enqueue control related scripts/styles. - * - * @since 4.3.0 - * @access public - */ - public function enqueue() { - wp_enqueue_script( 'customize-views' ); +/** WP_Customize_Nav_Menu_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-control.php' ); - parent::enqueue(); - } +/** WP_Customize_Nav_Menu_Item_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-item-control.php' ); - /** - * Refresh the parameters passed to the JavaScript via JSON. - * - * @since 4.3.0 - * @access public - * - * @see WP_Customize_Control::to_json() - */ - public function to_json() { - parent::to_json(); +/** WP_Customize_Nav_Menu_Location_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-location-control.php' ); - $this->json['width'] = absint( $this->width ); - $this->json['height'] = absint( $this->height ); - $this->json['flex_width'] = absint( $this->flex_width ); - $this->json['flex_height'] = absint( $this->flex_height ); - } +/** WP_Customize_Nav_Menu_Name_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-name-control.php' ); -} +/** WP_Customize_Nav_Menu_Auto_Add_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-auto-add-control.php' ); -/** - * Customize Site Icon control class. - * - * Used only for custom functionality in JavaScript. - * - * @since 4.3.0 - * - * @see WP_Customize_Cropped_Image_Control - */ -class WP_Customize_Site_Icon_Control extends WP_Customize_Cropped_Image_Control { - - /** - * Control type. - * - * @since 4.3.0 - * @access public - * @var string - */ - public $type = 'site_icon'; - - /** - * Constructor. - * - * @since 4.3.0 - * @access public - * - * @param WP_Customize_Manager $manager Customizer bootstrap instance. - * @param string $id Control ID. - * @param array $args Optional. Arguments to override class property defaults. - */ - public function __construct( $manager, $id, $args = array() ) { - parent::__construct( $manager, $id, $args ); - add_action( 'customize_controls_print_styles', 'wp_site_icon', 99 ); - } -} - -/** - * Customize Header Image Control class. - * - * @since 3.4.0 - * - * @see WP_Customize_Image_Control - */ -class WP_Customize_Header_Image_Control extends WP_Customize_Image_Control { - public $type = 'header'; - public $uploaded_headers; - public $default_headers; - - /** - * Constructor. - * - * @since 3.4.0 - * - * @param WP_Customize_Manager $manager Customizer bootstrap instance. - */ - public function __construct( $manager ) { - parent::__construct( $manager, 'header_image', array( - 'label' => __( 'Header Image' ), - 'settings' => array( - 'default' => 'header_image', - 'data' => 'header_image_data', - ), - 'section' => 'header_image', - 'removed' => 'remove-header', - 'get_url' => 'get_header_image', - ) ); - - } - - /** - * @access public - */ - public function enqueue() { - wp_enqueue_media(); - wp_enqueue_script( 'customize-views' ); - - $this->prepare_control(); - - wp_localize_script( 'customize-views', '_wpCustomizeHeader', array( - 'data' => array( - 'width' => absint( get_theme_support( 'custom-header', 'width' ) ), - 'height' => absint( get_theme_support( 'custom-header', 'height' ) ), - 'flex-width' => absint( get_theme_support( 'custom-header', 'flex-width' ) ), - 'flex-height' => absint( get_theme_support( 'custom-header', 'flex-height' ) ), - 'currentImgSrc' => $this->get_current_image_src(), - ), - 'nonces' => array( - 'add' => wp_create_nonce( 'header-add' ), - 'remove' => wp_create_nonce( 'header-remove' ), - ), - 'uploads' => $this->uploaded_headers, - 'defaults' => $this->default_headers - ) ); - - parent::enqueue(); - } - - /** - * - * @global Custom_Image_Header $custom_image_header - */ - public function prepare_control() { - global $custom_image_header; - if ( empty( $custom_image_header ) ) { - return; - } - - // Process default headers and uploaded headers. - $custom_image_header->process_default_headers(); - $this->default_headers = $custom_image_header->get_default_header_images(); - $this->uploaded_headers = $custom_image_header->get_uploaded_header_images(); - } - - /** - * @access public - */ - public function print_header_image_template() { - ?> - - - - value(); - if ( isset( $this->get_url ) ) { - $src = call_user_func( $this->get_url, $src ); - return $src; - } - } - - /** - * @access public - */ - public function render_content() { - $this->print_header_image_template(); - $visibility = $this->get_current_image_src() ? '' : ' style="display:none" '; - $width = absint( get_theme_support( 'custom-header', 'width' ) ); - $height = absint( get_theme_support( 'custom-header', 'height' ) ); - ?> -
    -

    - Add new image, your theme recommends a header size of %s × %s pixels.' ), $width, $height ); - } elseif ( $width ) { - printf( __( 'While you can crop images to your liking after clicking Add new image, your theme recommends a header width of %s pixels.' ), $width ); - } else { - printf( __( 'While you can crop images to your liking after clicking Add new image, your theme recommends a header height of %s pixels.' ), $height ); - } - ?> -

    -
    - - - -
    -
    -
    -
    - - - -
    - -
    -
    - - - -
    -
    -
    -
    - - - -
    -
    -
    -
    -
    -
    - json['theme'] = $this->theme; - } - - /** - * Don't render the control content from PHP, as it's rendered via JS on load. - * - * @since 4.2.0 - * @access public - */ - public function render_content() {} - - /** - * Render a JS template for theme display. - * - * @since 4.2.0 - * @access public - */ - public function content_template() { - $current_url = set_url_scheme( 'http://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] ); - $active_url = esc_url( remove_query_arg( 'theme', $current_url ) ); - $preview_url = esc_url( add_query_arg( 'theme', '__THEME__', $current_url ) ); // Token because esc_url() strips curly braces. - $preview_url = str_replace( '__THEME__', '{{ data.theme.id }}', $preview_url ); - ?> - <# if ( data.theme.isActiveTheme ) { #> -
    - <# } else { #> -
    - <# } #> - - <# if ( data.theme.screenshot[0] ) { #> -
    - -
    - <# } else { #> -
    - <# } #> - - <# if ( data.theme.isActiveTheme ) { #> - - <# } else { #> - - <# } #> - -
    - - <# if ( data.theme.isActiveTheme ) { #> -

    - Active: %s' ), '{{{ data.theme.name }}}' ); - ?> -

    - <# } else { #> -

    {{{ data.theme.name }}}

    -
    - -
    - <# } #> -
    - json[ $key ] = $this->$key; - } - } - - /** - * @access public - */ - public function render_content() { - ?> - - - - - - - - - json[ $key ] = $this->$key; - } - } - - /** - * - * @global array $wp_registered_widgets - */ - public function render_content() { - global $wp_registered_widgets; - require_once ABSPATH . '/wp-admin/includes/widgets.php'; - - $widget = $wp_registered_widgets[ $this->widget_id ]; - if ( ! isset( $widget['params'][0] ) ) { - $widget['params'][0] = array(); - } - - $args = array( - 'widget_id' => $widget['id'], - 'widget_name' => $widget['name'], - ); - - $args = wp_list_widget_controls_dynamic_sidebar( array( 0 => $args, 1 => $widget['params'][0] ) ); - echo $this->manager->widgets->get_widget_control( $args ); - } - - /** - * Whether the current widget is rendered on the page. - * - * @since 4.0.0 - * @access public - * - * @return bool Whether the widget is rendered. - */ - public function active_callback() { - return $this->manager->widgets->is_widget_rendered( $this->widget_id ); - } -} - -/** - * Customize Nav Menu Control Class. - * - * @since 4.3.0 - */ -class WP_Customize_Nav_Menu_Control extends WP_Customize_Control { - - /** - * Control type. - * - * @since 4.3.0 - * @access public - * @var string - */ - public $type = 'nav_menu'; - - /** - * The nav menu setting. - * - * @since 4.3.0 - * @access public - * @var WP_Customize_Nav_Menu_Setting - */ - public $setting; - - /** - * Don't render the control's content - it uses a JS template instead. - * - * @since 4.3.0 - * @access public - */ - public function render_content() {} - - /** - * JS/Underscore template for the control UI. - * - * @since 4.3.0 - * @access public - */ - public function content_template() { - ?> - - -

    - - - - - - - setting->term_id; - - return $exported; - } -} - -/** - * Customize control to represent the name field for a given menu. - * - * @since 4.3.0 - */ -class WP_Customize_Nav_Menu_Item_Control extends WP_Customize_Control { - - /** - * Control type. - * - * @since 4.3.0 - * @access public - * @var string - */ - public $type = 'nav_menu_item'; - - /** - * The nav menu item setting. - * - * @since 4.3.0 - * @access public - * @var WP_Customize_Nav_Menu_Item_Setting - */ - public $setting; - - /** - * Constructor. - * - * @since 4.3.0 - * @access public - * - * @see WP_Customize_Control::__construct() - * - * @param WP_Customize_Manager $manager Customizer bootstrap instance. - * @param string $id The control ID. - * @param array $args Optional. Overrides class property defaults. - */ - public function __construct( $manager, $id, $args = array() ) { - parent::__construct( $manager, $id, $args ); - } - - /** - * Don't render the control's content - it's rendered with a JS template. - * - * @since 4.3.0 - * @access public - */ - public function render_content() {} - - /** - * JS/Underscore template for the control UI. - * - * @since 4.3.0 - * @access public - */ - public function content_template() { - ?> -
    -
    - - - - - - -
    -
    - - - - setting->post_id; - - return $exported; - } -} - -/** - * Customize Menu Location Control Class. - * - * This custom control is only needed for JS. - * - * @since 4.3.0 - * - * @see WP_Customize_Control - */ -class WP_Customize_Nav_Menu_Location_Control extends WP_Customize_Control { - - /** - * Control type. - * - * @since 4.3.0 - * @access public - * @var string - */ - public $type = 'nav_menu_location'; - - /** - * Location ID. - * - * @since 4.3.0 - * @access public - * @var string - */ - public $location_id = ''; - - /** - * Refresh the parameters passed to JavaScript via JSON. - * - * @since 4.3.0 - * @access public - * - * @see WP_Customize_Control::to_json() - */ - public function to_json() { - parent::to_json(); - $this->json['locationId'] = $this->location_id; - } - - /** - * Render content just like a normal select control. - * - * @since 4.3.0 - * @access public - */ - public function render_content() { - if ( empty( $this->choices ) ) { - return; - } - ?> - - - - - - - - - -