render_block_core_latest_posts( array $attributes ): string

Parameters

$attributesarray

The block attributes.

Return

string

Returns the post content with latest posts added.

Hooks fired · 1

One hook fires while render_block_core_latest_posts() runs, in this order:

1. 1
   apply_filters( excerpt_length )filterline 167 (+122 into the body)

   Filters the maximum number of words in a post excerpt.

Uses · 24

• add_filter()Adds a callback function to a filter hook.
• update_post_thumbnail_cache()Updates cache for thumbnails in the current loop.
• esc_url()Checks and cleans a URL.
• get_permalink()Retrieves the full permalink for the current post or post ID.
• get_the_title()Retrieves the post title.
• __()Retrieves the translation of $text.
• has_post_thumbnail()Determines whether a post has an image attached.
• get_the_post_thumbnail()Retrieves the post thumbnail.
• esc_attr()Escaping for HTML attributes.
• get_the_author_meta()Retrieves the requested data of the author of the current post.
• get_the_date()Retrieves the date of the post.
• get_the_excerpt()Retrieves the post excerpt.

Source

View on Trac ↗View on GitHub ↗

45function render_block_core_latest_posts( $attributes ) {46	global $post, $block_core_latest_posts_excerpt_length;47	static $rendering_stack = array();48 49	$args = array(50		'posts_per_page'      => $attributes['postsToShow'],51		'post_status'         => 'publish',52		'order'               => $attributes['order'],53		'orderby'             => $attributes['orderBy'],54		'ignore_sticky_posts' => true,55		'no_found_rows'       => true,56	);57 58	$block_core_latest_posts_excerpt_length = $attributes['excerptLength'];59	add_filter( 'excerpt_length', 'block_core_latest_posts_get_excerpt_length', 20 );60 61	if ( ! empty( $attributes['categories'] ) ) {62		$args['category__in'] = array_column( $attributes['categories'], 'id' );63	}64	if ( isset( $attributes['selectedAuthor'] ) ) {65		$args['author'] = $attributes['selectedAuthor'];66	}67 68	$query = new WP_Query( $args );69 70	if ( isset( $attributes['displayFeaturedImage'] ) && $attributes['displayFeaturedImage'] ) {71		update_post_thumbnail_cache( $query );72	}73 74	$list_items_markup = '';75	// Snapshot the current global post so it can be restored after the loop.76	// We use have_posts()/the_post() rather than foreach so that setup_postdata()77	// is called for each post, establishing the correct global context for78	// do_blocks() and other filters that run during full-content rendering.79	$previous_post = $post ?? null;80 81	while ( $query->have_posts() ) {82		$query->the_post();83		$post_link = esc_url( get_permalink() );84		$title     = get_the_title();85 86		if ( ! $title ) {87			$title = __( '(no title)' );88		}89 90		$list_items_markup .= '<li>';91 92		if ( $attributes['displayFeaturedImage'] && has_post_thumbnail() ) {93			$image_style = '';94			if ( isset( $attributes['featuredImageSizeWidth'] ) ) {95				$image_style .= sprintf( 'max-width:%spx;', $attributes['featuredImageSizeWidth'] );96			}97			if ( isset( $attributes['featuredImageSizeHeight'] ) ) {98				$image_style .= sprintf( 'max-height:%spx;', $attributes['featuredImageSizeHeight'] );99			}100 101			$image_classes = 'wp-block-latest-posts__featured-image';102			if ( isset( $attributes['featuredImageAlign'] ) ) {103				$image_classes .= ' align' . $attributes['featuredImageAlign'];104			}105 106			$featured_image = get_the_post_thumbnail(107				null,108				$attributes['featuredImageSizeSlug'],109				array(110					'style' => esc_attr( $image_style ),111				)112			);113			if ( $attributes['addLinkToFeaturedImage'] ) {114				$featured_image = sprintf(115					'<a href="%1$s" aria-label="%2$s">%3$s</a>',116					esc_url( $post_link ),117					esc_attr( $title ),118					$featured_image119				);120			}121			$list_items_markup .= sprintf(122				'<div class="%1$s">%2$s</div>',123				esc_attr( $image_classes ),124				$featured_image

History

Introduced in 5.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/blocks/latest-posts.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.