gravityflow/codeception

Gravity Flow

镜像概述和主要用途

Gravity Flow是一款WordPress高级插件，为Gravity Forms创建的表单提供工作流自动化功能。本仓库是Gravity Flow的开发版本，旨在促进与开发者的沟通。注意：此版本不稳定，不应在生产环境中使用，也不应用于购买前的评估（功能可能不完整，且不提供技术支持）。欢迎提交Pull请求。

核心功能和特性

• 工作流自动化：为Gravity Forms表单提供完整的工作流自动化能力
• 开发者友好：支持本地开发环境配置，便于开发者进行功能扩展和测试
• 构建工具集成：兼容Gulp和PostCSS，支持CSS和JS文件的开发与构建
• 图标套件：包含基于Icomoon管理的UI图标套件，统一界面风格
• 测试支持：提供集成测试和验收测试套件，确保代码质量

使用场景和适用范围

适用于Gravity Flow插件的开发者进行功能开发、测试和贡献代码。不适用于生产环境网站或作为购买前的评估工具。

详细使用方法和配置说明

安装说明

要使用此开发版本，只需将仓库克隆到WordPress的插件目录并启用脚本调试模式。若未启用脚本调试模式，脚本和样式将无法加载，导致插件无法正常工作。

启用脚本调试模式：在wp-config.php文件中添加以下行：

php
define( 'SCRIPT_DEBUG', true );

本地开发

若需处理CSS和新JS文件，需配置Gulp和PostCSS。请按以下步骤操作：

• 重要：若使用Apple M1芯片，需使用Rosetta终端
• 推荐安装Node版本管理器（如https://github.com/nvm-sh/nvm%E6%88%96https://github.com/coreybutler/nvm-windows%EF%BC%89
• 查看仓库根目录的.nvmrc文件，使用nvm install X.XX.X安装指定Node版本
• 每次开始工作时，在仓库目录运行nvm use以确保使用正确Node版本
• 首次安装正确Node版本后，运行一次npm install gulp-cli -g（安装后需重启终端）
• 在仓库根目录运行npm install安装依赖模块
• 使用browsersync开发：
  1. 将config-sample.json重命名为config.json，local-config-sample.json重命名为local-config.json
  2. 调整证书路径和域名至本地开发域名
  3. 运行npm run dev（支持CSS变更实时注入，无需刷新页面）
• 使用watch开发：运行npm run watch
• 准备提交PR：运行npm run dist构建开发文件和sourcemaps
• 拉取新代码后：运行npm install确保依赖更新
• 构建系统问题排查：切换主要版本或分支后，若遇到问题，运行npm run reset（清除node_modules并重新安装）

图标套件

插件包含基于Icomoon管理的UI图标套件。所有图标使用类gflow-icon和gflow-icon--NAME，可在dev/icons目录的演示套件中查看。

测试套件

集成测试

通过终端安装集成测试：

bash
bash tests/bin/install.sh [DB_NAME] [DB_USER] [DB_PASSWORD] [DB_HOST]

• 使用VVV时：

  bash
  bash tests/bin/install.sh wordpress_unit_tests root root localhost
  

• 使用Local by Flywheel时（需修改IP和端口）：

  bash
  bash tests/bin/install.sh local root root 192.168.95.100:4010
  

验收测试

验收测试独立于单元测试，无需配置单元测试。需确保已安装Docker，运行以下脚本：

bash
bash tests/acceptance-tests/start.sh

注意：在M1 Mac硬件上运行验收测试，需通过.env文件设置环境变量： ACCEPTANCE_CHROME_IMAGE=seleniarm/standalone-chromium:4.1.1-alpha-20220119

文档

• 用户指南、FAQ、演练和开发者文档：[***]
• 类文档：[***]

翻译

如需将Gravity Flow翻译成其他语言，请提交支持工单。

***

Gravity Flow是Rocketgenius Inc.的注册商标。 2023年Rocketgenius Inc.版权所有。