WP微语插件

一款轻量化的 WordPress 个人微语/碎碎念发布插件，支持后台独立发布微语，前台专属页面优雅展示所有微语内容。

✨ 功能特点

• 📝 独立微语管理：后台独立菜单管理微语，支持新增、编辑、删除、批量管理
• 🎨 优雅展示：简约清新的卡片式设计，支持深色/浅色主题兼容
• 📱 响应式适配：完美适配电脑、平板、手机所有设备
• ⚡ AJAX分页：动态加载分页，无需刷新页面
• 📊 浏览统计：实时统计页面浏览人数
• 🔒 安全可靠：严格遵循 WordPress 安全开发规范
• 📁 独立数据：使用独立自定义数据表，不影响 WordPress 核心数据

🚀 安装步骤

方法一：手动安装

1. 下载插件压缩包
2. 登录 WordPress 后台 → 插件 → 安装插件 → 上传插件
3. 选择下载的压缩包上传
4. 点击 启用插件

方法二：FTP安装

1. 将 wp-weiyu-plugin 文件夹上传到 /wp-content/plugins/ 目录
2. 登录 WordPress 后台 → 插件
3. 找到「WP微语插件」并点击 启用

📖 使用方法

发布微语

1. 后台左侧菜单点击 微语管理
2. 点击 发布新微语 按钮
3. 输入微语内容（支持文字、表情、换行）
4. 设置发布时间（可选）
5. 点击 发布微语

创建前台页面

1. 后台 → 页面 → 新建页面
2. 输入页面标题（如「微语」）
3. 在右侧「页面属性」→「模板」中选择「微语页面」
4. 点击 发布
5. 访问该页面即可查看所有微语

自定义设置

1. 后台 → 微语管理 → 设置
2. 可自定义页面标题和副标题

📁 文件结构

wp-weiyu-plugin/
├── wp-weiyu-plugin.php    # 插件主文件（核心逻辑）
├── page-weiyu.php         # 前台页面模板
├── weiyu-style.css        # CSS样式文件
└── weiyu-script.js        # JavaScript动态分页脚本

🛠️ 技术栈

• PHP 7.4+
• WordPress 5.8+
• JavaScript (AJAX)
• CSS3 (响应式、动画)

🎨 自定义修改

颜色修改（weiyu-style.css）

/* 主色调 */
.weiyu-pagination a:hover,
.weiyu-pagination span.current {
    background: #409eff;  /* 可修改为其他颜色 */
}

尺寸修改（weiyu-style.css）

/* 卡片圆角 */
.weiyu-card {
    border-radius: 16px;  /* 可修改圆角大小 */
}

/* 容器宽度 */
.weiyu-container {
    max-width: 720px;  /* 可修改最大宽度 */
}

分页数量（page-weiyu.php）

$per_page = 6;  // 每页显示6条，可修改

🔒 安全特性

• ✅ SQL注入防护：所有数据库操作使用参数化查询
• ✅ CSRF防护：所有表单提交有 nonce 验证
• ✅ XSS防护：使用 esc_html()、esc_attr() 等输出转义
• ✅ 权限控制：仅管理员可发布、管理微语
• ✅ 输入过滤：使用 sanitize_textarea_field() 过滤内容

📊 数据库结构

插件使用独立自定义数据表 wp_weiyu_posts：

📝 更新日志

v1.3 (2026-08-03)

• ✨ 新增位置功能：发布微语时可手动输入地点，前台卡片展示地点信息
• ✨ 新增图片功能：前台和后台发布微语时均可插入多张图片（最多9张），使用 WordPress 媒体库
• ✨ 前台发布微语支持自定义发布时间
• ✨ 新增管理员前台卡片操作菜单（右上角三点）：可直接编辑或删除微语，编辑时可修改内容/时间/地点/图片
• ✨ 新增图片灯箱（lightbox）放大查看
• ✨ 修复后台单条删除报错问题（删除链接参数冲突）
• ✨ 数据库新增 location、images 字段，版本化自动迁移，不丢失旧数据
• ✨ 完善深色主题与移动端响应式适配

v1.2 (2024-07-15)

• ✨ 修复后台删除微语后页面白屏问题
• ✨ 添加删除成功提示消息
• ✨ 添加内容为空时的错误提示
• ✨ 修复后台操作后的提示消息问题

v1.1 (2024-07-14)

• ✨ 新增前台发布微语功能（管理员登录后可见）
• ✨ 所有前台"微语"字段均改为自定义，可在设置中配置页面标题
• ✨ 优化前台发布表单样式
• ✨ 修复前台发布 nonce 验证问题
• ✨ 修复分页显示不一致问题

v1.0.0 (2024-07-14)

• ✨ 初始版本
• ✨ 后台微语管理（新增、编辑、删除、批量管理）
• ✨ 前台微语页面展示
• ✨ AJAX动态分页
• ✨ 深色/浅色主题兼容
• ✨ 浏览统计功能
• ✨ 响应式设计

📄 许可证

MIT License

👨‍💻 作者

Tinsur

• 博客：https://tinsur.cn
• GitHub：https://github.com/Tinsur2005

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📧 联系方式

如有问题或建议，欢迎通过以下方式联系：

• 邮箱：tinsur@tinsur.cn
• 博客：https://tinsur.cn