想在 Bricks 里显示所有以某个字母(比如 A)开头的文章?这篇教程给你方案。
相关阅读:
实现步骤
第 1 步:放大查询范围
在查询循环(Query Loop)或 Posts 元素的设置里,把 Posts per page 设为一个大于文章总数的数字。例如:站点共有 100 篇已发布文章,就把 Posts per page 设为 200(一个合理的、未来文章数量上限的估计值)。这样查询循环才会一次性取出全部文章,再由后面的代码过滤出「以指定字母开头」的那部分。
第 2 步:加入过滤代码
把下面代码加到子主题的 functions.php,或通过代码片段插件添加:
function wpse_298888_posts_where( $where, $query ) {
global $wpdb;
$starts_with = esc_sql( $query->get( 'starts_with' ) );
if ( $starts_with ) {
$where .= " AND $wpdb->posts.post_title LIKE '$starts_with%'";
}
return $where;
}
add_filter( 'posts_where', 'wpse_298888_posts_where', 10, 2 );
add_filter( 'bricks/posts/query_vars', function( $query_vars, $settings, $element_id ) {
if ( $element_id === 'lgbeyi' ) {
$query_vars['starts_with'] = 'A';
}
return $query_vars;
}, 10, 3 );
代码做了什么:
-
wpse_298888_posts_where挂在 WordPress 的posts_where过滤器上,往 SQL 查询追加一条post_title LIKE 'A%'条件——只匹配标题以指定字母开头的文章; -
bricks/posts/query_vars过滤器把自定义查询变量starts_with注入到指定的 Bricks 查询中,并设为'A'。
第 3 步:替换元素 ID
把代码里的 lgbeyi 替换成你自己的查询循环/Posts 元素的 Bricks ID(选中元素后,在结构面板的 ID 字段里可以看到)。
改完保存,前端就能看到标题以 A 开头的文章列表了。想匹配其他字母,把 'A' 换成对应字母即可。
参考
适用场景与注意
这个「按首字母过滤」的技巧适合做目录索引、词典式列表、品牌墙这类需要按字母归类展示的场景——比如「A 开头的产品」「B 开头的客户案例」。实现上它依赖往查询里注入一个自定义查询变量(starts_with)并用 LIKE 'A%' 匹配 post_title 开头,所以只适合按标题首字符筛,换字段或换语言(非拉丁字母)时匹配规则要相应调整。另外记得把代码里的元素 ID 换成你自己查询循环/Posts 元素的 Bricks ID,复制粘贴忘改 ID 是最常见的失灵原因。
常见问题(FAQ)
Q:这个方案按什么过滤?
A:按文章标题(post_title)的首字母,用 LIKE 'A%' 匹配开头。
Q:代码放进去没反应? A:多半是没把示例里的元素 ID 换成你自己查询循环/Posts 元素的 Bricks ID。
Q:能按中文/非拉丁字母首字过滤吗? A:原理一样,但匹配规则要按对应字符集调整,直接套拉丁字母的 LIKE 不一定准。
Q:能换成按标题里任意位置包含某字母吗?
A:能,把 LIKE 'A%' 改成 '%A%' 即可,只是语义从「开头」变成「包含」。
延伸阅读
- 想要现成外贸独立站模板与建站实战?看 铲子铺 chanzipu 的外贸建站教程(同用 Bricks,从零搭出能收询盘的站)
- 相关阅读:Bricks Query Loop Api Data
延伸阅读
Bricks 查询循环输出 ACF 图片字段的 Alt、Caption、标题数据
教程:Bricks 查询循环输出 ACF 图片字段的 Alt、Caption、标题数据——acf 附完整代码可直接复用,适合外贸独立站与 WordPress 开发者。
tutorialBricks 中输出 ACF Relationship 关联文章的数量
教程:Bricks 中输出 ACF Relationship 关联文章的数量——acf 附完整代码可直接复用,适合外贸独立站与 WordPress 开发者。
tutorialACF Relationship 字段 + Bricks 查询循环:显示关联文章
教程:ACF Relationship 字段 + Bricks 查询循环:显示关联文章——acf 附完整代码可直接复用,适合外贸独立站与 WordPress 开发者。
tutorial把任意自定义 WP_Query 循环接入 Bricks 查询循环
教程:把任意自定义 WP_Query 循环接入 Bricks 查询循环——Bricks 附完整代码可直接复用,适合外贸独立站与 WordPress 开发者。
