wordpress标签说明,wp:term-description

wordpress标签说明,wp:term-description

这段代码 <!-- wp:term-description /-->WordPress 块编辑器(Gutenberg) 的一个功能块,用于 自动显示当前分类法术语(Taxonomy Term)的描述内容

核心功能

  1. 动态显示术语描述

    • 访问「科技」分类页时,显示你在后台为「科技」分类填写的描述文本。

    • 访问「WordPress」标签页时,显示该标签的描述。

    • 在分类页(如分类目录、标签、自定义分类法)中,自动输出该术语的「描述」字段内容。

    • 例如:

  2. 适用场景

    • category.html(分类目录)

    • tag.html(标签页)

    • 自定义分类法模板(如 taxonomy-product_cat.html)。

    • 仅在与分类法术语相关的模板中有效,如:

代码细节

  • wp:term-description

    • 块类型,表示「术语描述」块。

  • 自闭合标签 />

    • 无需嵌套内容,自动从当前上下文获取数据。

输出示例

假设你在后台为「科技」分类填写了描述:

「这里是关于科技前沿动态的文章集合。」

则在模板中使用此块后,前端会渲染为:

<div class="wp-block-term-description">  <p>这里是关于科技前沿动态的文章集合。</p> </div>

典型用法

在分类模板中与其他块结合使用,例如:

<!-- wp:template-part {"slug":"header"} /--> <!-- wp:group {"tagName":"main"} --> <main>  <!-- wp:term-title {"type":"archive"} /-->  <!-- wp:term-description /-->  <!-- wp:post-template -->    <!-- 文章列表 -->  <!-- /wp:post-template --> </main> <!-- /wp:group --> <!-- wp:template-part {"slug":"footer"} /-->

自定义样式

通过 CSS 控制术语描述的显示效果:

.wp-block-term-description {  color: #666;  font-size: 1.1em;  margin-bottom: 2em; }

注意事项

  1. 依赖术语描述字段

    • 如果未在后台填写术语描述,则不会输出任何内容。

    • 编辑路径:文章 → 分类/标签 → 编辑术语 → 描述

  2. 仅限术语页面

    • 在普通文章/页面中使用此块无效(除非通过 Query Loop 动态上下文)。

对比相似块

块名称作用适用场景
wp:term-description显示当前分类/标签的描述分类页、标签页、自定义分类法页
wp:post-excerpt显示当前文章的摘要单篇文章或文章列表
wp:site-tagline显示网站的副标题(来自常规设置)全站通用

如果需要更复杂的描述布局,可以嵌套到 GroupCover 块中。

THE END
喜欢就支持以下吧
点赞 0
评论 抢沙发
友好交流,请勿发纯表情,请勿灌水,会被封号喔
提交