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

packages/block-library/src/query-title/index.php
103 строки3 KB
Sören Wünsch
Docs: Correct parameter name `$content` for query title render function. (#75945)
26 фев 2026, 12:47
26 фев 2026, 12:4751aa391
<?php
/**
 * Server-side rendering of the `core/query-title` block.
 *
 * @package WordPress
 */

/**
 * Renders the `core/query-title` block on the server.
 * For now it supports Archive title, Search title, and Post Type Label,
 * using queried object information
 *
 * @since 5.8.0
 *
 * @param array  $attributes Block attributes.
 * @param array  $content    Block content.
 * @param object $block      Block instance.
 *
 * @return string Returns the query title based on the queried object.
 */
function render_block_core_query_title( $attributes, $content, $block ) {
	$type       = $attributes['type'] ?? null;
	$is_archive = is_archive();
	$is_search  = is_search();
	$post_type  = $block->context['query']['postType'] ?? get_post_type();

	if ( ! $type ||
		( 'archive' === $type && ! $is_archive ) ||
		( 'search' === $type && ! $is_search ) ||
		( 'post-type' === $type && ! $post_type )
	) {
		return '';
	}
	$title = '';
	if ( $is_archive ) {
		$show_prefix = $attributes['showPrefix'] ?? true;
		if ( ! $show_prefix ) {
			add_filter( 'get_the_archive_title_prefix', '__return_empty_string', 1 );
			$title = get_the_archive_title();
			remove_filter( 'get_the_archive_title_prefix', '__return_empty_string', 1 );
		} else {
			$title = get_the_archive_title();
		}
	}
	if ( $is_search ) {
		$title = __( 'Search results' );

		if ( isset( $attributes['showSearchTerm'] ) && $attributes['showSearchTerm'] ) {
			$title = sprintf(
				/* translators: %s is the search term. */
				__( 'Search results for: &#8220;%s&#8221;' ),
				get_search_query()
			);
		}
	}
	if ( 'post-type' === $type ) {
		$post_type_object = get_post_type_object( $post_type );

		if ( ! $post_type_object ) {
			return '';
		}

		$post_type_name = $post_type_object->labels->singular_name;
		$show_prefix    = $attributes['showPrefix'] ?? true;

		if ( $show_prefix ) {
			$title = sprintf(
				/* translators: %s is the post type name. */
				__( 'Post Type: &#8220;%s&#8221;' ),
				$post_type_name
			);
		} else {
			$title = $post_type_name;
		}
	}

	$level    = (int) ( $attributes['level'] ?? 1 );
	$tag_name = 0 === $level ? 'p' : 'h' . $level;

	$align_class_name   = empty( $attributes['textAlign'] ) ? '' : "has-text-align-{$attributes['textAlign']}";
	$wrapper_attributes = get_block_wrapper_attributes( array( 'class' => $align_class_name ) );
	return sprintf(
		'<%1$s %2$s>%3$s</%1$s>',
		$tag_name,
		$wrapper_attributes,
		$title
	);
}

/**
 * Registers the `core/query-title` block on the server.
 *
 * @since 5.8.0
 */
function register_block_core_query_title() {
	register_block_type_from_metadata(
		__DIR__ . '/query-title',
		array(
			'render_callback' => 'render_block_core_query_title',
		)
	);
}
add_action( 'init', 'register_block_core_query_title' );