From bdc98b18441d37440e30db2ef0f9f9873c5b1964 Mon Sep 17 00:00:00 2001
From: XIGE <710062962@qq.com>
Date: Mon, 23 Feb 2026 21:09:17 +0800
Subject: [PATCH] 1.0
---
Plugin.php | 895 +++++++++++++++++++++++++++++++++++++++
assets/who-read-this.css | 282 ++++++++++++
assets/who-read-this.js | 150 +++++++
前端调用.txt | 1 +
4 files changed, 1328 insertions(+)
create mode 100644 Plugin.php
create mode 100644 assets/who-read-this.css
create mode 100644 assets/who-read-this.js
create mode 100644 前端调用.txt
diff --git a/Plugin.php b/Plugin.php
new file mode 100644
index 0000000..c063b76
--- /dev/null
+++ b/Plugin.php
@@ -0,0 +1,895 @@
+getPrefix();
+
+ $table = $prefix . self::$_table;
+ $sql = "CREATE TABLE IF NOT EXISTS `{$table}` (
+ `id` int(11) NOT NULL AUTO_INCREMENT,
+ `cid` int(11) NOT NULL COMMENT '文章ID',
+ `uid` int(11) DEFAULT 0 COMMENT '用户ID',
+ `username` varchar(200) DEFAULT NULL COMMENT '用户名',
+ `email` varchar(200) DEFAULT NULL COMMENT '用户邮箱',
+ `website` varchar(500) DEFAULT NULL COMMENT '用户网站',
+ `avatar` varchar(500) DEFAULT NULL COMMENT '头像URL',
+ `ip` varchar(45) DEFAULT NULL COMMENT 'IP地址',
+ `created` int(10) NOT NULL COMMENT '阅读时间',
+ PRIMARY KEY (`id`),
+ KEY `cid` (`cid`),
+ KEY `uid` (`uid`),
+ KEY `ip` (`ip`)
+ ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;";
+
+ try {
+ $db->query($sql);
+ } catch (Exception $e) {
+ // 表可能已经存在
+ }
+
+ // 挂载文章页
+ Typecho_Plugin::factory('Widget_Archive')->footer = array(__CLASS__, 'trackVisitor');
+
+ return _t('插件已激活，请在后台设置中开启功能');
+ }
+
+ /**
+ * 禁用插件
+ */
+ public static function deactivate()
+ {
+ return _t('插件已禁用');
+ }
+
+ /**
+ * 插件配置方法
+ */
+ public static function config(Typecho_Widget_Helper_Form $form)
+ {
+ // 是否开启功能
+ $enable = new Typecho_Widget_Helper_Form_Element_Radio(
+ 'enable',
+ array('1' => _t('开启'), '0' => _t('关闭')),
+ '1',
+ _t('是否开启功能'),
+ _t('关闭后前端将不会显示谁读了本文')
+ );
+ $form->addInput($enable);
+
+ // 是否屏蔽管理员记录和显示
+ $hideAdmin = new Typecho_Widget_Helper_Form_Element_Radio(
+ 'hide_admin',
+ array(
+ '1' => _t('是（不记录也不显示）'),
+ '0' => _t('否（正常记录和显示）')
+ ),
+ '0',
+ _t('是否屏蔽管理员'),
+ _t('开启后管理员阅读本文不会被记录，也不会在列表中显示')
+ );
+ $form->addInput($hideAdmin);
+
+ // 显示模式
+ $mode = new Typecho_Widget_Helper_Form_Element_Radio(
+ 'mode',
+ array(
+ 'all' => _t('显示所有阅读者'),
+ 'login' => _t('仅显示登录用户'),
+ 'recent' => _t('仅显示近期阅读者（24小时内）')
+ ),
+ 'all',
+ _t('显示模式'),
+ _t('选择要显示的用户类型')
+ );
+ $form->addInput($mode);
+
+ // 显示数量限制
+ $limit = new Typecho_Widget_Helper_Form_Element_Text(
+ 'limit',
+ NULL,
+ '20',
+ _t('最大显示数量'),
+ _t('最多显示多少个阅读者（0表示不限制）')
+ );
+ $limit->input->setAttribute('class', 'mini');
+ $limit->addRule('isInteger', _t('请输入数字'));
+ $form->addInput($limit);
+
+ // IP去重时间（小时）
+ $ip_interval = new Typecho_Widget_Helper_Form_Element_Text(
+ 'ip_interval',
+ NULL,
+ '24',
+ _t('IP去重时间（小时）'),
+ _t('同一IP多少小时内不重复记录')
+ );
+ $ip_interval->input->setAttribute('class', 'mini');
+ $ip_interval->addRule('isInteger', _t('请输入数字'));
+ $form->addInput($ip_interval);
+
+ // 自定义标题
+ $title = new Typecho_Widget_Helper_Form_Element_Text(
+ 'title',
+ NULL,
+ '谁读了本文',
+ _t('显示标题'),
+ _t('前端显示的标题文字')
+ );
+ $form->addInput($title);
+
+ // 展开默认状态
+ $default_open = new Typecho_Widget_Helper_Form_Element_Radio(
+ 'default_open',
+ array('0' => _t('收起'), '1' => _t('展开')),
+ '0',
+ _t('默认状态'),
+ _t('初始显示时是展开还是收起状态')
+ );
+ $form->addInput($default_open);
+
+ // 头像大小
+ $avatar_size = new Typecho_Widget_Helper_Form_Element_Text(
+ 'avatar_size',
+ NULL,
+ '40',
+ _t('头像尺寸（像素）'),
+ _t('头像显示的大小，单位：像素')
+ );
+ $avatar_size->input->setAttribute('class', 'mini');
+ $avatar_size->addRule('isInteger', _t('请输入数字'));
+ $form->addInput($avatar_size);
+ }
+
+ /**
+ * 配置保存处理
+ */
+ public static function configHandle($settings, $isInit)
+ {
+ // 确保所有设置都有值
+ $defaults = array(
+ 'enable' => '1',
+ 'hide_admin' => '0',
+ 'mode' => 'all',
+ 'limit' => '20',
+ 'ip_interval' => '24',
+ 'title' => '谁读了本文',
+ 'default_open' => '0',
+ 'avatar_size' => '40'
+ );
+
+ foreach ($defaults as $key => $value) {
+ if (!isset($settings[$key])) {
+ $settings[$key] = $value;
+ }
+ }
+
+ Helper::configPlugin('WhoReadThis', $settings);
+ }
+
+ /**
+ * 个人用户配置面板
+ */
+ public static function personalConfig(Typecho_Widget_Helper_Form $form) {}
+
+ /**
+ * 追踪访问者并输出资源
+ */
+ public static function trackVisitor()
+ {
+ $archive = Typecho_Widget::widget('Widget_Archive');
+ if (!$archive->is('single')) {
+ return;
+ }
+
+ $options = Helper::options()->plugin('WhoReadThis');
+ if (!$options || $options->enable == '0') {
+ return;
+ }
+
+ $cid = $archive->cid;
+ $ip = self::getClientIP();
+
+ // 检查是否屏蔽管理员
+ $hideAdmin = isset($options->hide_admin) ? $options->hide_admin : '0';
+ $user = Typecho_Widget::widget('Widget_User');
+ $isAdmin = $user->hasLogin() && $user->pass('administrator', true);
+
+ if ($hideAdmin == '1' && $isAdmin) {
+ return; // 如果是管理员且开启屏蔽，则不记录
+ }
+
+ // 检查IP是否在指定时间内已记录
+ $db = Typecho_Db::get();
+ $table = $db->getPrefix() . self::$_table;
+ $ipInterval = isset($options->ip_interval) ? intval($options->ip_interval) : 24;
+
+ $checkSql = $db->select('id')
+ ->from($table)
+ ->where('cid = ?', $cid)
+ ->where('ip = ?', $ip)
+ ->where('created > ?', time() - ($ipInterval * 3600))
+ ->limit(1);
+
+ $check = $db->fetchRow($checkSql);
+
+ if (!$check) {
+ // 获取当前用户信息
+ $uid = $user->hasLogin() ? $user->uid : 0;
+ $username = $user->hasLogin() ? $user->screenName : '访客';
+ $email = $user->hasLogin() ? $user->mail : '';
+ $website = $user->hasLogin() ? $user->url : '';
+
+ // 获取头像
+ $avatar = '';
+ if ($email) {
+ $avatar = 'https://cravatar.cn/avatar/' . md5(strtolower(trim($email))) . '?s=200&d=identicon';
+ } else {
+ // 为访客生成随机头像
+ $avatar = 'https://cravatar.cn/avatar/' . md5($ip) . '?s=200&d=identicon';
+ }
+
+ // 记录阅读者
+ $insert = $db->insert($table)->rows(array(
+ 'cid' => $cid,
+ 'uid' => $uid,
+ 'username' => $username,
+ 'email' => $email,
+ 'website' => $website,
+ 'avatar' => $avatar,
+ 'ip' => $ip,
+ 'created' => time()
+ ));
+
+ $db->query($insert);
+ }
+
+ // 输出资源文件（只输出一次）
+ if (!self::$_assetsOutput) {
+ echo '';
+ echo '';
+
+ echo '';
+
+ self::$_assetsOutput = true;
+ }
+ }
+
+ /**
+ * 前端调用函数
+ */
+ public static function show()
+ {
+ $archive = Typecho_Widget::widget('Widget_Archive');
+ if (!$archive->is('single')) {
+ return '';
+ }
+
+ $options = Helper::options()->plugin('WhoReadThis');
+ if (!$options || $options->enable == '0') {
+ return '';
+ }
+
+ $cid = $archive->cid;
+ $db = Typecho_Db::get();
+ $table = $db->getPrefix() . self::$_table;
+
+ // 构建查询
+ $select = $db->select()->from($table)->where('cid = ?', $cid);
+
+ // 如果开启了屏蔽管理员，排除管理员记录
+ $hideAdmin = isset($options->hide_admin) ? $options->hide_admin : '0';
+ if ($hideAdmin == '1') {
+ // 获取所有管理员ID
+ $adminUsers = $db->fetchAll($db->select('uid')->from('table.users')->where('group = ?', 'administrator'));
+ if ($adminUsers) {
+ $adminIds = array_column($adminUsers, 'uid');
+ if (!empty($adminIds)) {
+ $select->where('uid NOT IN ?', $adminIds);
+ }
+ }
+ }
+
+ $mode = isset($options->mode) ? $options->mode : 'all';
+ switch ($mode) {
+ case 'login':
+ $select->where('uid > 0');
+ break;
+ case 'recent':
+ $select->where('created > ?', time() - 86400); // 24小时内
+ break;
+ }
+
+ $select->order('id', Typecho_Db::SORT_DESC);
+
+ $limit = isset($options->limit) ? intval($options->limit) : 20;
+ if ($limit > 0) {
+ $select->limit($limit);
+ }
+
+ try {
+ $readers = $db->fetchAll($select);
+ } catch (Exception $e) {
+ return '';
+ }
+
+ // 如果没有阅读者数据，返回空字符串（不显示任何内容）
+ if (empty($readers)) {
+ return '';
+ }
+
+ $usersHtml = '';
+ $uniqueReaders = array();
+
+ foreach ($readers as $reader) {
+ // 去重，同个用户只显示一次
+ $key = $reader['uid'] ?: $reader['ip'];
+ if (isset($uniqueReaders[$key])) {
+ continue;
+ }
+ $uniqueReaders[$key] = true;
+
+ $avatar = $reader['avatar'] ?: 'https://cravatar.cn/avatar/0?s=200&d=identicon';
+ $username = htmlspecialchars($reader['username']);
+ $link = !empty($reader['website']) ? $reader['website'] : '#';
+
+ $usersHtml .= '
+
+
+
 . ')
+