wpseek.com
A WordPress-centric search engine for devs and theme authors
render_block_core_post_featured_image › WordPress Function
Since5.8.0
Deprecatedn/a
› render_block_core_post_featured_image ( $attributes, $content, $block )
| Parameters: (3) |
|
| Returns: |
|
| Defined at: | |
| Codex: |
Renders the `core/post-featured-image` block on the server.
Source
function render_block_core_post_featured_image( $attributes, $content, $block ) {
if ( ! isset( $block->context['postId'] ) ) {
return '';
}
$post_ID = $block->context['postId'];
$is_link = isset( $attributes['isLink'] ) && $attributes['isLink'];
$size_slug = $attributes['sizeSlug'] ?? 'post-thumbnail';
$attr = get_block_core_post_featured_image_border_attributes( $attributes );
$overlay_markup = get_block_core_post_featured_image_overlay_element_markup( $attributes );
if ( $is_link ) {
$title = get_the_title( $post_ID );
if ( $title ) {
$attr['alt'] = trim( strip_tags( $title ) );
} else {
$attr['alt'] = sprintf(
// translators: %d is the post ID.
__( 'Untitled post %d' ),
$post_ID
);
}
}
$extra_styles = '';
$has_width = array_key_exists( 'width', $attributes ) && null !== $attributes['width'] && '' !== $attributes['width'];
$has_height = array_key_exists( 'height', $attributes ) && null !== $attributes['height'] && '' !== $attributes['height'];
if ( ! empty( $attributes['aspectRatio'] ) ) {
$extra_styles .= esc_attr( safecss_filter_attr( 'aspect-ratio:' . $attributes['aspectRatio'] ) ) . ';';
$extra_styles .= 'width:100%;';
}
if ( $has_height ) {
$extra_styles .= esc_attr( safecss_filter_attr( 'height:' . $attributes['height'] ) ) . ';';
} elseif ( $has_width ) {
$extra_styles .= 'height:auto;';
}
if ( $has_width ) {
$extra_styles .= esc_attr( safecss_filter_attr( 'width:' . $attributes['width'] ) ) . ';';
}
if ( ! empty( $attributes['scale'] ) ) {
$extra_styles .= esc_attr( safecss_filter_attr( 'object-fit:' . $attributes['scale'] ) ) . ';';
}
if ( ! empty( $attributes['style']['shadow'] ) ) {
$shadow_styles = wp_style_engine_get_styles( array( 'shadow' => $attributes['style']['shadow'] ) );
if ( ! empty( $shadow_styles['css'] ) ) {
$extra_styles .= $shadow_styles['css'];
}
}
if ( ! empty( $extra_styles ) ) {
$attr['style'] = empty( $attr['style'] ) ? $extra_styles : $attr['style'] . $extra_styles;
}
$featured_image = get_the_post_thumbnail( $post_ID, $size_slug, $attr );
// Get the first image from the post.
if ( $attributes['useFirstImageFromPost'] && ! $featured_image ) {
$content_post = get_post( $post_ID );
$content = $content_post->post_content;
$processor = new WP_HTML_Tag_Processor( $content );
/*
* Transfer the image tag from the post into a new text snippet.
* Because the HTML API doesn't currently expose a way to extract
* HTML substrings this is necessary as a workaround. Of note, this
* is different than directly extracting the IMG tag:
* - If there are duplicate attributes in the source there will only be one in the output.
* - If there are single-quoted or unquoted attributes they will be double-quoted in the output.
* - If there are named character references in the attribute values they may be replaced with their direct code points. E.g. `…` becomes `…`.
* In the future there will likely be a mechanism to copy snippets of HTML from
* one document into another, via the HTML Processor's `get_outer_html()` or
* equivalent. When that happens it would be appropriate to replace this custom
* code with that canonical code.
*/
if ( $processor->next_tag( 'img' ) ) {
$tag_html = new WP_HTML_Tag_Processor( '<img>' );
$tag_html->next_tag();
foreach ( $processor->get_attribute_names_with_prefix( '' ) as $name ) {
$tag_html->set_attribute( $name, $processor->get_attribute( $name ) );
}
if ( ! empty( $attr['style'] ) ) {
$existing_style = $tag_html->get_attribute( 'style' );
$style = is_string( $existing_style ) && '' !== $existing_style
? rtrim( $existing_style, ';' ) . ';' . $attr['style']
: $attr['style'];
$tag_html->set_attribute( 'style', $style );
}
$featured_image = $tag_html->get_updated_html();
}
}
if ( ! $featured_image ) {
return '';
}
if ( $is_link ) {
$link_target = $attributes['linkTarget'];
$rel = ! empty( $attributes['rel'] ) ? 'rel="' . esc_attr( $attributes['rel'] ) . '"' : '';
$featured_image = sprintf(
'<a href="%1$s" target="%2$s" %3$s>%4$s%5$s</a>',
esc_url( get_the_permalink( $post_ID ) ),
esc_attr( $link_target ),
$rel,
$featured_image,
$overlay_markup
);
} else {
$featured_image = $featured_image . $overlay_markup;
}
$wrapper_attributes = get_block_wrapper_attributes();
return "<figure {$wrapper_attributes}>{$featured_image}</figure>";
}