安装指南
WordPress 插件安装指南
环境要求
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| PHP | 8.0 | 8.1+ |
| WordPress | 6.0 | 6.3+ |
| 内存 | 256M | 512M+ |
| HTTPS | 必须 | 必须 |
安装步骤
方法一:后台上传安装(推荐新手)
打包插件
- 将
plugin/zm-coffee-api文件夹压缩为zm-coffee-api.zip
- 将
上传到 WordPress
- 登录 WordPress 后台
- 进入 插件 → 安装插件
- 点击 上传插件
- 选择
zm-coffee-api.zip - 点击 现在安装
启用插件
- 点击 启用插件
方法二:FTP/SFTP 上传(适合大文件)
连接服务器
# FTP 连接
ftp your-server.com
# 或 SFTP 连接
sftp user@your-server.com上传插件
- 将
zm-coffee-api文件夹上传到 WordPress 的wp-content/plugins/目录
- 将
设置权限
chmod 755 wp-content/plugins/zm-coffee-api
chmod -R 755 wp-content/plugins/zm-coffee-api启用插件
- 登录 WordPress 后台
- 进入 插件
- 找到 “智享咖啡小程序” 点击 启用
插件目录结构
wp-content/plugins/zm-coffee-api/
├── zm-coffee-api.php # 主入口文件
├── admin/ # 后台管理
├── includes/ # 核心类
├── page-builder/ # 页面构造器
├── uniapp/ # 内置 H5 预览(可选)
├── acf-json/ # ACF 字段配置
└── config/ # 配置文件
基础配置
1. 进入设置页面
WordPress 后台 → 左侧菜单 → 咖啡小程序
2. 基础设置
| 配置项 | 说明 | 示例 |
|---|---|---|
| API 域名 | 你的 WordPress 网站地址(必须 HTTPS) | https://your-domain.com |
| 小程序 AppID | 微信小程序 AppID | wx1234567890abcdef |
| Token 密钥 | 用于接口验证(自定义) | your-secret-key-123 |
3. 保存设置
ACF 字段同步
插件使用 Advanced Custom Fields (ACF) 管理字段配置:
自动同步
- 插件已包含
acf-json目录 - 进入 自定义字段 → 字段组
- 如果提示同步,点击 同步
- 插件已包含
必需字段组
- 页面构造器配置
- TabBar 配置
- 组件配置
验证安装
1. 检查插件状态
- WordPress 后台 → 插件 页面
- 确认 “智享咖啡小程序” 状态为 启用
2. 测试 API
浏览器访问:
https://你的域名/wp-json/zm-coffee-api/v1/tabbar
应该返回 TabBar 配置 JSON 数据。
3. 检查伪静态
WordPress 后台 → 设置 → 永久链接
推荐选择:文章名 或 自定义结构 /%postname%/
常见问题
Q: 提示 “JError無法建立目錄”
A: 检查 wp-content 目录权限,设置为 755 或 775
Q: API 返回 404
A: 检查 WordPress 伪静态设置,确保使用固定链接而非默认
Q: 插件启用失败
A: 检查 PHP 版本(需要 8.0+)和内存限制


4 月 27,2026
By zadmin