summaryrefslogtreecommitdiffstats
path: root/wp-includes/customize/class-wp-customize-header-image-control.php
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
commita415c29efee45520ae252d2aa28f1083a521cd7b (patch)
treef4ade4b6668ecc0765de7e1424f7c1427ad433ff /wp-includes/customize/class-wp-customize-header-image-control.php
parentInitial commit. (diff)
downloadwordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.tar.xz
wordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.zip
Adding upstream version 6.4.3+dfsg1.upstream/6.4.3+dfsg1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'wp-includes/customize/class-wp-customize-header-image-control.php')
-rw-r--r--wp-includes/customize/class-wp-customize-header-image-control.php271
1 files changed, 271 insertions, 0 deletions
diff --git a/wp-includes/customize/class-wp-customize-header-image-control.php b/wp-includes/customize/class-wp-customize-header-image-control.php
new file mode 100644
index 0000000..ecb134a
--- /dev/null
+++ b/wp-includes/customize/class-wp-customize-header-image-control.php
@@ -0,0 +1,271 @@
+<?php
+/**
+ * Customize API: WP_Customize_Header_Image_Control class
+ *
+ * @package WordPress
+ * @subpackage Customize
+ * @since 4.4.0
+ */
+
+/**
+ * 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 {
+
+ /**
+ * Customize control type.
+ *
+ * @since 4.2.0
+ * @var string
+ */
+ public $type = 'header';
+
+ /**
+ * Uploaded header images.
+ *
+ * @since 3.9.0
+ * @var string
+ */
+ public $uploaded_headers;
+
+ /**
+ * Default header images.
+ *
+ * @since 3.9.0
+ * @var string
+ */
+ 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',
+ )
+ );
+ }
+
+ /**
+ */
+ 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;
+ }
+
+ add_action( 'customize_controls_print_footer_scripts', array( $this, 'print_header_image_template' ) );
+
+ // 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();
+ }
+
+ /**
+ */
+ public function print_header_image_template() {
+ ?>
+ <script type="text/template" id="tmpl-header-choice">
+ <# if (data.random) { #>
+ <button type="button" class="button display-options random">
+ <span class="dashicons dashicons-randomize dice"></span>
+ <# if ( data.type === 'uploaded' ) { #>
+ <?php _e( 'Randomize uploaded headers' ); ?>
+ <# } else if ( data.type === 'default' ) { #>
+ <?php _e( 'Randomize suggested headers' ); ?>
+ <# } #>
+ </button>
+
+ <# } else { #>
+
+ <button type="button" class="choice thumbnail"
+ data-customize-image-value="{{data.header.url}}"
+ data-customize-header-image-data="{{JSON.stringify(data.header)}}">
+ <span class="screen-reader-text">
+ <?php
+ /* translators: Hidden accessibility text. */
+ _e( 'Set image' );
+ ?>
+ </span>
+ <img src="{{data.header.thumbnail_url}}" alt="{{data.header.alt_text || data.header.description}}" />
+ </button>
+
+ <# if ( data.type === 'uploaded' ) { #>
+ <button type="button" class="dashicons dashicons-no close">
+ <span class="screen-reader-text">
+ <?php
+ /* translators: Hidden accessibility text. */
+ _e( 'Remove image' );
+ ?>
+ </span>
+ </button>
+ <# } #>
+
+ <# } #>
+ </script>
+
+ <script type="text/template" id="tmpl-header-current">
+ <# if (data.choice) { #>
+ <# if (data.random) { #>
+
+ <div class="placeholder">
+ <span class="dashicons dashicons-randomize dice"></span>
+ <# if ( data.type === 'uploaded' ) { #>
+ <?php _e( 'Randomizing uploaded headers' ); ?>
+ <# } else if ( data.type === 'default' ) { #>
+ <?php _e( 'Randomizing suggested headers' ); ?>
+ <# } #>
+ </div>
+
+ <# } else { #>
+
+ <img src="{{data.header.thumbnail_url}}" alt="{{data.header.alt_text || data.header.description}}" />
+
+ <# } #>
+ <# } else { #>
+
+ <div class="placeholder">
+ <?php _e( 'No image set' ); ?>
+ </div>
+
+ <# } #>
+ </script>
+ <?php
+ }
+
+ /**
+ * @return string|void
+ */
+ public function get_current_image_src() {
+ $src = $this->value();
+ if ( isset( $this->get_url ) ) {
+ $src = call_user_func( $this->get_url, $src );
+ return $src;
+ }
+ }
+
+ /**
+ */
+ public function render_content() {
+ $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' ) );
+ ?>
+ <div class="customize-control-content">
+ <?php
+ if ( current_theme_supports( 'custom-header', 'video' ) ) {
+ echo '<span class="customize-control-title">' . $this->label . '</span>';
+ }
+ ?>
+ <div class="customize-control-notifications-container"></div>
+ <p class="customizer-section-intro customize-control-description">
+ <?php
+ if ( current_theme_supports( 'custom-header', 'video' ) ) {
+ _e( 'Click &#8220;Add New Image&#8221; to upload an image file from your computer. Your theme works best with an image that matches the size of your video &#8212; you&#8217;ll be able to crop your image once you upload it for a perfect fit.' );
+ } elseif ( $width && $height ) {
+ printf(
+ /* translators: %s: Header size in pixels. */
+ __( 'Click &#8220;Add New Image&#8221; to upload an image file from your computer. Your theme works best with an image with a header size of %s pixels &#8212; you&#8217;ll be able to crop your image once you upload it for a perfect fit.' ),
+ sprintf( '<strong>%s &times; %s</strong>', $width, $height )
+ );
+ } elseif ( $width ) {
+ printf(
+ /* translators: %s: Header width in pixels. */
+ __( 'Click &#8220;Add New Image&#8221; to upload an image file from your computer. Your theme works best with an image with a header width of %s pixels &#8212; you&#8217;ll be able to crop your image once you upload it for a perfect fit.' ),
+ sprintf( '<strong>%s</strong>', $width )
+ );
+ } else {
+ printf(
+ /* translators: %s: Header height in pixels. */
+ __( 'Click &#8220;Add New Image&#8221; to upload an image file from your computer. Your theme works best with an image with a header height of %s pixels &#8212; you&#8217;ll be able to crop your image once you upload it for a perfect fit.' ),
+ sprintf( '<strong>%s</strong>', $height )
+ );
+ }
+ ?>
+ </p>
+ <div class="current">
+ <label for="header_image-button">
+ <span class="customize-control-title">
+ <?php _e( 'Current header' ); ?>
+ </span>
+ </label>
+ <div class="container">
+ </div>
+ </div>
+ <div class="actions">
+ <?php if ( current_user_can( 'upload_files' ) ) : ?>
+ <button type="button"<?php echo $visibility; ?> class="button remove" aria-label="<?php esc_attr_e( 'Hide header image' ); ?>"><?php _e( 'Hide image' ); ?></button>
+ <button type="button" class="button new" id="header_image-button" aria-label="<?php esc_attr_e( 'Add New Header Image' ); ?>"><?php _e( 'Add New Image' ); ?></button>
+ <?php endif; ?>
+ </div>
+ <div class="choices">
+ <span class="customize-control-title header-previously-uploaded">
+ <?php _ex( 'Previously uploaded', 'custom headers' ); ?>
+ </span>
+ <div class="uploaded">
+ <div class="list">
+ </div>
+ </div>
+ <span class="customize-control-title header-default">
+ <?php _ex( 'Suggested', 'custom headers' ); ?>
+ </span>
+ <div class="default">
+ <div class="list">
+ </div>
+ </div>
+ </div>
+ </div>
+ <?php
+ }
+}