WordPress 插件安装指南

环境要求

安装步骤

方法一：后台上传安装（推荐新手）

1. 打包插件

   • 将 plugin/zm-coffee-api 文件夹压缩为 zm-coffee-api.zip

2. 上传到 WordPress

   • 登录 WordPress 后台
   • 进入 插件 → 安装插件
   • 点击 上传插件
   • 选择 zm-coffee-api.zip
   • 点击 现在安装

3. 启用插件

   • 点击 启用插件

方法二：FTP/SFTP 上传（适合大文件）

1. 连接服务器

   
   

   # FTP 连接
   ftp your-server.com
      
   # 或 SFTP 连接
   sftp user@your-server.com
   

   
   

2. 上传插件

   • 将 zm-coffee-api 文件夹上传到 WordPress 的 wp-content/plugins/ 目录

3. 设置权限

   
   

   chmod 755 wp-content/plugins/zm-coffee-api
   chmod -R 755 wp-content/plugins/zm-coffee-api
   

   
   

4. 启用插件

   • 登录 WordPress 后台
   • 进入 插件
   • 找到 “智享咖啡小程序” 点击 启用

插件目录结构

wp-content/plugins/zm-coffee-api/
├── zm-coffee-api.php          # 主入口文件
├── admin/                     # 后台管理
├── includes/                   # 核心类
├── page-builder/              # 页面构造器
├── uniapp/                    # 内置 H5 预览（可选）
├── acf-json/                  # ACF 字段配置
└── config/                    # 配置文件

基础配置

1. 进入设置页面

WordPress 后台 → 左侧菜单 → 咖啡小程序

2. 基础设置

3. 保存设置

ACF 字段同步

插件使用 Advanced Custom Fields (ACF) 管理字段配置：

1. 自动同步

   • 插件已包含 acf-json 目录
   • 进入 自定义字段 → 字段组
   • 如果提示同步，点击 同步

2. 必需字段组

   • 页面构造器配置
   • 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+）和内存限制

下一步

• ✅ 配置小程序
• ✅ 使用页面构造器