README

这是共享主机开发的现代 WordPress 设置。

• 它使用 Apache 和 Docker 来简化开发，并确保部署到共享主机（大多数使用 Apache）的一致性。
• 它包括基于 webpack 的任务运行器，允许主题和插件资产编译。
• 它还包括 phpcs 和 phpcbf 来确保项目的代码风格。

初始化

• 创建项目（稳定版本）

composer create-project enpii/wp-site-enpii-boilerplate <folder-name>

• 使用开发版本（分支 master）

composer create-project -s dev enpii/wp-site-enpii-boilerplate <folder-name>

如果您想指定分支（例如分支 develop）

composer create-project -s dev enpii/wp-site-enpii-boilerplate:dev-develop <folder-name>

• 请确保您有 .env 文件，如果不存在，您可以从示例文件中复制。

cp .env.example .env

• 然后使用适合您工作环境的相应环境变量，记住检查 SALTS 部分以使用正确的变量。

开发

• 更新依赖项

XDEBUG_MODE=off composer update

使用 Docker 部署

• 启动所有容器

docker-compose compose up -d

然后网站将在 http://127.0.0.1:19080/ 上可用（端口号 19080 可以在 .env 文件中编辑，但需要重新启动容器）

• 使用 Docker 更新 composer

docker-compose exec -e XDEBUG_MODE=off wordpress composer update

• 运行 phpcs

docker compose exec wordpress yarn phpcs

或

docker compose exec wordpress yarn phpcbf

修复代码风格问题

• 运行 wp-app artisan

docker-compose exec --user=webuser wordpress ./wp-enpii-base-artisan wp-app:hello

或

docker-compose exec --user=webuser wordpress wp enpii-base artisan wp-app:hello

运行 wp-cli

• 使用 Docker

docker compose exec --user=webuser wordpress wp enpii-base info

• 在本地机器上，保持在项目根目录

wp enpii-base info

使用 GIT

• 您可以将自己的插件、主题、mu-plugin 放置在相应的文件夹中。然后如果您使用 git，可以通过以下方式将这些内容添加到您的存储库中
  • 更新 ./wp-content/.gitignore 以允许您的插件、mu-plugin、主题
  • 例如，您有一个名为 hello-world 的插件，您需要添加以下内容

  !plugins/hello-world
  !plugins/hello-world/**
  

  • 然后您可以运行 git add <your-plugin-folder> 将这些内容添加到存储库中

编译资产（CSS、JS）

• 此存储库包含一个示例插件 Demoda 和一个示例主题 Appeara Alpha，它具有编译插件和主题 CSS 和 JS 的 webpack 配置。

安装依赖项

docker compose exec wordpress yarn install

编译插件资产

docker compose exec wordpress yarn build-plugin

或

docker compose exec wordpress yarn dev-plugin

类似于主题的

docker compose exec wordpress yarn build-theme

和监控

docker compose exec wordpress yarn dev-theme