什么是WordPress简码?
WordPress简码(Shortcode)是一种通过方括号[ ]
包裹的特殊标签,用于快速在文章、页面或小工具中插入动态内容或功能。简码由WordPress核心、主题或插件提供,能够简化复杂功能的调用,例如显示表单、画廊、最新文章列表等。
如何使用内置简码?
WordPress默认提供了一些基础简码,例如:
- 画廊简码:
[gallery ids="1,2,3" columns="3"]
通过上传图片后获取附件ID,即可生成多列画廊。
- 音频/视频简码:
[audio src="音频文件URL"]
[video src="视频文件URL" width="600"]
- 嵌入简码: 直接粘贴YouTube或Twitter链接,WordPress会自动转换为嵌入内容,也可手动使用简码:
[embed]https://youtu.be/示例视频[/embed]
如何调用插件或主题的简码?
许多插件(如Contact Form 7、WooCommerce)和主题会提供自定义简码。例如:
- Contact Form 7:
[contact-form-7 id="123" title="联系表单"]
- WooCommerce产品展示:
[products limit="4" columns="2"]
使用前需查阅插件文档,确认简码名称和参数。
如何创建自定义简码?
通过主题的functions.php
文件或自定义插件,可以注册自己的简码。以下是一个示例:
function hello_shortcode() {
return '<p>你好,这是自定义简码!</p>';
}
add_shortcode('hello', 'hello_shortcode');
在编辑器中输入[hello]
即可输出定义的内容。
简码的进阶技巧
- 嵌套简码: 部分简码支持嵌套使用,例如:
[parent_shortcode][child_shortcode][/parent_shortcode]
- 参数传递: 简码可以接受参数,例如:
function greet_shortcode($atts) {
$atts = shortcode_atts(['name' => '访客'], $atts);
return '欢迎,' . $atts['name'] . '!';
}
add_shortcode('greet', 'greet_shortcode');
调用方式:[greet name="张三"]
- 禁用简码: 若需移除某个简码,可使用:
remove_shortcode('简码名称');
常见问题解答
Q:简码在页面中不生效?
- 检查简码名称是否正确,或确认插件/主题已激活。
- 部分编辑器需切换至“文本”模式输入简码。
Q:如何查找可用简码?
- 查阅插件/主题文档。
- 使用插件如「Shortcode Finder」扫描站点。
通过掌握简码的使用方法,你可以高效扩展WordPress功能,无需编写复杂代码即可实现丰富效果!