enmi-conf.org: wp/wp-includes/blocks/query-pagination-previous.php@48c4eec2b7e6 (annotated)

18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	1	<?php
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	2	/**
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	3	* Server-side rendering of the `core/query-pagination-previous` block.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	4	*
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	5	* @package WordPress
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	6	*/
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	7
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	8	/**
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	9	* Renders the `core/query-pagination-previous` block on the server.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	10	*
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	11	* @since 5.8.0
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	12	*
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	13	* @param array $attributes Block attributes.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	14	* @param string $content Block default content.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	15	* @param WP_Block $block Block instance.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	16	*
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	17	* @return string Returns the previous posts link for the query.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	18	*/
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	19	function render_block_core_query_pagination_previous( $attributes, $content, $block ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	20	$page_key = isset( $block->context['queryId'] ) ? 'query-' . $block->context['queryId'] . '-page' : 'query-page';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	21	$enhanced_pagination = isset( $block->context['enhancedPagination'] ) && $block->context['enhancedPagination'];
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	22	$page = empty( $_GET[ $page_key ] ) ? 1 : (int) $_GET[ $page_key ];
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	23
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	24	$wrapper_attributes = get_block_wrapper_attributes();
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	25	$show_label = isset( $block->context['showLabel'] ) ? (bool) $block->context['showLabel'] : true;
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	26	$default_label = __( 'Previous Page' );
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	27	$label_text = isset( $attributes['label'] ) && ! empty( $attributes['label'] ) ? esc_html( $attributes['label'] ) : $default_label;
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	28	$label = $show_label ? $label_text : '';
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	29	$pagination_arrow = get_query_pagination_arrow( $block, false );
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	30	if ( ! $label ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	31	$wrapper_attributes .= ' aria-label="' . $label_text . '"';
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	32	}
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	33	if ( $pagination_arrow ) {
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	34	$label = $pagination_arrow . $label;
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	35	}
3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	36	$content = '';
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	37	// Check if the pagination is for Query that inherits the global context
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	38	// and handle appropriately.
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	39	if ( isset( $block->context['query']['inherit'] ) && $block->context['query']['inherit'] ) {
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	40	$filter_link_attributes = static function () use ( $wrapper_attributes ) {
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	41	return $wrapper_attributes;
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	42	};
19 3d72ae0968f4 upgrade wordpress to 6.0.2 ymh <ymh.work@gmail.com> parents: 18 diff changeset	43
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	44	add_filter( 'previous_posts_link_attributes', $filter_link_attributes );
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	45	$content = get_previous_posts_link( $label );
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	46	remove_filter( 'previous_posts_link_attributes', $filter_link_attributes );
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	47	} elseif ( 1 !== $page ) {
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	48	$content = sprintf(
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	49	'<a href="%1$s" %2$s>%3$s</a>',
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	50	esc_url( add_query_arg( $page_key, $page - 1 ) ),
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	51	$wrapper_attributes,
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	52	$label
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	53	);
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	54	}
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	55
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	56	if ( $enhanced_pagination && isset( $content ) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	57	$p = new WP_HTML_Tag_Processor( $content );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	58	if ( $p->next_tag(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	59	array(
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	60	'tag_name' => 'a',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	61	'class_name' => 'wp-block-query-pagination-previous',
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	62	)
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	63	) ) {
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	64	$p->set_attribute( 'data-wp-key', 'query-pagination-previous' );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	65	$p->set_attribute( 'data-wp-on--click', 'core/query::actions.navigate' );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	66	$p->set_attribute( 'data-wp-on-async--mouseenter', 'core/query::actions.prefetch' );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	67	$p->set_attribute( 'data-wp-watch', 'core/query::callbacks.prefetch' );
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	68	$content = $p->get_updated_html();
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	69	}
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	70	}
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	71
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	72	return $content;
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	73	}
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	74
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	75	/**
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	76	* Registers the `core/query-pagination-previous` block on the server.
21 48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	77	*
48c4eec2b7e6 Add CLAUDE.md documentation and sync WordPress core files ymh <ymh.work@gmail.com> parents: 19 diff changeset	78	* @since 5.8.0
18 be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	79	*/
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	80	function register_block_core_query_pagination_previous() {
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	81	register_block_type_from_metadata(
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	82	__DIR__ . '/query-pagination-previous',
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	83	array(
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	84	'render_callback' => 'render_block_core_query_pagination_previous',
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	85	)
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	86	);
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	87	}
be944660c56a Site enmi version 09/2022 ymh <ymh.work@gmail.com> parents: diff changeset	88	add_action( 'init', 'register_block_core_query_pagination_previous' );

author	ymh <ymh.work@gmail.com>
	Fri, 05 Sep 2025 18:40:08 +0200
changeset 21	48c4eec2b7e6
parent 19	3d72ae0968f4
child 22	8c2e4d02f4ef
permissions	-rw-r--r--