WordPress 用户最后登录时间短代码实现教程

时间：2026-03-31 15:41 来源：西西软件网作者：佚名

本文提供一个可靠、安全的 wordpress 短代码方案，用于在前台准确显示当前登录用户的「上一次登录时间」和「本次登录时间」，解决 `get_the_author_meta()` 在非作者页面返回错误用户数据的核心问题。

在 WordPress 中，直接使用 get_the_author_meta() 获取登录时间存在严重逻辑缺陷：该函数默认依赖全局 $post 和作者上下文（即文章作者），并非当前登录用户。因此，当访客（如普通注册用户）在首页、页面或自定义模板中使用 [lastlogin] 时，系统常误取管理员或最近一篇文章作者的 last_login 值，导致所有用户看到同一时间——这正是原始代码失效的根本原因。

以下是一套经过验证、生产就绪的解决方案，已适配 WordPress 最新版本（6.0+），并遵循最佳实践：

✅ 正确实现原理

使用 wp_login 钩子捕获每次成功登录事件；
区分存储「本次登录时间」（_last_login）与「上一次登录时间」（_last_login_prev）；
短代码中通过 global $current_user 明确获取当前会话用户 ID，杜绝上下文混淆；
所有元字段加下划线前缀（如 _last_login），确保不被前台用户编辑（符合 WordPress 安全约定）。

? 完整代码（请放入子主题 functions.php）

// 【1】登录时记录时间（含历史时间迁移）
add_action('wp_login', 'set_last_login', 10, 2);
function set_last_login($login, $user) {
    $user = get_user_by('login', $login);
    if (!$user) return;

    $now = current_time('timestamp');
    $prev = get_user_meta($user->ID, '_last_login', true);

    // 若已有上次记录，则存入 _last_login_prev；否则初始化 _last_login
    if ($prev) {
        update_user_meta($user->ID, '_last_login_prev', $prev);
    }
    update_user_meta($user->ID, '_last_login', $now);
}

// 【2】安全获取登录时间（自动 fallback 初始化）
function get_last_login($user_id, $prev = false) {
    if (!$user_id) return 0;

    if ($prev) {
        $time = get_user_meta($user_id, '_last_login_prev', true);
    } else {
        $time = get_user_meta($user_id, '_last_login', true);
    }

    // 若无记录，写入当前时间并返回（防空值崩溃）
    if (empty($time)) {
        $time = current_time('timestamp');
        update_user_meta($user_id, $prev ? '_last_login_prev' : '_last_login', $time);
    }

    return (int) $time;
}

// 【3】短代码：显示「上一次登录时间」
function last_login_date() {
    if (!is_user_logged_in()) {
        return 'Please log in to view your last login.';
    }

    global $current_user;
    $timestamp = get_last_login($current_user->ID, true);
    $formatted = date_i18n('F j, Y \a\t g:i A', $timestamp); // 支持多语言
    return sprintf('Last login: %s', esc_html($formatted));
}
add_shortcode('lastlogin', 'last_login_date');

// 【4】短代码：显示「本次登录时间」
function current_login_date() {
    if (!is_user_logged_in()) {
        return 'Please log in to view your current login.';
    }

    global $current_user;
    $timestamp = get_last_login($current_user->ID, false);
    $formatted = date_i18n('F j, Y \a\t g:i A', $timestamp);
    return sprintf('Current login: %s', esc_html($formatted));
}
add_shortcode('currentlogin', 'current_login_date');

⚠️ 关键注意事项

必须使用 date_i18n() 替代 date()：前者尊重 WordPress 时区设置与本地化，避免服务器时间与站点时区不一致导致的时间偏差；
始终校验用户登录状态：未登录时返回友好提示，防止 global $current_user 为空引发 PHP Notice；
禁止在 shortcode 函数中使用 echo：原答案中 echo 直接输出会导致内容出现在页面顶部（破坏 HTML 结构），正确做法是 return 字符串（WordPress 短代码规范）；
字段命名建议：使用 _last_login 而非 last_login，避免被 export_users() 等工具意外导出，增强隐私合规性；
首次启用后需至少一次真实登录：元字段会在用户首次成功登录后自动创建，无需手动初始化。