在服务器上呈现核心/归档块。

原型

render_block_core_archives( array $attributes )

参数

$attributes (array) (Required) 块属性。

返回值

(string)  返回添加了存档的帖子内容。

源文件

路径:wp-includes/blocks/archives.php

<?php
...
function render_block_core_archives( $attributes ) {
	$show_post_count = ! empty( $attributes['showPostCounts'] );
	$class = 'wp-block-archives';
	if ( isset( $attributes['align'] ) ) {
		$class .= " align{$attributes['align']}";
	}
	if ( isset( $attributes['className'] ) ) {
		$class .= " {$attributes['className']}";
	}
	if ( ! empty( $attributes['displayAsDropdown'] ) ) {
		$class .= ' wp-block-archives-dropdown';
		$dropdown_id = esc_attr( uniqid( 'wp-block-archives-' ) );
		$title       = __( 'Archives' );
		/** This filter is documented in wp-includes/widgets/class-wp-widget-archives.php */
		$dropdown_args = apply_filters(
			'widget_archives_dropdown_args',
			array(
				'type'            => 'monthly',
				'format'          => 'option',
				'show_post_count' => $show_post_count,
			)
		);
		$dropdown_args['echo'] = 0;
		$archives = wp_get_archives( $dropdown_args );
		switch ( $dropdown_args['type'] ) {
			case 'yearly':
				$label = __( 'Select Year' );
				break;
			case 'monthly':
				$label = __( 'Select Month' );
				break;
			case 'daily':
				$label = __( 'Select Day' );
				break;
			case 'weekly':
				$label = __( 'Select Week' );
				break;
			default:
				$label = __( 'Select Post' );
				break;
		}
		$label = esc_attr( $label );
		$block_content = '<label class="screen-reader-text" for="' . $dropdown_id . '">' . $title . '</label>
	<select id="' . $dropdown_id . '" name="archive-dropdown" onchange="document.location.href=this.options[this.selectedIndex].value;">
	<option value="">' . $label . '</option>' . $archives . '</select>';
		$block_content = sprintf(
			'<div class="%1$s">%2$s</div>',
			esc_attr( $class ),
			$block_content
		);
	} else {
		$class .= ' wp-block-archives-list';
		/** This filter is documented in wp-includes/widgets/class-wp-widget-archives.php */
		$archives_args = apply_filters(
			'widget_archives_args',
			array(
				'type'            => 'monthly',
				'show_post_count' => $show_post_count,
			)
		);
		$archives_args['echo'] = 0;
		$archives = wp_get_archives( $archives_args );
		$classnames = esc_attr( $class );
		if ( empty( $archives ) ) {
			$block_content = sprintf(
				'<div class="%1$s">%2$s</div>',
				$classnames,
				__( 'No archives to show.' )
			);
		} else {
			$block_content = sprintf(
				'<ul class="%1$s">%2$s</ul>',
				$classnames,
				$archives
			);
		}
	}
	return $block_content;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/render_block_core_archives/