gutenberg / build / scripts / block-library / post-template.php

post-template.php in Gutenberg 23.6.0, at build/scripts/block-library/post-template.php

166 lines 5.9 KB

Raw Download Zip

1	<?php
2	/**
3	* Server-side rendering of the `core/post-template` block.
4	*
5	* @package WordPress
6	*/
7
8	/**
9	* Determines whether a block list contains a block that uses the featured image.
10	*
11	* @since 6.0.0
12	*
13	* @param WP_Block_List $inner_blocks Inner block instance.
14	*
15	* @return bool Whether the block list contains a block that uses the featured image.
16	*/
17	function gutenberg_block_core_post_template_uses_featured_image( $inner_blocks ) {
18	foreach ( $inner_blocks as $block ) {
19	if ( 'core/post-featured-image' === $block->name ) {
20	return true;
21	}
22	if (
23	'core/cover' === $block->name &&
24	! empty( $block->attributes['useFeaturedImage'] )
25	) {
26	return true;
27	}
28	if ( $block->inner_blocks && gutenberg_block_core_post_template_uses_featured_image( $block->inner_blocks ) ) {
29	return true;
30	}
31	}
32
33	return false;
34	}
35
36	/**
37	* Renders the `core/post-template` block on the server.
38	*
39	* @since 6.3.0 Changed render_block_context priority to `1`.
40	*
41	* @global WP_Query $wp_query WordPress Query object.
42	*
43	* @param array $attributes Block attributes.
44	* @param string $content Block default content.
45	* @param WP_Block $block Block instance.
46	*
47	* @return string Returns the output of the query, structured using the layout defined by the block's inner blocks.
48	*/
49	function gutenberg_render_block_core_post_template( $attributes, $content, $block ) {
50	$page_key = isset( $block->context['queryId'] ) ? 'query-' . $block->context['queryId'] . '-page' : 'query-page';
51	$enhanced_pagination = (bool) ( $block->context['enhancedPagination'] ?? false );
52	$page = empty( $_GET[ $page_key ] ) ? 1 : (int) $_GET[ $page_key ];
53
54	// Use global query if needed.
55	$use_global_query = (bool) ( $block->context['query']['inherit'] ?? false );
56	if ( $use_global_query ) {
57	global $wp_query;
58
59	/*
60	* If already in the main query loop, duplicate the query instance to not tamper with the main instance.
61	* Since this is a nested query, it should start at the beginning, therefore rewind posts.
62	* Otherwise, the main query loop has not started yet and this block is responsible for doing so.
63	*/
64	if ( in_the_loop() ) {
65	$query = clone $wp_query;
66	$query->rewind_posts();
67	} else {
68	$query = $wp_query;
69	}
70	} else {
71	$query_args = build_query_vars_from_query_block( $block, $page );
72	$query = new WP_Query( $query_args );
73	}
74
75	if ( ! $query->have_posts() ) {
76	return '';
77	}
78
79	if ( gutenberg_block_core_post_template_uses_featured_image( $block->inner_blocks ) ) {
80	update_post_thumbnail_cache( $query );
81	}
82
83	$classnames = '';
84	if ( isset( $block->context['displayLayout'] ) && isset( $block->context['query'] ) ) {
85	if ( isset( $block->context['displayLayout']['type'] ) && 'flex' === $block->context['displayLayout']['type'] ) {
86	$classnames = "is-flex-container columns-{$block->context['displayLayout']['columns']}";
87	}
88	}
89	if ( isset( $attributes['style']['elements']['link']['color']['text'] ) ) {
90	$classnames .= ' has-link-color';
91	}
92
93	// Ensure backwards compatibility by flagging the number of columns via classname when using grid layout.
94	if ( isset( $attributes['layout']['type'] ) && 'grid' === $attributes['layout']['type'] && ! empty( $attributes['layout']['columnCount'] ) ) {
95	$classnames .= ' ' . sanitize_title( 'columns-' . $attributes['layout']['columnCount'] );
96	}
97	if ( isset( $attributes['layout']['type'] ) && 'grid' === $attributes['layout']['type'] && ! empty( $attributes['layout']['columnCount'] ) && ! empty( $attributes['layout']['minimumColumnWidth'] ) ) {
98	$classnames .= ' has-native-responsive-grid';
99	}
100
101	$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => trim( $classnames ) ) );
102
103	$content = '';
104	while ( $query->have_posts() ) {
105	$query->the_post();
106
107	// Get an instance of the current Post Template block.
108	$block_instance = $block->parsed_block;
109
110	// Set the block name to one that does not correspond to an existing registered block.
111	// This ensures that for the inner instances of the Post Template block, we do not render any block supports.
112	$block_instance['blockName'] = 'core/null';
113
114	$post_id = get_the_ID();
115	$post_type = get_post_type();
116	$filter_block_context = static function ( $context ) use ( $post_id, $post_type ) {
117	$context['postType'] = $post_type;
118	$context['postId'] = $post_id;
119	return $context;
120	};
121
122	// Use an early priority to so that other 'render_block_context' filters have access to the values.
123	add_filter( 'render_block_context', $filter_block_context, 1 );
124	// Render the inner blocks of the Post Template block with `dynamic` set to `false` to prevent calling
125	// `render_callback` and ensure that no wrapper markup is included.
126	$block_content = ( new WP_Block( $block_instance ) )->render( array( 'dynamic' => false ) );
127	remove_filter( 'render_block_context', $filter_block_context, 1 );
128
129	// Wrap the render inner blocks in a `li` element with the appropriate post classes.
130	$post_classes = implode( ' ', get_post_class( 'wp-block-post' ) );
131
132	$inner_block_directives = $enhanced_pagination ? ' data-wp-key="post-template-item-' . $post_id . '"' : '';
133
134	$content .= '<li' . $inner_block_directives . ' class="' . esc_attr( $post_classes ) . '">' . $block_content . '</li>';
135	}
136
137	/*
138	* Use this function to restore the context of the template tags
139	* from a secondary query loop back to the main query loop.
140	* Since we use two custom loops, it's safest to always restore.
141	*/
142	wp_reset_postdata();
143
144	return sprintf(
145	'<ul %1$s>%2$s</ul>',
146	$wrapper_attributes,
147	$content
148	);
149	}
150
151	/**
152	* Registers the `core/post-template` block on the server.
153	*
154	* @since 5.8.0
155	*/
156	function gutenberg_register_block_core_post_template() {
157	register_block_type_from_metadata(
158	__DIR__ . '/post-template',
159	array(
160	'render_callback' => 'gutenberg_render_block_core_post_template',
161	'skip_inner_blocks' => true,
162	)
163	);
164	}
165	add_action( 'init', 'gutenberg_register_block_core_post_template', 20 );
166