[诗语]

WordPress 文派社区短链接插件使用指南

插件概述

Discourse Short Links 是一个 WordPress Must-Use 插件，为文派社区提供简洁、易记的短链接服务。通过这个插件，您可以使用 wpcy.com/t/123 这样的短链接快速访问社区内容，并获得详细的访问统计数据。

功能特点

短链接重定向

支持 6 种内容类型的短链接：

短链格式	目标内容	示例
/t/123	话题	wpcy.com/t/456 → 话题 #456
/c/slug	分类	wpcy.com/c/plugins → 插件分类
/u/user	用户	wpcy.com/u/admin → 用户主页
/p/123	帖子	wpcy.com/p/789 → 具体楼层
/g/name	群组	wpcy.com/g/staff → Staff 群组
/h/tag	标签	wpcy.com/h/wordpress → WordPress 标签

访问统计

• 实时统计：每次短链访问都会被记录
• 多维度分析：
  • 今日/昨日/近 7 天/累计访问量
  • 按类型分布 （话题、分类、用户等）
  • 热门链接排行 （Top 10）
• 自动清理：保留最近 30 天数据

仪表盘小工具

在 WordPress 仪表盘首页直接查看统计概况，无需进入设置页面。

安装方式

1. 上传到 MU-Plugins 目录

# 将插件文件放入 mu-plugins 目录
/wp-content/mu-plugins/discourse-shortlinks.php

注意：MU-Plugins（Must-Use Plugins） 会自动激活，无需手动启用。

2. 配置 （可选）

在 wp-config.php 中添加自定义配置：

// Discourse 站点地址 （默认：https://wpcommunity.com）
define('DISCOURSE_SHORTLINK_URL', 'https://your-discourse.com');

// 是否启用统计 （默认：true）
define('DISCOURSE_SHORTLINK_STATS', true);

使用方法

访问短链接

直接在浏览器中输入短链接即可自动跳转：

https://wpcy.com/t/123

浏览器会自动 301 重定向到：

https://wpcommunity.com/t/-/123

查看统计数据

1. 登录 WordPress 后台
2. 在仪表盘首页找到 「短链统计」 小工具
3. 查看各项数据

重置统计

如需清空所有统计数据：

1. 在 「短链统计」 小工具中点击 「重置」 按钮
2. 确认操作
3. 所有历史数据将被清除

API 接口

插件提供 REST API 接口，方便程序化访问：

获取统计数据

GET /wp-json/discourse/v1/shortlink-stats
Authorization: 需要管理员权限

响应示例：

{
  "total": 1234,
  "today": 56,
  "yesterday": 78,
  "week": 345,
  "by_type": {
    "topic": 800,
    "category": 200,
    "user": 150,
    "post": 50,
    "group": 20,
    "tag": 14
  },
  "top_links": {
    "topic:123": 100,
    "topic:456": 80,
    "category:plugins": 45
  }
}

重置统计

POST /wp-json/discourse/v1/shortlink-reset
Authorization: 需要管理员权限

数据存储

统计数据存储在 WordPress 数据库 wp_options 表中：

• 字段名：discourse_shortlink_stats
• 数据格式：序列化 PHP 数组
• 自动清理：超过 30 天的数据自动删除

技术规格

项目	说明
插件类型	MU-Plugin（必用插件）
PHP 版本	8.0+
WordPress 版本	6.0+
重定向类型	301 永久重定向
执行优先级	init hook, priority 1

常见问题

Q: 短链接不跳转？

A: 检查以下几点：

1. 确认插件文件在 mu-plugins 目录
2. 确认 URL 格式正确 （如 /t/数字）
3. 检查 DISCOURSE_SHORTLINK_URL 配置

Q: 统计数据不显示？

A: 可能原因：

1. 还没有人访问过短链接
2. 浏览器缓存导致仪表盘未刷新
3. 尝试使用 REST API 验证数据

Q: 如何迁移统计数据？

A: 导出 wp_options 表中 discourse_shortlink_stats 记录即可。

版本历史

• v1.1.0 – 添加标签 （/h/） 和群组 （/g/） 支持
• v1.0.0 – 初始版本，支持话题、分类、用户、帖子

---

插件作者：WPCommunity
开源协议：MIT
项目地址：内部使用

[作者]

帖子