File Manager

📂 File Manager

📝 Edit File: post-template.php

<?php
/**
 * Server-side rendering of the `core/post-template` block.
 *
 * @package WordPress
 */

/**
 * Determines whether a block list contains a block that uses the featured image.
 *
 * @since 6.0.0
 *
 * @param WP_Block_List $inner_blocks Inner block instance.
 *
 * @return bool Whether the block list contains a block that uses the featured image.
 */
function block_core_post_template_uses_featured_image( $inner_blocks ) {
	foreach ( $inner_blocks as $block ) {
		if ( 'core/post-featured-image' === $block->name ) {
			return true;
		}
		if (
			'core/cover' === $block->name &&
			! empty( $block->attributes['useFeaturedImage'] )
		) {
			return true;
		}
		if ( $block->inner_blocks && block_core_post_template_uses_featured_image( $block->inner_blocks ) ) {
			return true;
		}
	}

return false;
}

/**
 * Renders the `core/post-template` block on the server.
 *
 * @since 6.3.0 Changed render_block_context priority to `1`.
 *
 * @global WP_Query $wp_query WordPress Query object.
 *
 * @param array    $attributes Block attributes.
 * @param string   $content    Block default content.
 * @param WP_Block $block      Block instance.
 *
 * @return string Returns the output of the query, structured using the layout defined by the block's inner blocks.
 */
function render_block_core_post_template( $attributes, $content, $block ) {
	$page_key            = isset( $block->context['queryId'] ) ? 'query-' . $block->context['queryId'] . '-page' : 'query-page';
	$enhanced_pagination = isset( $block->context['enhancedPagination'] ) && $block->context['enhancedPagination'];
	$page                = empty( $_GET[ $page_key ] ) ? 1 : (int) $_GET[ $page_key ];

// Use global query if needed.
	$use_global_query = ( isset( $block->context['query']['inherit'] ) && $block->context['query']['inherit'] );
	if ( $use_global_query ) {
		global $wp_query;

/*
		 * If already in the main query loop, duplicate the query instance to not tamper with the main instance.
		 * Since this is a nested query, it should start at the beginning, therefore rewind posts.
		 * Otherwise, the main query loop has not started yet and this block is responsible for doing so.
		 */
		if ( in_the_loop() ) {
			$query = clone $wp_query;
			$query->rewind_posts();
		} else {
			$query = $wp_query;
		}
	} else {
		$query_args = build_query_vars_from_query_block( $block, $page );
		$query      = new WP_Query( $query_args );
	}

if ( ! $query->have_posts() ) {
		return '';
	}

if ( block_core_post_template_uses_featured_image( $block->inner_blocks ) ) {
		update_post_thumbnail_cache( $query );
	}

$classnames = '';
	if ( isset( $block->context['displayLayout'] ) && isset( $block->context['query'] ) ) {
		if ( isset( $block->context['displayLayout']['type'] ) && 'flex' === $block->context['displayLayout']['type'] ) {
			$classnames = "is-flex-container columns-{$block->context['displayLayout']['columns']}";
		}
	}
	if ( isset( $attributes['style']['elements']['link']['color']['text'] ) ) {
		$classnames .= ' has-link-color';
	}

// Ensure backwards compatibility by flagging the number of columns via classname when using grid layout.
	if ( isset( $attributes['layout']['type'] ) && 'grid' === $attributes['layout']['type'] && ! empty( $attributes['layout']['columnCount'] ) ) {
		$classnames .= ' ' . sanitize_title( 'columns-' . $attributes['layout']['columnCount'] );
	}

$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => trim( $classnames ) ) );

$content = '';
	while ( $query->have_posts() ) {
		$query->the_post();

// Get an instance of the current Post Template block.
		$block_instance = $block->parsed_block;

// Set the block name to one that does not correspond to an existing registered block.
		// This ensures that for the inner instances of the Post Template block, we do not render any block supports.
		$block_instance['blockName'] = 'core/null';

$post_id              = get_the_ID();
		$post_type            = get_post_type();
		$filter_block_context = static function ( $context ) use ( $post_id, $post_type ) {
			$context['postType'] = $post_type;
			$context['postId']   = $post_id;
			return $context;
		};

// Use an early priority to so that other 'render_block_context' filters have access to the values.
		add_filter( 'render_block_context', $filter_block_context, 1 );
		// Render the inner blocks of the Post Template block with `dynamic` set to `false` to prevent calling
		// `render_callback` and ensure that no wrapper markup is included.
		$block_content = ( new WP_Block( $block_instance ) )->render( array( 'dynamic' => false ) );
		remove_filter( 'render_block_context', $filter_block_context, 1 );

// Wrap the render inner blocks in a `li` element with the appropriate post classes.
		$post_classes = implode( ' ', get_post_class( 'wp-block-post' ) );

$inner_block_directives = $enhanced_pagination ? ' data-wp-key="post-template-item-' . $post_id . '"' : '';

$content .= '<li' . $inner_block_directives . ' class="' . esc_attr( $post_classes ) . '">' . $block_content . '</li>';
	}

/*
	 * Use this function to restore the context of the template tags
	 * from a secondary query loop back to the main query loop.
	 * Since we use two custom loops, it's safest to always restore.
	*/
	wp_reset_postdata();

return sprintf(
		'<ul %1$s>%2$s</ul>',
		$wrapper_attributes,
		$content
	);
}

/**
 * Registers the `core/post-template` block on the server.
 *
 * @since 5.8.0
 */
function register_block_core_post_template() {
	register_block_type_from_metadata(
		__DIR__ . '/post-template',
		array(
			'render_callback'   => 'render_block_core_post_template',
			'skip_inner_blocks' => true,
		)
	);
}
add_action( 'init', 'register_block_core_post_template' );

Type	Item Name	Actions
📁	..
📁	archives
📁	audio
📁	avatar
📁	block
📁	button
📁	buttons
📁	calendar
📁	categories
📁	code
📁	column
📁	columns
📁	comment-author-name
📁	comment-content
📁	comment-date
📁	comment-edit-link
📁	comment-reply-link
📁	comment-template
📁	comments
📁	comments-pagination
📁	comments-pagination-next
📁	comments-pagination-numbers
📁	comments-pagination-previous
📁	comments-title
📁	cover
📁	details
📁	embed
📁	file
📁	footnotes
📁	freeform
📁	gallery
📁	group
📁	heading
📁	home-link
📁	html
📁	image
📁	latest-comments
📁	latest-posts
📁	legacy-widget
📁	list
📁	list-item
📁	loginout
📁	media-text
📁	missing
📁	more
📁	navigation
📁	navigation-link
📁	navigation-submenu
📁	nextpage
📁	page-list
📁	page-list-item
📁	paragraph
📁	pattern
📁	post-author
📁	post-author-biography
📁	post-author-name
📁	post-comments-form
📁	post-content
📁	post-date
📁	post-excerpt
📁	post-featured-image
📁	post-navigation-link
📁	post-template
📁	post-terms
📁	post-title
📁	preformatted
📁	pullquote
📁	query
📁	query-no-results
📁	query-pagination
📁	query-pagination-next
📁	query-pagination-numbers
📁	query-pagination-previous
📁	query-title
📁	quote
📁	read-more
📁	rss
📁	search
📁	separator
📁	shortcode
📁	site-logo
📁	site-tagline
📁	site-title
📁	social-link
📁	social-links
📁	spacer
📁	table
📁	tag-cloud
📁	template-part
📁	term-description
📁	text-columns
📁	verse
📁	video
📁	widget-group
📄	archives.php
📄	avatar.php
📄	block.php
📄	blocks-json.php
📄	button.php
📄	calendar.php
📄	categories.php
📄	comment-author-name.php
📄	comment-content.php
📄	comment-date.php
📄	comment-edit-link.php
📄	comment-reply-link.php
📄	comment-template.php
📄	comments-pagination-next.php
📄	comments-pagination-numbers.php
📄	comments-pagination-previous.php
📄	comments-pagination.php
📄	comments-title.php
📄	comments.php
📄	cover.php
📄	file.php
📄	footnotes.php
📄	gallery.php
📄	heading.php
📄	home-link.php
📄	image.php
📄	index.php
📄	latest-comments.php
📄	latest-posts.php
📄	legacy-widget.php
📄	list.php
📄	loginout.php
📄	media-text.php
📄	navigation-link.php
📄	navigation-submenu.php
📄	navigation.php
📄	page-list-item.php
📄	page-list.php
📄	pattern.php
📄	post-author-biography.php
📄	post-author-name.php
📄	post-author.php
📄	post-comments-form.php
📄	post-content.php
📄	post-date.php
📄	post-excerpt.php
📄	post-featured-image.php
📄	post-navigation-link.php
📄	post-template.php
📄	post-terms.php
📄	post-title.php
📄	query-no-results.php
📄	query-pagination-next.php
📄	query-pagination-numbers.php
📄	query-pagination-previous.php
📄	query-pagination.php
📄	query-title.php
📄	query.php
📄	read-more.php
📄	require-dynamic-blocks.php
📄	require-static-blocks.php
📄	rss.php
📄	search.php
📄	shortcode.php
📄	site-logo.php
📄	site-tagline.php
📄	site-title.php
📄	social-link.php
📄	tag-cloud.php
📄	template-part.php
📄	term-description.php
📄	widget-group.php