How to write the short code in WordPress PHP File?

在WordPress中使用短代码可以让用户轻松地在文章、页面或小部件中插入自定义内容或功能。以下是如何在WordPress PHP文件中编写和使用短代码的步骤：

步骤 1: 定义短代码函数

首先，您需要在您的主题的 functions.php 文件或自定义插件中定义一个处理短代码的函数。这个函数将包含您希望短代码执行的功能。

假设我们要创建一个显示当前日期的简单短代码：

php
function show_current_date() {
    return date('Y-m-d');
}

步骤 2: 注册短代码

接下来，您需要使用 add_shortcode() 函数来注册短代码，将短代码的标签和处理函数关联起来。

php
add_shortcode('current_date', 'show_current_date');

在这个例子中，'current_date' 是短代码的标签，而 'show_current_date' 是当这个短代码被调用时执行的函数。

步骤 3: 在内容中使用短代码

注册短代码后，您可以在WordPress的任何文章、页面或文本小部件中使用它。只需添加以下短代码：

shell
[current_date]

当WordPress渲染页面时，它会自动调用 show_current_date 函数，将 [current_date] 替换成当前日期。

案例示例

假设我们需要创建一个更复杂的短代码，比如显示特定用户的信息。我们首先需要定义处理这个短代码的函数：

php
function show_user_info($atts) {
    // 获取短代码的属性
    $atts = shortcode_atts(array(
        'id' => '1',  // 默认用户ID为1
    ), $atts);

    $user = get_userdata($atts['id']);
    if ($user) {
        return "用户名: " . $user->user_login . "<br>邮箱: " . $user->user_email;
    } else {
        return "用户不存在";
    }
}

然后注册这个短代码：

php
add_shortcode('user_info', 'show_user_info');

现在，在任何文章或页面中，您可以这样使用此短代码：

shell
[user_info id="2"]

这将显示ID为2的用户的用户名和邮箱。

通过这种方法，您可以灵活地在WordPress中添加各种自定义功能，只需要简单地插入一个小的短代码标签。