{"id":15062763,"url":"https://github.com/pivvenit/acf-pro-installer","last_synced_at":"2025-10-04T22:31:27.008Z","repository":{"id":34096821,"uuid":"171718171","full_name":"pivvenit/acf-pro-installer","owner":"pivvenit","description":"A composer install helper for Advanced Custom Fields PRO","archived":true,"fork":true,"pushed_at":"2023-07-10T12:37:08.000Z","size":2668,"stargazers_count":50,"open_issues_count":4,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-19T20:52:49.297Z","etag":null,"topics":["advanced-custom-fields","bedrock","composer","composer-plugin","wordpress"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"PhilippBaschke/acf-pro-installer","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pivvenit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-02-20T17:24:24.000Z","updated_at":"2024-10-01T07:47:56.000Z","dependencies_parsed_at":"2023-02-11T00:45:45.455Z","dependency_job_id":null,"html_url":"https://github.com/pivvenit/acf-pro-installer","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivvenit%2Facf-pro-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivvenit%2Facf-pro-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivvenit%2Facf-pro-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pivvenit%2Facf-pro-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pivvenit","download_url":"https://codeload.github.com/pivvenit/acf-pro-installer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235112267,"owners_count":18937665,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["advanced-custom-fields","bedrock","composer","composer-plugin","wordpress"],"created_at":"2024-09-24T23:46:00.819Z","updated_at":"2025-10-04T22:31:21.668Z","avatar_url":"https://github.com/pivvenit.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ACF PRO Installer\n\n[![Packagist](https://img.shields.io/packagist/v/pivvenit/acf-pro-installer.svg?maxAge=3600)](https://packagist.org/packages/pivvenit/acf-pro-installer)[![Packagist](https://img.shields.io/packagist/l/pivvenit/acf-pro-installer.svg?maxAge=2592000)](https://github.com/pivvenit/acf-pro-installer/blob/master/LICENSE)![](https://github.com/pivvenit/acf-pro-installer/workflows/Master%20Build/badge.svg)\n[![Dependabot](https://badgen.net/badge/Dependabot/enabled/green?icon=dependabot)](https://dependabot.com/)\n[![Coverage Status](https://coveralls.io/repos/github/pivvenit/acf-pro-installer/badge.svg?branch=master)](https://coveralls.io/github/pivvenit/acf-pro-installer?branch=master)\n\nA composer plugin that makes installing [ACF PRO] with [composer] easier. \n\nIt reads your :key: ACF PRO key from the **environment** or a **.env file**.\n\n[ACF PRO]: https://www.advancedcustomfields.com/pro/\n[composer]: https://github.com/composer/composer\n\n## :warning: Deprecated. Supported till 1st of June 2023 :warning:\n\nThis 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. \n\n## Usage\n\n\u003e This plugin is compatible with Both Composer 2.x (latest) and 1.x\n\n**1. Add our [Advanced Custom Fields Composer Bridge](https://github.com/pivvenit/acf-composer-bridge) repository to the [`repositories`][composer-repositories] field in `composer.json`**\n\u003e 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. \nNote that this repository **does not** provide any Advanced Custom Fields Pro packages itself, it only tells Composer where it can find ACF Pro packages.\nSecondly 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.\n\n**Why this repository?**\n\nSince it enables you to use `advanced-custom-fields/advanced-custom-fields-pro` package with version constraints like any normal Packagist package.\nYou 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).\n\n```json\n{\n  \"type\": \"composer\",\n  \"url\": \"https://pivvenit.github.io/acf-composer-bridge/composer/v3/wordpress-plugin/\"\n}\n```\n\nThis installs the package as `wordpress-plugin` type, in case you want a different type, use the following URL:\n\nwordpress-muplugin:\n\u003e `https://pivvenit.github.io/acf-composer-bridge/composer/v3/wordpress-muplugin/`\n\nwpackagist-plugin:\n\u003e `https://pivvenit.github.io/acf-composer-bridge/composer/v3/wpackagist-plugin/`\n\nlibrary:\n\u003e `https://pivvenit.github.io/acf-composer-bridge/composer/v3/library/`\n\n\n**2. Make your ACF PRO key available**\n\nThere are 3 ways to make the ACF_PRO_KEY available:\n- Using the ACF_PRO_KEY environment variable\n- `.env` file\n- Setting `acf-pro-key` in `$COMPOSER_HOME/config.json`\n\nSelect the one that best matches your setup:\n\n***2.a Using the ACF_PRO_KEY Environment variable***\n\nSet the environment variable **`ACF_PRO_KEY`** to your [ACF PRO key][acf-account].\n\n***2.b Use a .env file***\n\nAlternatively you can add an entry to your **`.env`** file:\n\n```ini\n# .env (same directory as composer.json)\nACF_PRO_KEY=Your-Key-Here\n```\n\n***2.c. Setting the key in `$COMPOSER_HOME/config.json`***\n\nYou specify the `acf-pro-key` in the `config` section of your `$COMPOSER_HOME/config.json`\n```json\n{\n  \"config\": {\n    \"acf-pro-key\": \"Your-Key-Here\"\n  }\n}\n```\n\u003e `$COMPOSER_HOME` is a hidden, global (per-user on the machine) directory that is shared between all projects.\n\u003e By default it points to `C:\\Users\\\u003cuser\u003e\\AppData\\Roaming\\Composer` on Windows and `/Users/\\\u003cuser\\\u003e/.composer` on macOS. \n\u003e On *nix systems that follow the XDG Base Directory Specifications, it points to `$XDG_CONFIG_HOME/composer`. \n\u003e On other *nix systems, it points to `/home/\\\u003cuser\\\u003e/.composer`.\n\n**3. Require ACF PRO**\n\n```sh\ncomposer require advanced-custom-fields/advanced-custom-fields-pro\n```\n\n[composer-repositories]: https://getcomposer.org/doc/04-schema.md#repositories\n[package-gist]: https://gist.github.com/fThues/705da4c6574a4441b488\n[acf-account]: https://www.advancedcustomfields.com/my-account/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivvenit%2Facf-pro-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpivvenit%2Facf-pro-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpivvenit%2Facf-pro-installer/lists"}