Mud Download Button Plugin 安装指南

本指南将详细介绍如何安装和配置 Mud Download Button Plugin，确保您能够快速上手使用。

 📋 安装前准备

### 系统要求检查

在安装插件之前，请确保您的系统满足以下要求：

| 项目 | 最低要求 | 推荐配置 |
|——|———-|———-|
| WordPress版本 | 3.0+ | 6.0+ |
| PHP版本 | 5.6+ | 8.0+ |
| MySQL版本 | 5.0+ | 8.0+ |
| 内存限制 | 64MB | 256MB+ |
| 磁盘空间 | 5MB | 10MB+ |

### 浏览器兼容性

| 浏览器 | 最低版本 | 状态 |
|——–|———-|——|
| Chrome | 60+ | ✅ 完全支持 |
| Firefox | 55+ | ✅ 完全支持 |
| Safari | 12+ | ✅ 完全支持 |
| Edge | 79+ | ✅ 完全支持 |
| IE | – | ❌ 不支持 |

 🚀 安装方法

### 方法一：WordPress后台安装（推荐）

这是最简单、最安全的安装方法：

#### 步骤1：下载插件
1. 从官方渠道下载 `mud-download-button-plugin.zip` 文件
2. 确保文件完整，没有损坏

#### 步骤2：上传安装
1. 登录WordPress管理后台
2. 进入 **插件** → **安装插件**
3. 点击 **上传插件** 按钮
4. 选择下载的ZIP文件
5. 点击 **现在安装**

步骤3：激活插件
1. 安装完成后，点击 **激活插件**
2. 或者进入 **插件** → **已安装的插件**
3. 找到 “Mud Download Button Plugin”
4. 点击 **启用**

### 方法二：FTP手动安装

适合有FTP访问权限的高级用户：

#### 步骤1：解压文件
1. 将下载的ZIP文件解压到本地
2. 确保文件夹名称为 `mud-download-button-plugin`

#### 步骤2：上传文件
1. 使用FTP客户端连接到您的网站服务器
2. 导航到 `/wp-content/plugins/` 目录
3. 将整个 `mud-download-button-plugin` 文件夹上传到此目录

步骤3：激活插件
1. 登录WordPress管理后台
2. 进入 **插件** → **已安装的插件**
3. 找到 “Mud Download Button Plugin”
4. 点击 **启用**

### 方法三：cPanel文件管理器安装

适合使用cPanel主机的用户：

#### 步骤1：访问文件管理器
1. 登录cPanel控制面板
2. 找到并点击 **文件管理器**
3. 导航到 `public_html/wp-content/plugins/` 目录

#### 步骤2：上传并解压
1. 点击 **上传** 按钮
2. 选择插件ZIP文件并上传
3. 上传完成后，选择ZIP文件
4. 点击 **解压缩** 按钮

步骤3：激活插件
1. 返回WordPress管理后台
2. 进入 **插件** → **已安装的插件**
3. 激活 “Mud Download Button Plugin”

 ✅ 安装验证

### 检查插件状态

安装完成后，请按以下步骤验证安装是否成功：

1. 插件列表检查
– 进入 **插件** → **已安装的插件**
– 确认看到 “Mud Download Button Plugin”
– 状态显示为 “已启用”

2. 编辑器集成检查
– 新建或编辑一篇文章/页面
– 确保使用经典编辑器
– 在工具栏中查找 “⬇Mud下载” 按钮

3. 功能测试
– 点击 “⬇Mud下载” 按钮
– 确认弹出配置对话框
– 测试插入短代码功能

文件结构验证

正确安装后，插件目录结构应该如下：

“`
/wp-content/plugins/mud-download-button-plugin/
├── download-button-plugin.php # 主插件文件
├── README.md # 说明文档
├── INSTALL.md # 安装指南
├── assets/ # 资源文件夹
│ ├── css/
│ │ ├── style.css # 前端样式
│ │ └── admin.css # 管理员样式
│ └── js/
│ ├── script.js # 前端脚本
│ ├── admin.js # 管理员脚本
│ └── tinymce-plugin.js # TinyMCE插件
└── debug.php # 调试工具
“`

 🔧 配置设置

### 基本配置

插件安装后无需额外配置即可使用，但您可以根据需要进行以下调整：

1. 编辑器设置
– 确保使用经典编辑器
– 如果使用古腾堡编辑器，需要手动输入短代码

2. 主题兼容性
– 大多数主题都能完美兼容
– 如有样式冲突，可在主题CSS中添加自定义样式

3. 缓存设置
– 如使用缓存插件，安装后请清除缓存
– 确保CSS和JS文件能正常加载

### 高级配置

#### 1. 自定义样式
在主题的 `style.css` 文件中添加：

“`css
/* 自定义Mud下载按钮样式 */
.download-button-wrapper .download-button {
/* 您的自定义样式 */
font-family: “您的字体”, sans-serif;
border-radius: 10px;
}

/* 移动端适配 */
@media (max-width: 768px) {
.download-button-wrapper .download-button {
width: 100%;
text-align: center;
}
}
“`

2. 固定链接设置
为了确保链接伪装功能正常工作：
1. 进入 **设置** → **固定链接**
2. 选择除”朴素”外的任意结构
3. 点击 **保存更改**

🐛 常见安装问题

### 问题1：插件无法激活

**错误信息：** “插件激活时发生错误”

**可能原因：**
– PHP版本过低
– 内存限制不足
– 文件权限问题

**解决方案：**
1. 检查PHP版本是否满足要求（5.6+）
2. 增加PHP内存限制到128MB以上
3. 设置插件文件夹权限为755
4. 联系主机商检查服务器配置

### 问题2：编辑器中看不到按钮

**可能原因：**
– 使用古腾堡编辑器
– JavaScript加载失败
– 用户权限不足

**解决方案：**
1. 切换到经典编辑器
2. 检查浏览器控制台是否有错误
3. 确保用户有编辑文章的权限
4. 清除浏览器缓存

### 问题3：样式显示异常

**可能原因：**
– CSS文件加载失败
– 主题样式冲突
– 缓存问题

**解决方案：**
1. 检查CSS文件是否正确加载
2. 清除网站和浏览器缓存
3. 暂时切换到默认主题测试
4. 在主题CSS中添加 `!important` 覆盖样式

### 问题4：文件上传失败

**错误信息：** “上传的文件超过了 php.ini 中 upload_max_filesize 指令的值”

**解决方案：**
1. 联系主机商增加上传限制
2. 或使用FTP手动安装方法
3. 检查文件是否损坏，重新下载

 🔄 升级指南

### 自动升级

当有新版本发布时：
1. WordPress会在插件页面显示更新提示
2. 点击 **立即更新** 按钮
3. 等待更新完成
4. 清除缓存

### 手动升级

如需手动升级：
1. 备份当前插件文件
2. 下载最新版本
3. 停用旧版本插件
4. 删除旧版本文件
5. 按照安装步骤安装新版本
6. 激活插件

 🗑️ 卸载指南

### 完全卸载步骤

如需完全移除插件：

1. 停用插件
– 进入 **插件** → **已安装的插件**
– 找到 “Mud Download Button Plugin”
– 点击 **停用**

2. 删除插件
– 在插件列表中点击 **删除**
– 确认删除操作

3. 清理残留（可选）
– 检查主题CSS中是否有相关自定义样式
– 清除缓存插件的缓存
– 检查文章中的短代码是否需要处理

数据保留说明

– 插件不会在数据库中存储额外数据
– 卸载后不会影响已发布的内容
– 短代码会保留在文章中，但不会渲染为按钮

 📞 技术支持

### 获取帮助

如果在安装过程中遇到问题：

1. **查阅文档** – 首先查看本安装指南和README文档
2. **检查系统要求** – 确认服务器环境满足要求
3. **联系技术支持** – 访问 [https://nirenchuanshuo.com/](https://nirenchuanshuo.com/)
4. **提供详细信息** – 包括错误信息、服务器环境、WordPress版本等

### 支持信息模板

联系技术支持时，请提供以下信息：

“`
WordPress版本：
PHP版本：
主题名称：
错误信息：
安装方法：
浏览器版本：
其他相关插件：
“`

 🎉 安装完成

恭喜！您已成功安装 Mud Download Button Plugin。

### 下一步操作

1. **阅读使用文档** – 查看 README.md 了解详细功能
2. **创建第一个下载按钮** – 在文章中测试插件功能
3. **自定义样式** – 根据网站风格调整按钮外观
4. **探索高级功能** – 了解链接伪装等特色功能

### 快速开始

最简单的使用方法：
1. 编辑任意文章或页面
2. 点击工具栏的 “⬇Mud下载” 按钮
3. 填写下载链接和按钮文本
4. 选择喜欢的颜色主题
5. 点击确定插入

**感谢选择 Mud Download Button Plugin！**

**开发者：泥人传说**
**官方网站：[https://nirenchuanshuo.com/](https://nirenchuanshuo.com/)**
**版本：1.0.0**

插件下载：