README

Circul8 的 WordPress 堆栈，基于 Root's Bedrock，并预装了一些插件。

安装

1. 初始化项目

在新的文件夹中创建一个新的项目

非常重要，最初设置 ACF PRO 密钥，否则安装将失败

  $ export ACF_PRO_KEY=123abc
  $ composer create-project circul8/wordpress your-project-folder-name

2. 配置数据库

更新 .env 文件中的环境变量

• DB_NAME - 数据库名称
• DB_USER - 数据库用户
• DB_PASSWORD - 数据库密码
• DB_HOST - 数据库主机
• WP_ENV - 设置为环境（development、staging、production）
• WP_HOME - WordPress 主页的完整 URL（http://example.com）
• WP_SITEURL - 包含子目录的 WordPress 的完整 URL（http://example.com/wp）
• AUTH_KEY、SECURE_AUTH_KEY、LOGGED_IN_KEY、NONCE_KEY、AUTH_SALT、SECURE_AUTH_SALT、LOGGED_IN_SALT、NONCE_SALT

3. 其他

1. 将网站虚拟主机文档根设置为 /web 文件夹，例如 /path/to/site/web/

2. 通过 http://example.com/wp/wp-admin 访问 WP 管理员

插件

预装插件

1. Classic Editor（已激活 -> MU* 插件）
   • 我们不使用 Gutenberg。
2. Disable Comments（已激活 -> MU* 插件）
   • 必须禁用所有评论。我们不使用此功能。此外，它是一个安全漏洞。
3. Duplicate Post（已激活 -> MU* 插件）
   • 管理 UX 调整，以便轻松复制/粘贴帖子。
4. Post Types Order（已激活 -> MU* 插件）
   • 管理 UX 调整，以便轻松重新排序帖子。
5. Tinymce Advanced（已激活 -> MU* 插件）
   • WYSIWYG 增强。
6. Advanced Custom Fields PRO（已激活 -> 必须使用）
   • 最重要的插件。
7. Wordfence（未激活）
   • 这不是强制插件，但推荐。安全性。
8. WP Mail SMTP（未激活）
   • 这不是强制插件，但推荐，wpmail() 不可靠。公司政策是使用 Mailgun。

*MU - 必须使用插件

安装新插件

由于安全原因，通常在生产环境中禁用安装新插件，因此请使用 composer

1. 在 WPackagist 中查找插件
2. 安装插件 composer require wpackagist-plugin/akismet

测试 & 代码风格

由于这是一个仅用于 WP Headless 项目的支架，应仅使用 WP 插件而不使用任何主题，因此已删除 PHPCS。

如果需要附加功能，请参考 Circul8 编码标准。

本地开发

为了在本地开发此项目包，您需要

1. 克隆此存储库
2. 在克隆中进行更改
3. 提交更改（不要推送）
4. 在某个地方创建packages.json（见下文）
5. 使用指定的packages.json运行create-project（见下文）

create-project

$ composer clearcache && export ACF_PRO_KEY="123==" && composer create-project --repository-url={YOURPATH}/packages.json circul8/wordpress:dev-master

别忘了将{YOURPATH}改为你的packages.json所在路径。

packages.json

{
  "package": {
      "name": "circul8/wordpress",
      "version": "1.0.0",
      "source": {
        "url": "{YOURPATH}wordpress/.git",
        "type": "git",
        "reference": "{YOURBRANCH}"
      }
  }
}

同样，别忘了将{YOURPATH}修改。这次它必须指向circul8/wordpress的克隆仓库。你还需要将{YOURBRANCH}改为你的测试分支。

参考

• https://gist.github.com/wimvds/7150868

文档/参考

• Bedrock
• Composer
• WPackagist

变更日志

• v2.0.0（2020-01-28）
  • 升级到最新版本的Bedrock。
  • 移除了启动主题 -> 进行中的项目应该是无头项目。
  • 移除了Timber插件 -> 进行中的项目应该是无头项目。
  • 升级到Wordpress 5.3
  • 所有插件均已更新。
• v1.0.0（2019-03-14）
  • 开始版本控制。Wordpress升级到5.1.1。
  • ACF修复以兼容Guttenberg。
  • 升级到最新版本的Bedrock。