PHPackages                             pivvenit/acf-pro-installer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. pivvenit/acf-pro-installer

AbandonedArchivedComposer-plugin[Utility &amp; Helpers](/categories/utility)

pivvenit/acf-pro-installer
==========================

A modern maintained install helper for Advanced Custom Fields PRO

3.2.0(3y ago)49458.4k↓36%7[4 PRs](https://github.com/pivvenit/acf-pro-installer/pulls)MITPHPPHP ^7.3||^8.0

Since Apr 15Pushed 2y ago1 watchersCompare

[ Source](https://github.com/pivvenit/acf-pro-installer)[ Packagist](https://packagist.org/packages/pivvenit/acf-pro-installer)[ RSS](/packages/pivvenit-acf-pro-installer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (9)Versions (25)Used By (0)

ACF PRO Installer
=================

[](#acf-pro-installer)

[![Packagist](https://camo.githubusercontent.com/0ae1b3606003d7492559e56a5ef73dbf058d5c099d95ccdbb4597f469d2df483/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70697676656e69742f6163662d70726f2d696e7374616c6c65722e7376673f6d61784167653d33363030)](https://packagist.org/packages/pivvenit/acf-pro-installer)[![Packagist](https://camo.githubusercontent.com/5a2a2a30422794730e4db7fcdcb561c74da7494e46c2e798bbae0604d15c0656/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f70697676656e69742f6163662d70726f2d696e7374616c6c65722e7376673f6d61784167653d32353932303030)](https://github.com/pivvenit/acf-pro-installer/blob/master/LICENSE)[![](https://github.com/pivvenit/acf-pro-installer/workflows/Master%20Build/badge.svg)](https://github.com/pivvenit/acf-pro-installer/workflows/Master%20Build/badge.svg)[![Dependabot](https://camo.githubusercontent.com/16df3a8a95ca528ccfb2013d513815a2b17031dee04bdd555570d256a630ccbc/68747470733a2f2f62616467656e2e6e65742f62616467652f446570656e6461626f742f656e61626c65642f677265656e3f69636f6e3d646570656e6461626f74)](https://dependabot.com/)[![Coverage Status](https://camo.githubusercontent.com/26d8d0212e57c0eb35b05da4b96c6fb2e4eb32bb34ad1733e8aad2bb9b65cbc0/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f70697676656e69742f6163662d70726f2d696e7374616c6c65722f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/pivvenit/acf-pro-installer?branch=master)

A composer plugin that makes installing [ACF PRO](https://www.advancedcustomfields.com/pro/) with [composer](https://github.com/composer/composer) easier.

It reads your 🔑 ACF PRO key from the **environment** or a **.env file**.

⚠️ Deprecated. Supported till 1st of June 2023 ⚠️
-------------------------------------------------

[](#warning-deprecated-supported-till-1st-of-june-2023-warning)

This plugin is deprecated, since [Advanced Custom Fields has released native composer support](https://www.advancedcustomfields.com/resources/installing-acf-pro-with-composer/). We actively encourage users to switch to their solution. This composer plugin will be updated/maintained till 1st of June 2023. Afterwards we will mark this repository as archived, and shutdown the repositories mentioned below.

Usage
-----

[](#usage)

> This plugin is compatible with Both Composer 2.x (latest) and 1.x

**1. Add our [Advanced Custom Fields Composer Bridge](https://github.com/pivvenit/acf-composer-bridge) repository to the [`repositories`](https://getcomposer.org/doc/04-schema.md#repositories) field in `composer.json`**

> This repository simply provides a periodically updated [packages.json](https://pivvenit.github.io/acf-composer-bridge/composer/v2/packages.json), that redirects composer to the ACF provided downloads. Note that this repository **does not** provide any Advanced Custom Fields Pro packages itself, it only tells Composer where it can find ACF Pro packages. Secondly it is important to note that **your license key is not submitted to the repository**, since the installer downloads the Advanced Custom Fields Pro zip files directly from ACF's servers.

**Why this repository?**

Since it enables you to use `advanced-custom-fields/advanced-custom-fields-pro` package with version constraints like any normal Packagist package. You no longer have to update the version manually as you had to with `philippbaschke/acf-pro-installer` (and tools like dependabot will also work for ACF).

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

This installs the package as `wordpress-plugin` type, in case you want a different type, use the following 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. Make your ACF PRO key available**

There are 3 ways to make the ACF\_PRO\_KEY available:

- Using the ACF\_PRO\_KEY environment variable
- `.env` file
- Setting `acf-pro-key` in `$COMPOSER_HOME/config.json`

Select the one that best matches your setup:

***2.a Using the ACF\_PRO\_KEY Environment variable***

Set the environment variable **`ACF_PRO_KEY`** to your [ACF PRO key](https://www.advancedcustomfields.com/my-account/).

***2.b Use a .env file***

Alternatively you can add an entry to your **`.env`** file:

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

***2.c. Setting the key in `$COMPOSER_HOME/config.json`***

You specify the `acf-pro-key` in the `config` section of your `$COMPOSER_HOME/config.json`

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

> `$COMPOSER_HOME` is a hidden, global (per-user on the machine) directory that is shared between all projects. By default it points to `C:\Users\\AppData\Roaming\Composer` on Windows and `/Users/\/.composer` on macOS. On \*nix systems that follow the XDG Base Directory Specifications, it points to `$XDG_CONFIG_HOME/composer`. On other \*nix systems, it points to `/home/\/.composer`.

**3. Require ACF PRO**

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

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity45

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 51% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~129 days

Recently: every ~167 days

Total

19

Last Release

1362d ago

Major Versions

v0.2.0 → v1.0.02016-04-25

v1.0.2 → v2.0.02019-02-26

2.4.1 → 3.0.02020-11-21

PHP version history (3 changes)v0.1.0PHP &gt;=5.5

v2.0.0PHP ^7.2

3.0.0PHP ^7.3||^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/c75ddf117af3c6cbd06c7155f640d9fb2190bd5c60089689b30d35d2b34b502d?d=identicon)[PivvenIT](/maintainers/PivvenIT)

---

Top Contributors

[![Qrious](https://avatars.githubusercontent.com/u/680327?v=4)](https://github.com/Qrious "Qrious (410 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (246 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (104 commits)")[![PhilippBaschke](https://avatars.githubusercontent.com/u/10756783?v=4)](https://github.com/PhilippBaschke "PhilippBaschke (38 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (3 commits)")[![awcross](https://avatars.githubusercontent.com/u/1489573?v=4)](https://github.com/awcross "awcross (2 commits)")[![randmanrjr](https://avatars.githubusercontent.com/u/4073249?v=4)](https://github.com/randmanrjr "randmanrjr (1 commits)")

---

Tags

advanced-custom-fieldsbedrockcomposercomposer-pluginwordpressplugincomposerwordpressenvwpacfpro

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/pivvenit-acf-pro-installer/health.svg)

```
[![Health](https://phpackages.com/badges/pivvenit-acf-pro-installer/health.svg)](https://phpackages.com/packages/pivvenit-acf-pro-installer)
```

###  Alternatives

[philippbaschke/acf-pro-installer

An install helper for Advanced Custom Fields PRO

283724.6k](/packages/philippbaschke-acf-pro-installer)[ffraenz/private-composer-installer

A composer install helper for private packages

2331.7M5](/packages/ffraenz-private-composer-installer)[roots/bedrock

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

6.5k441.8k2](/packages/roots-bedrock)[gotoandplay/gravityforms-composer-installer

A composer install helper for Gravity Forms

31389.9k](/packages/gotoandplay-gravityforms-composer-installer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
