WordPress 短代码（Shortcode）开发：创建可复用的内容模块

短代码（Shortcode）是 WordPress 的一项强大功能，允许用户在文章和页面中插入动态内容，只需输入简短的标签如 [gallery] 或 [contact-form]。本文介绍如何开发自定义短代码，创建可复用的内容模块。

注册短代码

使用 add_shortcode() 函数注册：add_shortcode('my_button', function($atts, $content=null){ $atts = shortcode_atts(array('url'=>'#','color'=>'blue','text'=>'点击这里'), $atts); return '<a href="'.esc_url($atts['url']).'" class="btn btn-'.esc_attr($atts['color']).'">'.esc_html($atts['text']).'</a>'; });

短代码参数

短代码支持属性参数：[my_button url="https://example.com" color="red" text="立即购买"]。使用 shortcode_atts() 合并默认值和用户传入的参数，确保所有参数都有值。

包含内容的短代码

短代码可以包裹内容：[highlight color="yellow"]这段文字会被高亮[/highlight]。在回调函数中，$content 参数包含标签之间的内容，使用 do_shortcode($content) 处理内嵌的短代码。

短代码最佳实践

始终使用 esc_attr()、esc_url()、esc_html() 转义输出；使用 shortcode_atts() 设置默认值；避免在短代码中直接输出，而是 return 字符串；在 init 钩子中注册短代码。

总结

短代码是 WordPress 内容模块化的利器，让编辑人员无需接触代码就能插入复杂的动态内容。