WP区块标记/FSE文档查询及分类描述实现咨询

1. wp:query系列区块的参数文档获取方式 #

• 查看核心区块注册代码：WordPress核心里每个core/query-*系列区块（比如core/query-title）都是通过register_block_type函数注册的，其中attributes字段明确定义了所有可用参数。以wp:query-title为例，核心参数包括type（可选archive/post-title等）、align、showPrefix（控制是否显示“分类：”这类归档前缀）、style（自定义样式集合）等。
• 编辑器代码视图调试：在区块编辑器切换到代码视图，手动修改参数并预览效果，能直观验证每个参数的作用。比如把type改为post-title，就能看到标题显示逻辑的变化。
• 后台设置面板反向推导：每个可视化设置项都会对应代码里的参数，比如调整区块的“对齐方式”会生成align参数，通过这种方式可以快速对应参数与功能。

2. 归档页面显示分类法描述的最优方案 #

不需要自定义PHP模板片段，WordPress已提供现成的core/term-description区块（对应代码标记wp:term-description），直接添加到archive.html模板即可：

wp:term-description {"align":"wide","style":{"spacing":{"margin":{"bottom":"var:preset|spacing|40"}}}}

这个区块会自动识别当前归档页面对应的分类/术语，直接输出其描述内容，无需额外逻辑处理。

如果你的WordPress版本低于6.0不支持该区块，再用PHP模板片段方案：

• 创建自定义模板部分文件（比如parts/term-desc.php），内容如下：

<?php if ( is_tax() || is_category() || is_tag() ) : ?>
    <div class="term-description">
        <?php echo term_description(); ?>
    </div>
<?php endif; ?>

• 在archive.html中调用该模板部分：

wp:template-part {"slug":"term-desc","theme":"twentytwentyfour"}

内容的提问来源于stack exchange，提问作者Pierre