RecentlyActive/使用说明.md

Typecho RecentlyActive 插件使用文档 插件信息 插件名称: RecentlyActive

功能: 显示用户最近活跃时间

版本: 1.0.0

兼容性: Typecho 1.x

作者: Your Name

网站: https://yourwebsite.com

功能特点 ✅ 直接读取 Typecho 自带的 activated 字段，无需额外数据库操作 ✅ 支持三种时间显示模式：相对时间、绝对时间、智能模式 ✅ 自动判断在线/离线状态 ✅ 显示状态点（可配置开关） ✅ Tooltip 提示完整时间 ✅ 侧边栏最近活跃用户列表 ✅ 后台全局配置，无需用户单独设置 ✅ 轻量级，不影响性能

安装方法 方法一：手动安装 下载插件压缩包

解压得到 RecentlyActive 文件夹

上传到 Typecho 插件目录：/usr/plugins/

确保路径为：/usr/plugins/RecentlyActive/Plugin.php

登录 Typecho 后台，进入"控制台" → "插件"

找到"用户最近活跃时间显示插件"，点击"启用"

方法二：服务器安装 bash

进入插件目录

cd /path/to/typecho/usr/plugins/

创建插件目录

mkdir RecentlyActive

上传 Plugin.php 到该目录

后台配置 激活插件后，在插件管理页面点击"设置"进行配置：

基本设置 配置项 说明 默认值 时间显示模式 相对时间/绝对时间/智能模式 智能模式 时间格式 绝对时间显示格式（PHP date()格式） Y-m-d H:i 在线状态阈值 多少分钟内显示为"在线"状态（分钟） 10 状态点显示 是否显示在线/离线状态点 开启 默认显示文字 用户从未活跃时显示的文字 从未活跃 配置说明

1. 时间显示模式 相对时间: 显示"3小时前"、"2天前"等

绝对时间: 显示"2023-01-01 12:00"

智能模式: 24小时内用相对时间，更早用绝对时间

2. 时间格式 支持所有 PHP date() 函数格式，常用格式：

Y-m-d H:i → 2023-01-01 12:00

m/d H:i → 01/01 12:00

H:i → 12:00

Y年m月d日 H:i → 2023年01月01日 12:00

3. 在线状态阈值 设置用户多少分钟内活跃算"在线"

例如：设为10，则表示10分钟内活跃的用户显示为在线状态（绿色）

主题调用方法 基本调用 显示文章作者活跃时间 php

<?php if ($this->authorId): ?>

作者: <?php $this->author(); ?> <?php echo RecentlyActive_Plugin::show($this->authorId); ?>

<?php endif; ?> 显示评论者活跃时间 php <?php $this->comments()->to($comments); ?> <?php while($comments->next()): ?>

<?php $comments->author(); ?> <?php echo RecentlyActive_Plugin::show($comments->authorId); ?>

<?php $comments->content(); ?>

<?php endwhile; ?> 安全调用（推荐） php <?php // 安全调用，确保插件存在 if ($this->authorId && class_exists('RecentlyActive_Plugin')) { echo RecentlyActive_Plugin::show($this->authorId); } ?> 侧边栏活跃用户列表 php <?php if (class_exists('RecentlyActive_Plugin')): ?> <?php $activeUsers = RecentlyActive_Plugin::getActiveUsers(5); ?> <?php if ($activeUsers): ?>

最近活跃用户

<?php foreach ($activeUsers as $user): ?>
• <?php echo $user['name']; ?> <?php echo $user['timeText']; ?>
<?php endforeach; ?>

<?php endif; ?> <?php endif; ?> 自定义参数调用 php <?php // 自定义显示选项 echo RecentlyActive_Plugin::show($userId, array( 'display_mode' => 'relative', // 强制使用相对时间 'online_threshold' => 30, // 30分钟内算在线 'show_dot' => 0, // 不显示状态点 'date_format' => 'H:i', // 时间格式：只显示时分 'default_text' => '暂无记录' // 自定义默认文字 )); ?> 参数说明 参数 类型 说明 默认值 display_mode string 显示模式：relative/absolute/smart 插件设置 online_threshold int 在线状态阈值（分钟） 插件设置 show_dot int 是否显示状态点：1显示/0不显示 插件设置 date_format string 绝对时间格式 插件设置 default_text string 默认显示文字 插件设置 CSS 样式定制 插件自带基本样式，如需自定义可覆盖以下 CSS 类：

css /* 活跃时间基础样式 */ .recently-active { font-size: 12px; color: #666; margin-left: 5px; }

/* 在线状态 / .recently-active.online { color: #52c41a; / 绿色 */ }

/* 离线状态 / .recently-active.offline { color: #999; / 灰色 */ }

/* 状态点 */ .recently-active.online:before { content: "● "; font-size: 10px; }

.recently-active.offline:before { content: "○ "; font-size: 10px; }

/* 不显示状态点 */ .recently-active.no-dot:before { content: "" !important; }

/* 工具提示 */ .recently-active-tooltip { cursor: help; border-bottom: 1px dotted #ccc; }

/* 侧边栏活跃用户列表 */ .active-users { list-style: none; padding: 0; margin: 0; }

.active-users li { padding: 8px 0; border-bottom: 1px solid #eee; display: flex; align-items: center; }

.active-users li:last-child { border-bottom: none; }

.active-users img { border-radius: 50%; margin-right: 10px; }

.active-users .user-name { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

.active-users .active-time { font-size: 11px; color: #999; } 显示效果示例

1. 在线状态 text 作者：张三 ● 3分钟前 （绿色文字，带实心圆点）

2. 离线状态 text 作者：李四 ○ 3小时前 （灰色文字，带空心圆点）

3. 智能模式 24小时内：2小时前

24小时外：2023-01-01 12:00

4. Tooltip 提示 鼠标悬停在活跃时间上，显示完整时间：

text 最后活跃: 2023-12-10 14:30:25 常见问题 Q1: 插件激活后没有任何显示？ A: 请检查：

插件是否已激活

主题中是否正确调用 RecentlyActive_Plugin::show()

用户是否有 activated 字段值

查看网页源代码，确认是否有输出

Q2: 显示"从未活跃"是什么情况？ A: 表示该用户的 activated 字段为 0 或空，可能是：

用户从未登录过

Typecho 未更新该字段

用户数据异常

Q3: 如何修改在线状态的颜色？ A: 在主题CSS中添加：

css .recently-active.online { color: #ff0000; /* 改为红色 */ } Q4: 侧边栏头像不显示？ A: Gravatar 可能需要科学上网，可以替换为本地头像：

php // 修改 Plugin.php 中的 getGravatar 方法 private static function getGravatar($email, $size = 40) { // 使用本地默认头像 return Helper::options()->themeUrl . '/images/default-avatar.png'; } Q5: 时间显示不正确？ A: 检查服务器时区设置：

Typecho 后台 → 设置 → 时区

服务器 PHP 时区设置

确保时间戳正确

高级用法 在 functions.php 中添加辅助函数 php // 在主题的 functions.php 中添加 if (!function_exists('showActiveTime')) { /** * 显示用户活跃时间（简化调用） * @param int $userId 用户ID * @param array $options 自定义选项 * @return string */ function showActiveTime($userId = null, $options = array()) { if (class_exists('RecentlyActive_Plugin')) { return RecentlyActive_Plugin::show($userId, $options); } return ''; } }

// 使用 echo showActiveTime($this->authorId); 获取原始活跃时间戳 php

<?php if (class_exists('RecentlyActive_Plugin')) { $activeTime = RecentlyActive_Plugin::getActiveTime($userId); if ($activeTime) { echo '时间戳：' . $activeTime; echo '格式化：' . date('Y-m-d H:i:s', $activeTime); } } ?>

判断用户是否在线 php

<?php if (class_exists('RecentlyActive_Plugin')) { $activeTime = RecentlyActive_Plugin::getActiveTime($userId); $isOnline = false; if ($activeTime) { $diff = time() - $activeTime; $isOnline = ($diff < 600); // 10分钟内 } if ($isOnline) { echo '在线'; } else { echo '离线'; } } ?>

文件结构 text RecentlyActive/ ├── Plugin.php # 插件主文件 ├── README.md # 说明文档（本文件） └── screenshot.png # 插件截图（可选） 更新日志 v1.0.0 (2023-12-10) ✅ 首次发布

✅ 基本活跃时间显示功能

✅ 三种时间显示模式

✅ 在线状态判断

✅ 侧边栏活跃用户列表

✅ 后台配置界面

技术支持 如有问题，可通过以下方式联系：

在插件发布页面留言

访问作者网站

GitHub Issues（如有）

注意事项 本插件依赖 Typecho 的 activated 字段，请确保该字段正常工作

部分主题可能需要调整 CSS 样式以适应显示

建议在正式使用前进行测试

定期备份数据库

许可证 MIT License

祝您使用愉快！ 🎉

文档版本：v1.0.0 最后更新：2023-12-10 作者：Your Name