【WP|9】深入解析WordPress [add

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

news2024/11/25 14:27:01

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

在这里插入图片描述

`add_shortcode` 的语法

add_shortcode( $tag, $callback );

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

使用示例

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

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

function my_custom_shortcode($atts, $content = null) {
    // 提取和处理短代码属性
    $attributes = shortcode_atts(
        array(
            'attr1' => 'default_value1',
            'attr2' => 'default_value2',
        ), 
        $atts
    );

    // 返回短代码的输出内容
    return '<div class="custom-shortcode">' . $attributes['attr1'] . ' - ' . $attributes['attr2'] . '</div>';
}

// 注册短代码
add_shortcode('my_shortcode', 'my_custom_shortcode');

使用短代码：
在帖子或页面中，你可以使用以下语法插入短代码：
```
[my_shortcode attr1="value1" attr2="value2"]
```
这将被解析为：
```
<div class="custom-shortcode">value1 - value2</div>
```

更高级的用法

1. 短代码的嵌套

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

function my_nested_shortcode($atts, $content = null) {
    return '<div class="nested-shortcode">' . do_shortcode($content) . '</div>';
}

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 = '<ul class="category-posts">';
    foreach ($results as $post) {
        $output .= '<li>' . $post->post_title . '</li>';
    }
    $output .= '</ul>';

    return $output;
}

add_shortcode('complex_shortcode', 'my_complex_shortcode');