Bricks 中文文档：bricks/breadcrumbs/items

前言

筛选在 Breadcrumbs 元素中渲染之前的面包屑项数组（HTML 字符串）。允许你添加、删除或修改特定的面包屑链接。

用法

将代码加入子主题的 functions.php：

add_filter( 'bricks/breadcrumbs/items', function( $breadcrumb_items ) {
    // Example: Add a custom item after the Home link (assuming Home is the first item)
    $custom_item = 'Custom Link';
    array_splice( $breadcrumb_items, 1, 0, $custom_item );


    return $breadcrumb_items;
} );

参数

• $breadcrumb_items (array)：面包屑项数组（HTML 字符串）。

示例代码

在首页后插入自定义链接

适用于需要在主导航后追加额外引导项的场景，例如商城分类页：

add_filter( 'bricks/breadcrumbs/items', function( $breadcrumb_items ) {
    // Example: Add a custom item after the Home link (assuming Home is the first item)
    $custom_item = 'Custom Link';
    array_splice( $breadcrumb_items, 1, 0, $custom_item );


    return $breadcrumb_items;
} );

隐藏当前页面包屑

某些落地页不需要显示自身名称，可用此方法移除最后一项：

add_filter( 'bricks/breadcrumbs/items', function( $breadcrumb_items ) {
    array_pop( $breadcrumb_items );
    return $breadcrumb_items;
} );

为面包屑项统一添加 data 属性

方便前端做埋点或样式控制：

add_filter( 'bricks/breadcrumbs/items', function( $breadcrumb_items ) {
    return array_map( function( $item ) {
        return str_replace( '

补充说明

更多细节可参考 官方文档。