packages/block-library/src/query-total/index.php - trunk - githubmirror/gutenberg

packages/block-library/src/query-total/index.php
90 строк2 KB
Weston Ruter
Use null coalescing operator for common isset patterns (#75487)
14 фев 2026, 13:57
14 фев 2026, 13:57b01da55
<?php
/**
 * Server-side rendering of the `core/query-total` block.
 *
 * @package WordPress
 */

/**
 * Renders the `query-total` block on the server.
 *
 * @since 6.8.0
 *
 * @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 The rendered block content.
 */
function render_block_core_query_total( $attributes, $content, $block ) {
	global $wp_query;
	$wrapper_attributes = get_block_wrapper_attributes();
	if ( $block->context['query']['inherit'] ?? false ) {
		$query_to_use = $wp_query;
		$current_page = max( 1, (int) get_query_var( 'paged', 1 ) );
	} else {
		$page_key     = isset( $block->context['queryId'] ) ? 'query-' . $block->context['queryId'] . '-page' : 'query-page';
		$current_page = (int) ( $_GET[ $page_key ] ?? 1 );
		$query_to_use = new WP_Query( build_query_vars_from_query_block( $block, $current_page ) );
	}

	$max_rows       = $query_to_use->found_posts;
	$posts_per_page = (int) $query_to_use->get( 'posts_per_page' );

	// Calculate the range of posts being displayed.
	$start = ( 0 === $max_rows ) ? 0 : ( ( $current_page - 1 ) * $posts_per_page + 1 );
	$end   = min( $start + $posts_per_page - 1, $max_rows );

	// Prepare the display based on the `displayType` attribute.
	$output = '';
	switch ( $attributes['displayType'] ) {
		case 'range-display':
			if ( $start === $end ) {
				$output = sprintf(
					/* translators: 1: Start index of posts, 2: Total number of posts */
					__( 'Displaying %1$s of %2$s' ),
					$start,
					$max_rows
				);
			} else {
				$output = sprintf(
					/* translators: 1: Start index of posts, 2: End index of posts, 3: Total number of posts */
					__( 'Displaying %1$s – %2$s of %3$s' ),
					$start,
					$end,
					$max_rows
				);
			}

			break;

		case 'total-results':
		default:
			// translators: %d: number of results.
			$output = sprintf( _n( '%d result found', '%d results found', $max_rows ), $max_rows );
			break;
	}

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

/**
 * Registers the `query-total` block.
 *
 * @since 6.8.0
 */
function register_block_core_query_total() {
	register_block_type_from_metadata(
		__DIR__ . '/query-total',
		array(
			'render_callback' => 'render_block_core_query_total',
		)
	);
}
add_action( 'init', 'register_block_core_query_total' );