本文介绍如何扩展 wordpress 自定义短代码，使其不仅能输出当前页面标题，还能自动移除预设的冗余词汇（如“best”“top”“bay”等），提升内容展示的简洁性与专业性。
本文介绍如何扩展 wordpress 自定义短代码，使其不仅能输出当前页面标题，还能自动移除预设的冗余词汇（如“best”“top”“bay”等），提升内容展示的简洁性与专业性。
在 WordPress 主题或插件中，我们常通过短代码（shortcode）复用动态内容。默认的 [page_title] 短代码仅调用 get_the_title()，但实际运营中，页面标题可能包含营销化前缀（如 “Best”, “Top”, “#1”, “Ultimate”），而正文或侧栏展示时需更中性、精准的标题文本。
以下是一个增强版的短代码实现，支持大小写不敏感匹配与完整词边界过滤（避免误删单词片段），同时保持代码可维护性：
function post_title_shortcode($atts) {
// 解析短代码属性（可选：支持自定义排除词）
$atts = shortcode_atts([
'exclude' => 'Best,Top,#1,Ultimate,Amazing,Perfect'
], $atts);
// 将字符串转为数组，并去除空格与空项
$excluded_words = array_filter(array_map('trim', explode(',', $atts['exclude'])));
// 获取原始标题
$title = get_the_title();
// 使用 preg_replace 实现全词匹配替换（防止 "Top" 误删 "Topic" 中的 "Top"）
foreach ($excluded_words as $word) {
// 转义正则特殊字符，添加词边界 \b
$escaped_word = preg_quote($word, '/');
$title = preg_replace("/\b{$escaped_word}\b/i", '', $title);
}
// 清理多余空格：合并连续空格，去除首尾空格
$title = trim(preg_replace('/\s+/', ' ', $title));
return $title;
}
add_shortcode('page_title', 'post_title_shortcode');
✅ 使用示例：
- 在文章中插入 [page_title] → 自动过滤默认列表中的词；
- 自定义排除词：[page_title exclude="Best,Top,California"]；
- 支持中英文、符号（如 #1），且不区分大小写。
⚠️ 注意事项：
- 避免在 $excluded_words 中使用正则元字符（如 .、*、+），除非已明确转义；
- 若需保留标题结构（如“Best City in California” → “City in California”，而非“City in California”中间多出空格），上述正则+空格清理逻辑已优化处理；
- 建议将该函数放入子主题的 functions.php 或专用功能插件中，避免主题更新丢失。
通过这一改进，你不仅获得了更灵活的标题控制能力，也为后续扩展（如按分类动态排除、多语言适配）打下良好基础。
