跳到主要内容

Breadcrumb

描述 WebPage 在 WebSite 中的层级位置。

本地环境中的面包屑导航

在本地环境中，或在完全禁用可索引对象创建的网站中，面包屑导航可能无法正常工作。

具体来说，在这些设置下，面包屑路径的层级结构可能会缺少中间节点，例如文章所属的分类，或子页面的父页面。

触发器​

应作为顶级节点添加到所有具有有效 WebPage 的公开页面的图谱中，但 4xx 和 5xx 范围错误页面/场景除外。

必需属性​

一个有效的 BreadcrumbList 必须具有以下属性。

  • @type: BreadcrumbList。
  • @id: 网站的首页 URL 后追加 #/schema/BreadcrumbList/{{ID}}，其中 {{ID}} 是“父”网页的唯一标识符。
  • itemListElement: 一个 ListItem 对象数组，表示当前页面在网站层级结构中的位置，每个对象具有以下属性：
    • position: 一个整数（从 1 开始），计算页面从首页（包括首页）开始的“深度”。
    • name: 相关页面的名称，即面包屑导航中显示的名称。
    • item: 相关页面的未修改的规范 URL。

还需注意：

  • _分页状态_不应包含/表示在列表中。
  • 最后一个/当前的“面包屑”应省略 item 属性。

失败场景​

如果任何必填字段缺失或无效，则不应输出该节点。

如果未输出该节点，任何原本会声明与 BreadcrumbList 存在关系的实体都应移除这些引用。

示例​

最低标准​

{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "BreadcrumbList",
            "@id": "https://www.example.com/#/schema/BreadcrumbList/abc123",
            "itemListElement": [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "name": "Home",
                    "item": "https://www.example.com/"
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "name": "Example Section",
                    "item": "https://www.example.com/example-section/"
                },
                {
                    "@type": "ListItem",
                    "position": 3,
                    "name": "Example Page"
                }
            ]
        }
    ]
}

WordPress API：更改面包屑架构输出​

要修改 Yoast SEO 输出的 Breadcrumb 架构，您可以使用我们的 wpseo_schema_breadcrumb 过滤器。示例如下：

替换面包屑架构中的域名​


如果您想替换面包屑架构中的域名，可以使用 `wpseo_schema_breadcrumb` 过滤器单独挂钩到面包屑架构片段。
add_filter( 'wpseo_schema_breadcrumb', 'replace_domain_name_to_breadcrumb_schema', 11, 2 );
/**
 * 单独替换面包屑架构片段中的域名。
 * 
 * 
 * @param array $piece Schema.org 面包屑数据数组。
 * @return array 修改后的 Schema.org 面包屑数据数组。
 */
function replace_domain_name_to_breadcrumb_schema( $piece ) {
    $piece['@id'] = str_replace( 'olddomain.tld', 'newdomain.tld', $piece['@id'] );
    foreach ( $piece['itemListElement'] as &$list ) {
            $list['item'] = str_replace( 'olddomain.tld', 'newdomain.tld', $list['item'] );
        if ( $list['item'] ) {
        }
    }
    return $piece;
}

要对我们的架构输出进行更多更改，请参阅 Yoast SEO Schema API。