文章	评论	标签
30	65	8

微语 (Weiyu) - Typecho 插件

一个类似微信朋友圈的轻量级动态/说说插件，支持文字、图片、音乐、视频等多种内容形式。

版本说明

本插件提供两个版本，请根据你的主题特性选择：

版本	文件名	适用场景	登录方式
Weiyu	`weiyu.zip`	主题自带前台登录（如易航主题）	依赖主题登录态
WeiyuPlus	`weiyuplus.zip`	主题无前台登录 / 所有主题通用

如果你使用的主题没有前台登录功能，请直接选择 WeiyuPlus 版本，通过独立路由独立页面模板访问，100% 兼容任何主题。

功能特性

✅ 发布文字动态
✅ 多图上传（1-9 张，自动网格布局）
✅ 音乐分享（封面 + 歌名 + 歌手 + 播放）
✅ 视频分享（在线播放）
✅ 点赞功能（显示点赞列表）
✅ 评论功能（支持二级回复）
✅ 游客发帖（可配置）
✅ 管理员审核（非管理员发布需审核）
✅ 支持 MP4 格式视频作为顶图
✅ 两种播放模式：点击播放 / 进入/刷新自动播放
✅ 播放结束显示：第一帧 / 最后一帧
✅ 移动端适配（静音内联播放）
✅ WeiyuPlus
✅ 以上功能都有
✅ 独立页面模板（WeiyuPlus 自动复制到主题目录）
✅ 卸载自动清理（删除主题目录模板文件及数据表）
✅ 后台配置主题布局（适配 header/footer 不同目录结构）

兼容性

环境	要求
Typecho	≥ 1.2.0，推荐 1.3.0
PHP	7.4 - 8.4
MySQL	≥ 5.7
浏览器	现代浏览器（Chrome / Firefox / Safari / Edge）

安装方法

1. 上传插件

根据你的主题情况选择版本：

weiyu.zip → 解压后文件夹重命名为 Weiyu，上传至 usr/plugins/
weiyuplus.zip → 解压后文件夹重命名为 WeiyuPlus，上传至 usr/plugins/

2. 激活插件

Typecho 后台 → 控制台 → 插件 → 启用「微语 / 微语Plus」

3. 配置插件

点击「设置」，配置以下选项：

配置项	说明	默认值
顶图链接	页面顶部背景图 URL	默认图片
顶图视频链接	顶图视频 URL（MP4）	空
视频播放模式	点击播放 / 刷新页面播放一次	点击播放
播放结束后显示	第一帧 / 最后一帧	第一帧
允许游客发帖	是 / 否	是

WeiyuPlus 额外配置（主题布局）

配置项	说明	示例值
头部文件目录	header.php 所在目录，相对于主题根目录	留空（根目录）、`partials`、`templates`
尾部文件目录	footer.php 所在目录，相对于主题根目录	留空（根目录）、`partials`、`templates`
页面布局模式	是否使用主题布局	`使用主题布局` / `独立页面`

WeiyuPlus 启用时会自动将 page-weiyu.php 复制到当前主题目录；禁用/卸载时会自动清理。

使用方式

Weiyu 版本（短代码模式）

适合主题自带前台登录的场景（如易航主题）。

新建独立页面，内容里写：

[weiyu]

保存即可。

体验地址： https://bbs.linyu.live/weiyu.html

体验地址： https://bbs.linyu.live/weiyu

⚠️ 兼容性说明： 此方式依赖主题前台登录态。若主题无前台登录，短代码模式下可能无法正确识别登录状态，导致点击"发帖/点赞/评论"无反应。
或者直接用独立路由访问。

WeiyuPlus 版本（独立路由模式）

所有主题通用，不依赖任何主题登录功能。

新建独立页面，下方选择模板：

微语页面模板

保存即可。

体验地址： https://linyu.live/97.html

插件自带游客登录系统（昵称 + 邮箱），任何主题均可直接使用。

发帖

点击右上角「发帖」按钮
输入文字内容
可选：添加图片 / 音乐 / 视频
点击「发表」

添加图片

点击「图片」按钮
每行输入一个图片 URL
支持 1-9 张图片（WeiyuPlus 限制为 1-4 张）

添加音乐

点击「音乐」按钮
填写：封面、歌名、歌手、MP3 链接

添加视频

点击「视频」按钮
填写：MP4 链接、封面（可选）

顶图视频配置示例

示例 1：点击播放

顶图视频链接：https://example.com/intro.mp4
视频播放模式：点击播放
播放结束后显示：第一帧

示例 2：自动播放

顶图视频链接：https://example.com/banner.mp4
视频播放模式：刷新页面播放一次
播放结束后显示：最后一帧

视频要求

格式：MP4
大小：建议 < 5MB
比例：建议 16:9 或更宽
编码：H.264 + AAC

后台管理

后台侧边栏 → 微语管理

审核 / 删除微语
管理评论
顶图在「插件设置」里配置

文件结构

Weiyu 版本

Weiyu/
├── Plugin.php        # 主插件
├── Action.php        # API 接口
├── Page.php          # 独立路由入口
├── page-weiyu.php    # 独立页面模板
├── widget-weiyu.php  # 前端渲染
├── admin.php         # 后台管理
└── README.md         # 本文件

WeiyuPlus 版本

WeiyuPlus/
├── Plugin.php
├── Page.php
├── Action.php
├── page-weiyu.php    # 启用时自动复制到主题目录
├── widget-weiyu.php
├── admin.php
├── static/
│   ├── style.css     # 前端样式
│   ├── script.js     # 前端脚本
│   └── img/
│       └── logo.png  # 默认头像
└── README.md

主题目录结构适配（WeiyuPlus）

标准结构（header/footer 在根目录）

主题目录/
├── header.php      ← 头部文件目录：留空
├── footer.php      ← 尾部文件目录：留空
└── page-weiyu.php  ← 插件自动复制

partials 结构

主题目录/
├── partials/
│   ├── header.php  ← 头部文件目录：partials
│   └── footer.php  ← 尾部文件目录：partials
└── page-weiyu.php

templates 结构

主题目录/
├── templates/
│   ├── header.php  ← 头部文件目录：templates
│   └── footer.php  ← 尾部文件目录：templates
└── page-weiyu.php

数据库表结构

插件激活后自动创建以下数据表：

表名	说明
`typecho_weiyu_posts`	微语内容表
`typecho_weiyu_comments`	评论表
`typecho_weiyu_likes`	点赞表

卸载插件时（WeiyuPlus）会自动删除主题目录中的 page-weiyu.php 及上述数据表。

常见问题

Q: 短代码不生效？

A: 确保主题调用了 contentEx 钩子，或检查主题是否过滤了短代码。建议改用 WeiyuPlus 独立路由方式。

Q: 游客无法发帖？

A: 检查后台是否开启「允许游客发帖」，并确保已填写昵称和邮箱。

Q: 发布后不显示？

A: 非管理员发布需要管理员在后台审核通过后才会显示。

Q: 头像点击不灵 / 布局错乱？

A: 检查是否为缓存问题，尝试清除浏览器缓存或修改 CSS/JS 链接版本号。有问题可在评论区反馈或者自己修改。

更新日志

v1.2.0 (WeiyuPlus)

🔧 移除短代码功能，改为独立路由 + 独立页面模板双模式
🔧 禁用/卸载时自动清理主题目录模板文件
🔧 后台支持配置主题 header/footer 目录路径
🔧 CSS/JS 分离至 static 目录，结构更清晰
🔧 适配 PHP 7.4 - 8.4 及 Typecho 1.3.0

v1.0.0

🎬 新增顶图视频功能
🎮 支持点击播放 / 刷新播放两种模式
🖼️ 支持播放结束后显示第一帧 / 最后一帧
🔧 优化登录兼容性
🐛 修复头像可点击问题
🎉 初始版本发布

技术栈

后端: PHP + Typecho 框架
前端: 原生 JavaScript + CSS3
数据库: MySQL / SQLite
API: JSON RESTful

许可证

MIT License

链接

博客：https://linyu.live
体验（短代码）：https://bbs.linyu.live/weiyu.html
体验（独立路由）：https://bbs.linyu.live/weiyu
下载：
此处内容需要评论回复后方可阅读

作者: Lin.
版本: 1.2.0 / 1.0.0
更新日期: 2026-05-26