README

一般信息

Flow 是适用于所有 OXID eShop 版本的响应式主题。

安装

步骤 1: 选择合适的分支

目前 Flow 有 3 个主要分支

• 分支 b-1.0 包含适用于 OXID eShop 版本 4.10/5.3 的 Flow
• 分支 b-2.x 包含适用于 OXID eShop 版本 6.0.0 的 Flow
• 分支 b-3.x 包含适用于 OXID eShop 编译版本 6.1 和 6.2 的 Flow
• 分支 master 包含 OXID eShop master 分支的最新提交的 Flow

步骤 2: 获取源代码

将适合您 OXID eShop 版本的分支检出到商店的 Application/views 目录中

cd DOCUMENT_ROOT/Application/views/
git clone -b BRANCH_NAME https://github.com/OXID-eSales/flow_theme.git flow

现在您应该有一个新的文件夹 DOCUMENT_ROOT/Application/views/flow。

步骤 3: 准备数据库（仅限版本 < 6.0）

为了安装主题选项，将 setup.sql 导入到您的数据库中。

选项 1: 控制台

mysql -u MYSQL_USER -p SHOP_DATABASE < flow/setup.sql

选项 2: 商店管理员: 服务 -> 工具

如果您有 flow 文件的本地副本，请转到商店管理员中的服务 -> 工具，上传 flow/setup.sql 并点击“启动更新”按钮

步骤 4: 准备 out 文件夹

out 文件夹可以以两种可能的方式准备。第一种是使用符号链接，第二种是复制。强烈建议使用符号链接，否则每次更新 Flow 时都需要进行复制。

选项 1: 符号链接

将主题的 out 目录链接到商店的 out 目录

ln -s ../Application/views/flow/out/flow ../../out/flow

选项 2: 复制

将主题的 out 目录复制到商店

cp -r flow/out/flow ../../out/flow

现在您应该能够执行 cd ../../out/flow。

步骤 5: 激活主题

登录管理员面板，转到 扩展 → 主题 → Flow 并点击 激活 按钮。清理缓存，然后出发，朋友！

开发

所有与 Flow 主题相关的 CSS/Javascript 文件都可以在主题的 build 目录中找到。要重新生成主题的资产，应使用 grunt 任务。请安装 grunt 并运行 grunt 的默认任务以重新生成所有最小化的 css 和 js 文件

1. 要使用 grunt，需要 npm。请查看 nodejs 网站以获取安装说明（https://node.org.cn/en/download/package-manager/）。在 ubuntu 系统上安装的示例

   curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
   sudo apt-get install -y nodejs
   

2. 全局安装 grunt 并更新 npm。示例

   sudo npm install -g npm grunt-cli 
   

3. 转到 "flow" 主题目录并安装所有相关的 grunt 插件

   cd DOCUMENT_ROOT/Application/views/flow/
   npm install
   

4. 现在可以在 "flow" 目录中运行 grunt 默认任务以重新生成 "flow" 主题资产

   grunt
   

贡献

如果您对贡献一些更改感兴趣，请阅读 CONTRIBUTING.md 文件以获取更多信息。

问题

请将所有问题转发到 https://bugs.oxid-esales.com/ 以处理 Flow 主题 项目。