---
canonical: https://meta.cyberforums.com/t/wordpress/2448
webpage: https://wpcy.com/community/t/2448-wordpress
language: zh-Hans
---

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

> 文派叶子支持论坛的只读副本，本页不能回复。
> 讨论原文：https://meta.cyberforums.com/t/wordpress/2448
> 网页版：https://wpcy.com/community/t/2448-wordpress

## 1 · 诗语

- 发布时间：2026年2月4日 03:30

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

查看统计数据

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

重置统计
如需清空所有统计数据：

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

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: 检查以下几点：

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

Q: 统计数据不显示？
A: 可能原因：

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

Q: 如何迁移统计数据？
A: 导出 wp_options 表中 discourse_shortlink_stats 记录即可。
版本历史

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


插件作者：WPCommunity

开源协议：MIT

项目地址：内部使用
