在WordPress中，创建自定义短代码是一项常见的任务，它允许你轻松地在内容中插入复杂的函数或模板，而无需直接编辑帖子或页面。以下是使用WordPress的Shortcode API创建自定义短代码的步骤：

步骤 1: 添加一个函数来处理短代码

首先，你需要创建一个函数来定义你的短代码的行为。这个函数将被短代码调用。

function my_custom_shortcode($atts, $content = null, $tag = '') {
    // 解析短代码属性
    $atts = shortcode_atts(
        array(
            'attribute1' => 'default_value1', // 属性及其默认值
            'attribute2' => 'default_value2',
        ), 
        $atts,
        $tag
    );

    // 你的自定义逻辑
    $output = '<div class="shortcode-content">';
    $output .= '这是我的自定义短代码内容。';
    $output .= '属性1的值是：' . esc_attr($atts['attribute1']);
    $output .= '属性2的值是：' . esc_attr($atts['attribute2']);
    $output .= '</div>';

    // 返回输出
    return $output;
}

步骤 2: 注册短代码

接下来，你需要使用add_shortcode()函数来注册你的短代码。这个函数有两个参数：短代码的名称和用于处理短代码的函数名。

add_shortcode('my_shortcode', 'my_custom_shortcode');

步骤 3: 在主题的functions.php文件中添加代码

将上面的代码添加到你的WordPress主题的functions.php文件中。如果你是在一个插件中创建短代码，那么就添加到插件的main PHP文件中。

// 在functions.php文件中添加以下代码

function my_custom_shortcode($atts, $content = null, $tag = '') {
    // 解析短代码属性和自定义逻辑
    // ...
}

add_shortcode('my_shortcode', 'my_custom_shortcode');

步骤 4: 使用短代码

在编辑帖子或页面时，你可以使用以下格式插入短代码：

[my_shortcode attribute1="value1" attribute2="value2"]

这将调用my_custom_shortcode函数，并且你可以通过$atts数组访问attribute1和attribute2的值。

示例

假设你的functions.php文件包含了上面的代码，你现在可以在你的帖子或页面中这样使用短代码：

这是我的文章内容。这里我插入一个自定义短代码：

[my_shortcode attribute1="自定义值1" attribute2="自定义值2"]

文章的其他内容继续。

当这个页面被访问时，[my_shortcode]将被替换为你定义的HTML输出。

通过这种方式，你可以创建复杂和功能丰富的短代码，使WordPress的内容管理更加灵活和强大。