X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/af50974463450c98503e763a7836a50e260461a9..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 3c8a8bd9..3027a7b5 100644 --- a/wp-includes/class-wp-customize-control.php +++ b/wp-includes/class-wp-customize-control.php @@ -1,11 +1,17 @@ active_callback, $this ); @@ -209,7 +217,7 @@ class WP_Customize_Control { * @since 4.0.0 * @access public * - * @return bool Always true. + * @return true Always true. */ public function active_callback() { return true; @@ -224,7 +232,7 @@ class WP_Customize_Control { * @param string $setting_key * @return mixed The requested setting's value, if the setting exists. */ - public final function value( $setting_key = 'default' ) { + final public function value( $setting_key = 'default' ) { if ( isset( $this->settings[ $setting_key ] ) ) { return $this->settings[ $setting_key ]->value(); } @@ -270,7 +278,7 @@ class WP_Customize_Control { * * @return bool False if theme doesn't support the control or user doesn't have the required permissions, otherwise true. */ - public final function check_capabilities() { + final public function check_capabilities() { foreach ( $this->settings as $setting ) { if ( ! $setting->check_capabilities() ) return false; @@ -290,12 +298,10 @@ class WP_Customize_Control { * * @return string Contents of the control. */ - public final function get_content() { + final public function get_content() { ob_start(); $this->maybe_render(); - $template = trim( ob_get_contents() ); - ob_end_clean(); - return $template; + return trim( ob_get_clean() ); } /** @@ -304,7 +310,7 @@ class WP_Customize_Control { * @since 3.4.0 * @uses WP_Customize_Control::render() */ - public final function maybe_render() { + final public function maybe_render() { if ( ! $this->check_capabilities() ) return; @@ -338,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; ?>
  • @@ -380,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 ) . '" '; } } @@ -468,7 +474,16 @@ class WP_Customize_Control { + + @@ -515,11 +528,11 @@ class WP_Customize_Control { * @since 4.1.0 */ final public function print_template() { - ?> - - + + 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 - */ - public function enqueue() { - wp_enqueue_media(); - } - - /** - * 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['mime_type'] = $this->mime_type; - $this->json['button_labels'] = $this->button_labels; - - $value = $this->value(); - - if ( is_object( $this->setting ) ) { - if ( $this->setting->default ) { - // Fake an attachment model - needs all fields used by template. - $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 ) { - // 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 ); - } - } - } - } - - /** - * Don't render any content for this control from PHP. - * - * @see WP_Customize_Upload_Control::content_template() - * @since 3.4.0 - */ - public function render_content() {} - - /** - * Render a JS template for the content of the upload control. - * - * @since 4.1.0 - */ - 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 ) { #> - -

    “{{ 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 { #> - -

    {{ data.attachment.title }}

    - <# } #> -
    -
    -
    -
    -
    - - -
    -
    - <# } else { #> -
    -
    -
    -
    - - button_labels['placeholder']; ?> - -
    -
    -
    -
    -
    - <# if ( data.defaultAttachment ) { #> - - <# } #> - -
    -
    - <# } #> - 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 ) {} - - /** - * @since 3.4.0 - * @deprecated 4.1.0 - * - * @param string $url - * @param string $thumbnail_url - */ - public function print_tab_image( $url, $thumbnail_url = null ) {} -} - -/** - * Customize Background Image Control Class - * - * @package WordPress - * @subpackage Customize - * @since 3.4.0 - */ -class WP_Customize_Background_Image_Control extends WP_Customize_Image_Control { - public $type = 'background'; - - /** - * Constructor. - * - * @since 3.4.0 - * @uses WP_Customize_Image_Control::__construct() - * - * @param WP_Customize_Manager $manager - */ - public function __construct( $manager ) { - parent::__construct( $manager, 'background_image', array( - 'label' => __( 'Background Image' ), - 'section' => 'background_image', - ) ); - } - - /** - * 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' ), - ), - ) ); - } -} - -class WP_Customize_Header_Image_Control extends WP_Customize_Image_Control { - public $type = 'header'; - public $uploaded_headers; - public $default_headers; - - /** - * @param WP_Customize_Manager $manager - */ - 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', - ) ); - - } - - public function to_json() { - parent::to_json(); - } - - 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(); - } - - public function prepare_control() { - global $custom_image_header; - if ( empty( $custom_image_header ) ) { - return; - } +/** WP_Customize_Color_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-color-control.php' ); - // 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(); - } +/** WP_Customize_Media_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-media-control.php' ); - function print_header_image_template() { - ?> - +/** WP_Customize_Upload_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-upload-control.php' ); - - value(); - if ( isset( $this->get_url ) ) { - $src = call_user_func( $this->get_url, $src ); - return $src; - } - return null; - } - - 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[ $key ] = $this->$key; - } - } +/** WP_Customize_Site_Icon_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-site-icon-control.php' ); - public function render_content() { - ?> - - - - - - - - - json[ $key ] = $this->$key; - } - } +/** WP_Widget_Form_Customize_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-widget-form-customize-control.php' ); - public function render_content() { - global $wp_registered_widgets; - require_once ABSPATH . '/wp-admin/includes/widgets.php'; +/** WP_Customize_Nav_Menu_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-control.php' ); - $widget = $wp_registered_widgets[ $this->widget_id ]; - if ( ! isset( $widget['params'][0] ) ) { - $widget['params'][0] = array(); - } +/** WP_Customize_Nav_Menu_Item_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-item-control.php' ); - $args = array( - 'widget_id' => $widget['id'], - 'widget_name' => $widget['name'], - ); +/** WP_Customize_Nav_Menu_Location_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-location-control.php' ); - $args = wp_list_widget_controls_dynamic_sidebar( array( 0 => $args, 1 => $widget['params'][0] ) ); - echo $this->manager->widgets->get_widget_control( $args ); - } +/** WP_Customize_Nav_Menu_Name_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-name-control.php' ); - /** - * Whether the current widget is rendered on the page. - * - * @since 4.0.0 - * @access public - * - * @return bool Whether the widget is rendered. - */ - function active_callback() { - return $this->manager->widgets->is_widget_rendered( $this->widget_id ); - } -} +/** WP_Customize_Nav_Menu_Auto_Add_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-nav-menu-auto-add-control.php' ); +/** WP_Customize_New_Menu_Control class */ +require_once( ABSPATH . WPINC . '/customize/class-wp-customize-new-menu-control.php' );