短代码是 WordPress 中一个经典而强大的功能,允许用户在内容中嵌入动态内容。通过主题内置的短代码,内容编辑者可以轻松插入复杂的功能模块,而不需要编写任何代码。本文介绍主题中短代码的开发和使用方法。

短代码注册的基本语法

使用 add_shortcode 函数注册短代码。第一个参数是短代码标签,用户在编辑器中输入的短代码名称。第二个参数是回调函数,负责生成短代码的输出内容。

带参数的短代码

短代码可以接受属性参数,用户通过 [shortcode key="value"] 的方式传递参数。在回调函数中使用 shortcode_atts 函数合并默认属性和用户提供的属性。

带内容的短代码

短代码可以包裹内容,格式为 [shortcode]内容[/shortcode]。在回调函数中,内容作为第二个参数传入。这种模式适合创建包装型短代码,比如按钮、高亮框等。

短代码与数据库查询

短代码中可以执行数据库查询,但要注意性能。尽量使用缓存减少重复查询。对于需要频繁使用的短代码,考虑将查询结果缓存到对象缓存中。

短代码与前端资源

如果短代码需要特定的 CSS 或 JavaScript,应该在短代码的回调函数中动态加载资源。使用 wp_enqueue_style 和 wp_enqueue_script 确保资源只在需要时加载。

嵌套短代码的处理

如果短代码支持嵌套,在回调函数中使用 do_shortcode 处理内容中的嵌套短代码。这可以让用户在一个短代码中嵌入另一个短代码。