WordPress 果酱
·
Shortcode / 简码是什么？有什么用？一文详解 WordPress Shortcode。
内容提要
WordPress简码是使用[]包含的代码，根据定义的回调函数输出内容。Shortcode API从2.5版本开始引入，支持各种形式的简码。可以在后台撰写文章时直接选择简码区块或输入简码。每个简码都有一个回调函数来处理，函数有两个参数：属性和内容。可以使用add_shortcode函数定义简码和处理函数。可以使用WPJAM Basic插件的常用简码扩展查看所有简码。WordPress还定义了其他与简码相关的函数，如添加、移除和解析简码。可以在侧边栏的小工具和主题中使用简码。
关键要点
-
WordPress简码是使用[]包含的代码，WordPress会识别并根据回调函数输出内容。
-
Shortcode API从2.5版本开始引入，支持多种形式的简码，接口易用且功能强大。
-
Shortcode API支持自关闭标签、开放标签和含有参数的标签等多种组合形式。
-
在古腾堡编辑器中，可以直接选择简码区块输入简码，其他编辑器则直接输入简码。
-
每个简码都有一个回调函数处理，通常有两个参数：属性和内容。
-
使用add_shortcode函数定义简码和处理函数，以便简码能够按预期执行。
-
可以使用WPJAM Basic插件查看所有定义的简码，激活后在WPJAM菜单中查看。
-
WordPress定义了与简码相关的函数，包括添加、移除和解析简码的功能。
-
以WPJAM Basic插件的email简码为例，展示了如何将邮箱地址转义成HTML实体。
-
可以使用has_shortcode函数检测简码是否存在，以决定是否加载相关脚本。
-
可以通过add_filter在内容中移除简码，保持首页和列表页简单。
-
在侧边栏的小工具和主题中也可以使用简码，直接调用do_shortcode方法。
-
如果想在内容中直接输出简码而不执行，可以在简码外面多加一层[]。
