为了安全起见,禁止在WordPress内容中运行PHP;为了允许和内容进行动态交互,WordPress 2.5版本中提供了短代码。
短代码是可用于与内容执行动态交互的宏。即从附加到文章的图片创建图片库或渲染视频。
为什么使用短代码
短代码是保持内容整洁和语义的一种有价值的方法,同时允许最终用户以编程方式更改其内容的呈现。
当最终用户使用快捷代码将图片库添加到文章中时,他们使用的是尽可能少的数据来指示如何显示图片库。
优势:
- 没有向文章内容添加任何标记,这意味着标记和样式可以轻松地在运行中或稍后的状态下进行操作。
- 短代码也可以接受参数,允许用户逐个实例修改短代码的行为。
内置短代码
默认情况下,WordPress包含以下短代码:
[caption]
– 允许您以标题包裹内容[gallery]
– 允许您显示图像库[audio]
– 允许嵌入和播放音频文件[video]
– 允许嵌入和播放视频文件[playlist]
– 允许显示音频或视频文件的集合[embed]
– 允许包装嵌入的项目
短代码最佳实践
开发短代码的最佳实践包括插件开发最佳实践和以下列表:
- 始终返回!
短代码本质上是过滤器,因此产生副作用将导致意外的错误。 - 为您的短代码名添加前缀,以避免与其他插件发生冲突。
- 清理输入并转义输出。
- 为用户提供有关所有短代码属性的清晰文档。
快速参考
请参阅使用基本短码结构的完整示例,考虑自闭和封闭场景、短码内的短码和保护输出。