[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

title

Body

[close]

/wp-includes/blocks/ -> cover.php (source)

   1  <?php
   2  /**
   3   * Server-side rendering of the `core/cover` block.
   4   *
   5   * @package WordPress
   6   */
   7  
   8  /**
   9   * Renders the `core/cover` block on server.
  10   *
  11   * @since 6.0.0
  12   *
  13   * @param array  $attributes The block attributes.
  14   * @param string $content    The block rendered content.
  15   *
  16   * @return string Returns the cover block markup, if useFeaturedImage is true.
  17   */
  18  function render_block_core_cover( $attributes, $content ) {
  19      if ( 'image' !== $attributes['backgroundType'] || false === $attributes['useFeaturedImage'] ) {
  20          return $content;
  21      }
  22  
  23      $object_position = isset( $attributes['focalPoint'] )
  24          ? round( $attributes['focalPoint']['x'] * 100 ) . '% ' . round( $attributes['focalPoint']['y'] * 100 ) . '%'
  25          : null;
  26  
  27      if ( ! ( $attributes['hasParallax'] || $attributes['isRepeated'] ) ) {
  28          $attr = array(
  29              'class'           => 'wp-block-cover__image-background',
  30              'data-object-fit' => 'cover',
  31          );
  32  
  33          if ( $object_position ) {
  34              $attr['data-object-position'] = $object_position;
  35              $attr['style']                = 'object-position:' . $object_position . ';';
  36          }
  37  
  38          $image = get_the_post_thumbnail( null, 'post-thumbnail', $attr );
  39      } else {
  40          if ( in_the_loop() ) {
  41              update_post_thumbnail_cache();
  42          }
  43          $current_featured_image = get_the_post_thumbnail_url();
  44          if ( ! $current_featured_image ) {
  45              return $content;
  46          }
  47  
  48          $current_thumbnail_id = get_post_thumbnail_id();
  49  
  50          $processor = new WP_HTML_Tag_Processor( '<div></div>' );
  51          $processor->next_tag();
  52  
  53          $current_alt = trim( strip_tags( get_post_meta( $current_thumbnail_id, '_wp_attachment_image_alt', true ) ) );
  54          if ( $current_alt ) {
  55              $processor->set_attribute( 'role', 'img' );
  56              $processor->set_attribute( 'aria-label', $current_alt );
  57          }
  58  
  59          $processor->add_class( 'wp-block-cover__image-background' );
  60          $processor->add_class( 'wp-image-' . $current_thumbnail_id );
  61          if ( $attributes['hasParallax'] ) {
  62              $processor->add_class( 'has-parallax' );
  63          }
  64          if ( $attributes['isRepeated'] ) {
  65              $processor->add_class( 'is-repeated' );
  66          }
  67  
  68          $styles  = 'background-position:' . ( $object_position ?? '50% 50%' ) . ';';
  69          $styles .= 'background-image:url(' . esc_url( $current_featured_image ) . ');';
  70          $processor->set_attribute( 'style', $styles );
  71  
  72          $image = $processor->get_updated_html();
  73      }
  74  
  75      /*
  76       * Inserts the featured image between the (1st) cover 'background' `span` and 'inner_container' `div`,
  77       * and removes eventual whitespace characters between the two (typically introduced at template level)
  78       */
  79      $inner_container_start = '/<div\b[^>]+wp-block-cover__inner-container[\s|"][^>]*>/U';
  80      if ( 1 === preg_match( $inner_container_start, $content, $matches, PREG_OFFSET_CAPTURE ) ) {
  81          $offset  = $matches[0][1];
  82          $content = substr( $content, 0, $offset ) . $image . substr( $content, $offset );
  83      }
  84  
  85      return $content;
  86  }
  87  
  88  /**
  89   * Registers the `core/cover` block renderer on server.
  90   *
  91   * @since 6.0.0
  92   */
  93  function register_block_core_cover() {
  94      register_block_type_from_metadata(
  95          __DIR__ . '/cover',
  96          array(
  97              'render_callback' => 'render_block_core_cover',
  98          )
  99      );
 100  }
 101  add_action( 'init', 'register_block_core_cover' );


Generated : Sat Dec 21 08:20:01 2024 Cross-referenced by PHPXref