# WordPress微语插件

**Repository Path**: tinsur/WP-microtalk-plugin

## Basic Information

- **Project Name**: WordPress微语插件
- **Description**: 一款发布和管理微语的WP插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: WordPress

## README

# 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）

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

### 尺寸修改（weiyu-style.css）

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

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

### 分页数量（page-weiyu.php）

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

## 🔒 安全特性

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

## 📊 数据库结构

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

| 字段 | 类型 | 说明 |
|------|------|------|
| id | mediumint(9) | 主键，自增 |
| content | text | 微语内容 |
| location | varchar(255) | 地点名称 |
| images | text | 图片附件ID的JSON数组 |
| created_at | datetime | 创建时间 |
| modified_at | datetime | 修改时间 |

## 📝 更新日志

### 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