🆕 Bricks 2.4 已发布:查询循环性能提升 40%,迁移教程同步更新 →

首页 / 中文教程 / 教程

在 Bricks 中查询以特定字母开头的文章

教程:在 Bricks 中查询以特定字母开头的文章——Bricks 附完整代码可直接复用,适合外贸独立站与 WordPress 开发者。

Ray ChanRay Chan·2026-08-12·约 2 分钟

想在 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%' 即可,只是语义从「开头」变成「包含」。

延伸阅读

Ray Chan

站长

Ray Chan

WordPress Developer & Bricks Specialist

WordPress developer with 10+ years of client builds. Switched to Bricks in 2023 — now builds fast WordPress sites and migrates legacy Elementor/Divi projects.

延伸阅读