PHPackages                             philippbaschke/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 & Helpers](/categories/utility)
4. /
5. philippbaschke/acf-pro-installer

ActiveComposer-plugin[Utility & Helpers](/categories/utility)

philippbaschke/acf-pro-installer
================================

An install helper for Advanced Custom Fields PRO

v1.0.2(9y ago)283724.6k66[9 issues](https://github.com/PhilippBaschke/acf-pro-installer/issues)[5 PRs](https://github.com/PhilippBaschke/acf-pro-installer/pulls)MITPHPPHP >=5.5CI failing

Since Apr 15Pushed 2y ago10 watchersCompare

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

READMEChangelog (5)Dependencies (6)Versions (6)Used By (0)

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

[](#acf-pro-installer)

[![Packagist](https://camo.githubusercontent.com/0c1fd32fe941723d4b0031c30f4c130976bfe608f0bd3889c705c8fa01c26118/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7068696c69707062617363686b652f6163662d70726f2d696e7374616c6c65722e7376673f6d61784167653d33363030)](https://packagist.org/packages/philippbaschke/acf-pro-installer)[![Packagist](https://camo.githubusercontent.com/0534ba8f680dcf1c7c887d16a90c64d6e9c7636fca02652d2a0ff9b31d0c1cc1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7068696c69707062617363686b652f6163662d70726f2d696e7374616c6c65722e7376673f6d61784167653d32353932303030)](https://github.com/PhilippBaschke/acf-pro-installer/blob/master/LICENSE)[![Travis](https://camo.githubusercontent.com/4252c49d058a36ae10be1b0b7e8841ad5216db2cb7dac49a3ff93a7956358287/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f5068696c69707042617363686b652f6163662d70726f2d696e7374616c6c65722e7376673f6d61784167653d33363030)](https://travis-ci.org/PhilippBaschke/acf-pro-installer)[![Coveralls](https://camo.githubusercontent.com/4a76ed3bc9c1034d95a36bc15e84949ee541a4aa964a95c595f21b445a190664/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f5068696c69707042617363686b652f6163662d70726f2d696e7374616c6c65722e7376673f6d61784167653d33363030)](https://coveralls.io/github/PhilippBaschke/acf-pro-installer)

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**.

Usage
-----

[](#usage)

**1. Add the package repository to the [`repositories`](https://getcomposer.org/doc/04-schema.md#repositories) field in `composer.json`(based on this [gist](https://gist.github.com/fThues/705da4c6574a4441b488)):**

```
{
  "type": "package",
  "package": {
    "name": "advanced-custom-fields/advanced-custom-fields-pro",
    "version": "*.*.*(.*)",
    "type": "wordpress-plugin",
    "dist": {
      "type": "zip",
      "url": "https://connect.advancedcustomfields.com/index.php?p=pro&a=download"
    },
    "require": {
      "philippbaschke/acf-pro-installer": "^1.0",
      "composer/installers": "^1.0"
    }
  }
}
```

Replace `"version": "*.*.*(.*)"` with your desired version.

Replace `"type": "wordpress-plugin"` with `"type": "library"` if you would like to have ACF PRO installed in the `./vendor` directory instead of `./wp-content/plugins`. This may be desireable if for example, you are including ACF PRO in a WordPress theme.

**2. Make your ACF PRO key available**

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

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

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

**3. Require ACF PRO**

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

You can specify an [exact version](https://getcomposer.org/doc/articles/versions.md) (that matches your desired version).

If you use **`*`**, composer will install the version from the package repository (see 1). This has the benefit that you only need to change the version in the package repository when you want to update.

*Be aware that `composer update` will only work if you change the `version` in the package repository. Decreasing the version only works if you require an [exact version](https://getcomposer.org/doc/articles/versions.md).*

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity51

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 97.4% 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 ~24 days

Total

5

Last Release

3580d ago

Major Versions

v0.2.0 → v1.0.02016-04-25

### Community

Maintainers

![](https://www.gravatar.com/avatar/5f3e32a083c605a1673cf0ebd75d18931061c095036fe74b195cf7b15c05dfa6?d=identicon)[PhilippBaschke](/maintainers/PhilippBaschke)

---

Top Contributors

[![PhilippBaschke](https://avatars.githubusercontent.com/u/10756783?v=4)](https://github.com/PhilippBaschke "PhilippBaschke (38 commits)")[![randmanrjr](https://avatars.githubusercontent.com/u/4073249?v=4)](https://github.com/randmanrjr "randmanrjr (1 commits)")

---

Tags

acfadvanced-custom-fieldscomposercomposer-pluginenvenvfilepackagistwordpresswordpress-developmentwpplugincomposerwordpressenvwpacfpro

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

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

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

###  Alternatives

[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)