README

这是一个 composer 插件，通过 composer 更容易地安装 ACF PRO。

它从 环境 或 .env 文件 中读取您的 🔑 ACF PRO 密钥。

⚠️ 已弃用。支持至 2023 年 6 月 1 日 ⚠️

此插件已被弃用，因为 Advanced Custom Fields 已发布本机 composer 支持。我们积极鼓励用户切换到他们的解决方案。此 composer 插件将更新/维护至 2023 年 6 月 1 日。之后我们将标记此存储库为存档，并关闭以下提到的存储库。

使用方法

此插件与 Composer 2.x（最新版）和 1.x 都兼容

1. 将我们的 Advanced Custom Fields Composer Bridge 存储库添加到 composer.json 中的 repositories 字段

此存储库仅提供了一个定期更新的 packages.json，将 composer 重定向到 ACF 提供的下载。请注意，此存储库 不 提供任何 Advanced Custom Fields Pro 包，它只告诉 Composer 如何找到 ACF Pro 包。其次，重要的是要注意，您的许可证密钥不会提交到存储库，因为安装程序直接从 ACF 服务器下载 Advanced Custom Fields Pro zip 文件。

为什么使用此存储库？

因为它使您能够使用 advanced-custom-fields/advanced-custom-fields-pro 包，就像任何正常的 Packagist 包一样使用版本约束。您不再需要手动更新版本，就像您必须使用 philippbaschke/acf-pro-installer（以及像 dependabot 这样的工具也将为 ACF 工作）一样。

{
  "type": "composer",
  "url": "https://pivvenit.github.io/acf-composer-bridge/composer/v3/wordpress-plugin/"
}

此安装程序将包安装为 wordpress-plugin 类型，如果您想要其他类型，请使用以下 URL

wordpress-muplugin

https://pivvenit.github.io/acf-composer-bridge/composer/v3/wordpress-muplugin/

wpackagist-plugin

https://pivvenit.github.io/acf-composer-bridge/composer/v3/wpackagist-plugin/

library

https://pivvenit.github.io/acf-composer-bridge/composer/v3/library/

2. 使 ACF PRO 密钥可用

有 3 种方法使 ACF_PRO_KEY 可用

• 使用 ACF_PRO_KEY 环境变量
• .env 文件
• 在 $COMPOSER_HOME/config.json 中设置 acf-pro-key

选择最适合您设置的方法

2.a 使用 ACF_PRO_KEY 环境变量

将环境变量 ACF_PRO_KEY 设置为您的 ACF PRO 密钥。

2.b 使用 .env 文件

或者，您可以在您的 .env 文件中添加一个条目

# .env (same directory as composer.json)
ACF_PRO_KEY=Your-Key-Here

2.c 在 $COMPOSER_HOME/config.json 中设置密钥

在您的 $COMPOSER_HOME/config.json 的 config 部分指定 acf-pro-key

{
  "config": {
    "acf-pro-key": "Your-Key-Here"
  }
}

$COMPOSER_HOME 是一个隐藏的、全局的（在机器上针对用户）目录，它被所有项目共享。默认情况下，它在 Windows 系统上指向 C:\Users\<user>\AppData\Roaming\Composer，在 macOS 系统上指向 /Users/\<user\>/.composer。在遵循 XDG Base Directory 规范的 *nix 系统中，它指向 $XDG_CONFIG_HOME/composer。在其他 *nix 系统中，它指向 /home/\<user\>/.composer。

3. 需要 ACF PRO

composer require advanced-custom-fields/advanced-custom-fields-pro