render_block_core_block

函数
render_block_core_block ( $attributes )
参数
  • (array) $attributes The block attributes.
    Required:
返回值
  • (string) Rendered HTML of the referenced block.
定义位置
相关方法
register_block_core_blockrender_block_core_filerender_block_core_coverrender_block_core_rssrender_block_core_loginout
引入
-
弃用
-

render_block_core_block: 这个函数用来渲染WordPress中的Block块。Block块允许用户在另一个块中显示一个特定的块: 这个函数负责生成Block块的HTML标记。

在服务器上运行`core/block’区块。

function render_block_core_block( $attributes ) {
	static $seen_refs = array();

	if ( empty( $attributes['ref'] ) ) {
		return '';
	}

	$reusable_block = get_post( $attributes['ref'] );
	if ( ! $reusable_block || 'wp_block' !== $reusable_block->post_type ) {
		return '';
	}

	if ( isset( $seen_refs[ $attributes['ref'] ] ) ) {
		// WP_DEBUG_DISPLAY must only be honored when WP_DEBUG. This precedent
		// is set in `wp_debug_mode()`.
		$is_debug = defined( 'WP_DEBUG' ) && WP_DEBUG &&
			defined( 'WP_DEBUG_DISPLAY' ) && WP_DEBUG_DISPLAY;

		return $is_debug ?
			// translators: Visible only in the front end, this warning takes the place of a faulty block.
			__( '[block rendering halted]' ) :
			'';
	}

	if ( 'publish' !== $reusable_block->post_status || ! empty( $reusable_block->post_password ) ) {
		return '';
	}

	$seen_refs[ $attributes['ref'] ] = true;

	// Handle embeds for reusable blocks.
	global $wp_embed;
	$content = $wp_embed->run_shortcode( $reusable_block->post_content );
	$content = $wp_embed->autoembed( $content );

	$content = do_blocks( $content );
	unset( $seen_refs[ $attributes['ref'] ] );
	return $content;
}

常见问题

FAQs
查看更多 >