更新到1.2.2版本

README.md

@@ -1,54 +1,151 @@
-# Friend Links Manager: 一款简洁、美观的 WordPress 友情链接插件
+# 友情链接管理器 WordPress插件
 
-近日，我开发了一款全新 WordPress 友情链接插件。该插件简洁、美观、易于使用。
+一个功能强大且易于使用的WordPress友情链接管理插件，支持链接描述、批量操作、导入导出等功能。
 
-可以访问以下链接查看实际展示效果：[友情链接展示页](https://lhcy.org/friendlinks.html)
+## 🌟 主要功能
 
-## 插件特性
+### 📝 链接管理
+- **添加链接**：支持网站名称、URL、图标、描述信息
+- **编辑链接**：在线编辑所有链接信息
+- **删除链接**：单个删除或批量删除
+- **拖拽排序**：直观的拖拽排序，自动保存
 
-- **响应式布局**：在桌面端默认每行展示 3 个链接，并能根据屏幕尺寸自动调整，在平板和手机上也能完美呈现。
-- **信息展示丰富**：每个链接均会展示对方网站的 Favicon（头像）和博客名称，一目了然。
-- **灵活的排序方式**：支持固定排序和随机排序两种模式。设置为随机排序后，每次刷新页面都会带来全新的链接顺序。
-- **智能头像获取**：自动通过 `favicon.im` 服务抓取网站头像。同时支持手动指定头像链接，或在留空时显示默认头像。
-- **简洁的管理后台**：后台管理界面操作直观，美观大方。
-- **纯净无残留**：启用时自动创建专属数据表，禁用时彻底删除，不在数据库留下任何冗余数据。
-- **数据轻松迁移**：内置导入/导出功能，方便备份和恢复友链数据。
+### 🎨 显示设置
+- **布局控制**：自定义电脑端每行显示链接数（2-6个）
+- **显示模式**：随机显示或按顺序显示
+- **描述控制**：可选择是否在前台显示链接描述
 
-## 使用方法
+### 📊 数据管理
+- **CSV导出**：导出所有链接数据为CSV文件
+- **CSV导入**：批量导入链接数据，支持描述字段
+- **数据备份**：定期导出备份链接数据
 
-**1. 下载与安装**
+### 🛡️ 安全特性
+- **权限控制**：仅管理员可访问管理界面
+- **数据验证**：严格的输入验证和安全检查
+- **数据库保护**：安全的数据操作和错误处理
 
-下载 `.zip` 压缩包后，在 WordPress 后台的“插件”—>“安装插件”页面上传并启用。
+## 📦 安装方法
 
-**2. 插入短代码 (Shortcode)**
+### 方法一：WordPress后台安装
+1. 登录WordPress管理后台
+2. 进入"插件" → "安装插件"
+3. 搜索"友情链接管理器"
+4. 点击"安装"然后"启用"
 
-在任意页面或文章中插入短代码即可展示友情链接。
+### 方法二：手动安装
+1. 下载插件压缩包
+2. 解压到 `wp-content/plugins/` 目录
+3. 在WordPress后台启用插件
 
-- 默认排序：
+## 🚀 使用方法
 
-  ```
-  [friend_links]
-  ```
+### 1. 添加友情链接
+1. 进入WordPress后台 → "友情链接"
+2. 在"添加新链接"区域填写信息：
+   - **网站名称**：必填，显示的链接标题
+   - **网站URL**：必填，完整的网站地址
+   - **自动获取头像**：勾选可自动获取网站favicon
+   - **网站图标URL**：可选，手动指定图标地址
+   - **链接描述**：可选，一句话描述该网站
+3. 点击"添加链接"
 
-- 随机排序（每次刷新页面重新排序）：
+### 2. 管理现有链接
+1. 在"链接列表"中查看所有链接
+2. 直接在列表中编辑链接信息
+3. 拖拽链接调整显示顺序
+4. 勾选链接可进行批量删除
+5. 点击"保存更改"保存所有修改
 
-  ```
-  [friend_links random="true"]
-  ```
+### 3. 配置显示设置
+1. 在"显示设置"区域配置：
+   - **电脑端每行显示链接数**：选择2-6个
+   - **随机显示友情链接**：开启后随机显示，关闭后按排序显示
+   - **显示链接描述**：控制是否在前台显示描述
+2. 点击"保存设置"
 
-**如何在编辑器中插入？**
+### 4. 在页面中显示友情链接
+使用短代码在任意页面或文章中显示友情链接：
 
-- **Gutenberg （区块编辑器）**：添加“自定义 HTML”区块，将短代码粘贴进去即可。
-- **Classic Editor （经典编辑器）**：直接在文本编辑模式下粘贴短代码。
+```html
+[friend_links]
+```
 
-## 未来计划
+### 5. 导入导出数据
 
-计划将此插件移植到 Typecho 平台。
+#### 导出链接
+1. 点击"导出为CSV"按钮
+2. 下载包含所有链接数据的CSV文件
+3. 文件包含四列：网站名称、网站URL、图标URL、链接描述
 
-## 致谢
+#### 导入链接
+1. 准备CSV文件，格式如下：
+   ```
+   网站名称,网站URL,图标URL,链接描述
+   示例网站,https://example.com,https://example.com/icon.png,这是一个示例网站
+   ```
+2. 在"导入链接"区域选择CSV文件
+3. 点击"导入链接"
+4. 系统会自动处理并显示导入结果
 
-在插件的开发过程中，AI 提供了巨大帮助，特此感谢科技的力量。
+## 🔧 高级功能
 
-经过两天的密集调试，目前插件运行稳定，暂未发现明显 Bug。欢迎提出宝贵的意见和建议，或是一同参与改进，让它在保持简洁、美观、易于使用的同时可以变得更好。
+### 数据库修复
+如果遇到保存功能异常，可使用数据库修复功能：
+1. 在管理页面顶部找到"数据库修复"提示
+2. 点击"点击修复数据库表结构"按钮
+3. 系统会自动检查并修复数据库结构
 
-[我的博客链接](https://lhcy.org)，欢迎访问并留言。
+### 批量操作
+1. 在链接列表中勾选多个链接
+2. 点击"批量删除"按钮
+3. 确认删除操作
+
+## 📋 CSV文件格式
+
+### 导出格式
+导出的CSV文件包含以下四列：
+- **网站名称**：链接显示的标题
+- **网站URL**：完整的网站地址
+- **图标URL**：网站图标地址（可选）
+- **链接描述**：网站描述信息（可选）
+
+### 导入格式
+导入CSV文件时：
+- 前两列（网站名称、网站URL）为必填
+- 后两列（图标URL、链接描述）为可选
+- 支持从旧版本三列格式升级
+
+## 🎨 前端显示效果
+
+友情链接在前台以卡片形式显示：
+- 网站图标
+- 网站名称
+- 链接描述（如果启用）
+- 响应式布局，适配各种屏幕尺寸
+
+## 🔒 安全说明
+
+- 插件仅在管理员权限下运行
+- 所有用户输入都经过严格验证和清理
+- 使用WordPress标准的安全机制
+- 不会收集或传输任何用户数据
+
+## 📞 技术支持
+
+- **作者网站**：https://lhcy.org
+- **插件版本**：1.2.2
+- **WordPress要求**：5.0+
+- **PHP要求**：7.0+
+
+## 🔄 更新日志
+
+查看 `CHANGELOG.md` 了解详细的版本更新信息。
+
+## 📄 许可证
+
+本插件采用 GPL v2.0 许可证发布。
+
+---
+
+**提示**：建议定期导出链接数据进行备份，以防意外数据丢失。