# 友情链接管理器 WordPress插件

一个功能强大且易于使用的WordPress友情链接管理插件，支持链接描述、批量操作、导入导出等功能。

## 🌟 主要功能

### 📝 链接管理
- **添加链接**：支持网站名称、URL、图标、描述信息
- **编辑链接**：在线编辑所有链接信息
- **删除链接**：单个删除或批量删除
- **拖拽排序**：直观的拖拽排序，自动保存

### 🎨 显示设置
- **布局控制**：自定义电脑端每行显示链接数（2-6个）
- **显示模式**：随机显示或按顺序显示
- **描述控制**：可选择是否在前台显示链接描述

### 📊 数据管理
- **CSV导出**：导出所有链接数据为CSV文件
- **CSV导入**：批量导入链接数据，支持描述字段
- **数据备份**：定期导出备份链接数据

### 🛡️ 安全特性
- **权限控制**：仅管理员可访问管理界面
- **数据验证**：严格的输入验证和安全检查
- **数据库保护**：安全的数据操作和错误处理

## 📦 安装方法

### 方法一：WordPress后台安装
1. 登录WordPress管理后台
2. 进入"插件" → "安装插件"
3. 上传本插件ZIP压缩包
4. 点击"安装"然后"启用"

### 方法二：手动安装
1. 下载插件压缩包
2. 解压到 `wp-content/plugins/` 目录
3. 在WordPress后台启用插件

## 🚀 使用方法

### 1. 添加友情链接
1. 进入WordPress后台 → "友情链接"
2. 在"添加新链接"区域填写信息：
   - **网站名称**：必填，显示的链接标题
   - **网站URL**：必填，完整的网站地址
   - **自动获取头像**：勾选可自动获取网站favicon
   - **网站图标URL**：可选，手动指定图标地址
   - **链接描述**：可选，一句话描述该网站
3. 点击"添加链接"

### 2. 管理现有链接
1. 在"链接列表"中查看所有链接
2. 直接在列表中编辑链接信息
3. 拖拽链接调整显示顺序
4. 勾选链接可进行批量删除
5. 点击"保存更改"保存所有修改

### 3. 配置显示设置
1. 在"显示设置"区域配置：
   - **电脑端每行显示链接数**：选择2-6个
   - **随机显示友情链接**：开启后随机显示，关闭后按排序显示
   - **显示链接描述**：控制是否在前台显示描述
2. 点击"保存设置"

### 4. 在页面中显示友情链接
使用短代码在任意页面或文章中显示友情链接：

```html
[friend_links]
```

### 5. 导入导出数据

#### 导出链接
1. 点击"导出为CSV"按钮
2. 下载包含所有链接数据的CSV文件
3. 文件包含四列：网站名称、网站URL、图标URL、链接描述

#### 导入链接
1. 准备CSV文件，格式如下：
   ```
   网站名称,网站URL,图标URL,链接描述
   示例网站,https://example.com,https://example.com/icon.png,这是一个示例网站
   ```
2. 在"导入链接"区域选择CSV文件
3. 点击"导入链接"
4. 系统会自动处理并显示导入结果

## 🔧 高级功能

### 数据库修复
如果遇到保存功能异常，可使用数据库修复功能：
1. 在管理页面顶部找到"数据库修复"提示
2. 点击"点击修复数据库表结构"按钮
3. 系统会自动检查并修复数据库结构

### 批量操作
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 许可证发布。

---

**提示**：建议定期导出链接数据进行备份，以防意外数据丢失。