Files
friend-links-manager/README.md
2025-11-22 09:39:29 +08:00

151 lines
4.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 友情链接管理器 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 许可证发布。
---
**提示**:建议定期导出链接数据进行备份,以防意外数据丢失。