【WP|9】深入解析WordPress [add_shortcode]函数

add_shortcode 是 WordPress
中一个非常强大的函数，用于创建自定义的短代码（shortcodes）。短代码是一种简洁的方式，允许用户在内容中插入动态的、可重用的功能。通过
add_shortcode，开发者可以定义自己的短代码，然后用户可以在帖子、页面、小工具或其他内容区域中使用这些短代码来显示特定的内容或功能。

add_shortcode 的语法

add_shortcode( $tag, $callback );

• $tag（字符串）：这是短代码的名称，用户在内容中使用的标签。
• $callback（回调函数）：这是一个函数，当短代码被使用时将被调用。该函数应该返回短代码的输出内容。

使用示例

以下是一个简单的示例，展示如何创建和使用短代码。

1. 定义短代码：
   在你的主题的 functions.php 文件或插件文件中添加以下代码：

   function my_custom_shortcode($atts, $content = null) {
       // 提取和处理短代码属性
       $attributes = shortcode_atts(
           array(
               'attr1' => 'default_value1',
               'attr2' => 'default_value2',
           ), 
           $atts
       );
   
       // 返回短代码的输出内容
       return '' . $attributes['attr1'] . ' - ' . $attributes['attr2'] . '';
   }
   
   // 注册短代码
   add_shortcode('my_shortcode', 'my_custom_shortcode');
   

2. 使用短代码：
   在帖子或页面中，你可以使用以下语法插入短代码：

   [my_shortcode attr1="value1" attr2="value2"]
   

   这将被解析为：

   <div class="custom-shortcode">value1 - value2</div>
   

更高级的用法

1. 短代码的嵌套

短代码可以包含嵌套内容。下面是一个处理嵌套内容的示例：

function my_nested_shortcode($atts, $content = null) {
    return '' . do_shortcode($content) . '';
}

add_shortcode('nested_shortcode', 'my_nested_shortcode');

在帖子或页面中使用：

[nested_shortcode]这里是嵌套内容，可以包含其他短代码，比如 [my_shortcode attr1="value1"][/nested_shortcode]

2. 复杂的回调函数

回调函数可以非常复杂，包含条件逻辑、数据库查询等。例如：

function my_complex_shortcode($atts) {
    global $wpdb;

    $attributes = shortcode_atts(
        array(
            'category' => 'default',
        ), 
        $atts
    );

    $category = $attributes['category'];

    // 查询数据库
    $results = $wpdb->get_results(
        $wpdb->prepare(
            "SELECT * FROM wp_posts WHERE post_category = %s",
            $category
        )
    );

    $output = '
';
    foreach ($results as $post) {
        $output .= '
' . $post->post_title . '
';
    }
    $output .= '
';

    return $output;
}

add_shortcode('complex_shortcode', 'my_complex_shortcode');

在帖子或页面中使用：

[complex_shortcode category="news"]

总结

add_shortcode 是 WordPress 提供的一个非常有用的工具，允许开发者创建自定义的短代码，提供灵活的内容展示方式。通过合理使用短代码，可以极大地增强 WordPress 站点的功能和用户体验。