No Comments

WordPress Shortcode（简码）介绍

原文地址：http://www.wpdaxue.com/wordpress-shortcode.html

WordPress Shortcode 指的是一些使用[]包含的短代码，WordPress会识别这些短代码并根据短代码的定义输出为特定的内容。

然后把自己定义的 Shortcode 和其处理函数管理起来，以便 [mycode attr="value"]content[/mycode] 能够按照预期执行。

Shortcode 相关的所有函数

WordPress 定义了以下和 Shortcode 相关的函数：

  1. add_shortcode('mycode', 'function_name'); // 定义一个新的 Shortcode
  2. remove_shortcode('mycode'); // 移除一个 Shortcode
  3. remove_all_shortcodes(); // 移除所有的 Shortcode
  4. $return = do_shortcode($content); // 应用 Shortcode 到内容而不输出

一个简单的 Shortcode 例子

把下面的代码保存到你当前的主题的 functions.php，或者上传到插件目录下并激活。

  1. <?php
  2. /*
  3. Plugin Name: Shorcode for Google Adsense
  4. Plugin URI:  http://blog.wpjam.com/m/shortcode-google-adsense/
  5. Description: 使用 Shortcode 投放 Google Adsense 广告
  6. Version: 0.1
  7. Author: Denis
  8. */
  9. add_shortcode('adsense', 'adsense_shortcode');
  10. function adsense_shortcode($atts) {
  11. 	extract(shortcode_atts(array(
  12. 	'type' => '468x60',
  13. 	), $atts));
  14. 	switch ($type) {
  15. 		case '468x60' :
  16. 		return
  17. 			//468x60 的广告代码
  18. 		case '300x250' :
  19. 		return
  20. 			//300x250 的广告代码
  21. 	}
  22. }

然后你就可以通过撰写文章的时候，在相应的位置输入 [adsense] 你的 468×60 的广告代码（默认的广告代码），如果你想插入 300×250 的广告代码，在文章内容中插入 [adsense type="300x250"]，当然你也可以扩展上面的代码增加更多广告的格式和类型。

这样就可以想把广告插在文章中的哪个位置，就能插在哪个位置了，  非常方便。

在侧边栏 Widgets 中使用 Shortcode

Shortcode 很方便，但是只能用在日志内容中，那么如何在 WordPress 的侧边栏的 Widgets 中使用 Shortcode，在当前主题的functions.php 中添加如下代码：

  1. add_filter('widget_text', 'do_shortcode');

然后你在 WordPress 后台 > 外观 > Widgets 界面添加一个文本 Widget，然后插入博客中经启用 shortcode 即可。

在主题的文件中使用 Shortcode

如果你想用在主题文件中使用名为 [my_shortcode] 的 Shortcode，你只需要按照下面的方式使用do_shortcode() 函数即可：

  1. <?php echo do_shortcode("[my_shortcode]"); ?>

解决 Shortcode 中自动添加的 br 或者 p 标签

造成这个问题的原因是 WordPress 默认的日志内容处理流程中，wpautop（将回车转换成 p 或者 br 标签的函数）是在 Shortcode 前面运行的。所以我们的解决方案也是非常简单，改变它们执行的顺序，在当前主题的 functions.php 文件中添加：

  1. remove_filter( 'the_content', 'wpautop' );
  2. add_filter( 'the_content', 'wpautop' , 12);

这样调整顺序之后，你的 shortcode 里面的内容，就不会有自动添加的 p 或者 br 标签，但是如果 shortcode 中部分的内容你又需要一些 p 或者 br 标签用来换行的话，你需要自己手动在自己 shortcode 处理程序中添加 wpautop 来处理了。

 

最后更新于 2017-03-17 15:58:08 并被添加「wordpress Shortcode」标签，已有 473 位童鞋阅读过。

相关文章

此处评论已关闭