PHPackages                             kaiseki/wp-acf - 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. kaiseki/wp-acf

ActiveLibrary[Utility & Helpers](/categories/utility)

kaiseki/wp-acf
==============

Advanced Custom Fields (ACF) helpers for WordPress: local JSON sync, a Google Maps API key provider, and a WP-CLI field-group sync command

1.0.0(1mo ago)1878MITPHPPHP ^8.2CI passing

Since Jun 1Pushed 3w ago3 watchersCompare

[ Source](https://github.com/kaisekidev/kaiseki-wp-acf)[ Packagist](https://packagist.org/packages/kaiseki/wp-acf)[ Docs](https://github.com/kaisekidev/kaiseki-wp-acf)[ RSS](/packages/kaiseki-wp-acf/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (20)Versions (5)Used By (0)

kaiseki/wp-acf
==============

[](#kaisekiwp-acf)

Advanced Custom Fields (ACF) helpers for WordPress: local JSON sync, a Google Maps API key provider, and a WP-CLI field-group sync command.

Three small pieces wired through `ConfigProvider` and driven by the `acf` config key:

- **`LocalJson`** — configures ACF's local-JSON load/save paths.
- **`GoogleApiKey`** — sets ACF's `google_api_key` setting (from config or the `GOOGLE_MAPS_API_KEY` constant).
- **`SyncFieldGroups`** — a `kaiseki acf-sync-field-groups` WP-CLI command that imports all local-JSON field groups into the database.

Installation
------------

[](#installation)

```
composer require kaiseki/wp-acf
```

Requires PHP 8.2 or newer. Expects the ACF (Pro) plugin to be active at runtime.

Usage
-----

[](#usage)

Register `ConfigProvider` with your laminas-style config aggregator and configure the `acf` key:

```
return [
    'acf' => [
        'local_json' => [
            'load_paths' => [
                get_stylesheet_directory() . '/acf-json',
            ],
            'save_path' => get_stylesheet_directory() . '/acf-json',
        ],
        'google_api_key' => 'AIza...', // or define('GOOGLE_MAPS_API_KEY', ...)
    ],
];
```

`ConfigProvider` registers factories for `LocalJson` and `GoogleApiKey`, and the `SyncFieldGroups`WP-CLI command as a hook provider. The Google API key can also come from the `GOOGLE_MAPS_API_KEY`constant, which takes precedence over the config value.

Sync local JSON field groups to the database:

```
wp kaiseki acf-sync-field-groups
```

Development
-----------

[](#development)

```
composer install
composer check   # check-deps, cs-check, phpstan
```

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance95

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% 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

Unknown

Total

1

Last Release

32d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1c3a6b11aea9668c9e9ca0c0f8515ef114d344acb552c695d715d35d5b388ea4?d=identicon)[woda](/maintainers/woda)

---

Top Contributors

[![davidmondok](https://avatars.githubusercontent.com/u/3883758?v=4)](https://github.com/davidmondok "davidmondok (16 commits)")[![wolfgangschaefer](https://avatars.githubusercontent.com/u/26325205?v=4)](https://github.com/wolfgangschaefer "wolfgangschaefer (6 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/kaiseki-wp-acf/health.svg)

```
[![Health](https://phpackages.com/badges/kaiseki-wp-acf/health.svg)](https://phpackages.com/packages/kaiseki-wp-acf)
```

###  Alternatives

[symfony/dependency-injection

Allows you to standardize and centralize the way objects are constructed in your application

4.2k455.6M9.6k](/packages/symfony-dependency-injection)[illuminate/contracts

The Illuminate Contracts package.

706130.3M13.3k](/packages/illuminate-contracts)[illuminate/container

The Illuminate Container package.

31182.0M2.4k](/packages/illuminate-container)[ecotone/ecotone

Enterprise architecture layer for Laravel and Symfony — CQRS, Event Sourcing, Durable Workflows (Sagas, Orchestrators), Projections, and Outbox messaging via PHP attributes.

564576.7k52](/packages/ecotone-ecotone)[symfony/type-info

Extracts PHP types information.

20069.8M270](/packages/symfony-type-info)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k43](/packages/civicrm-civicrm-core)

PHPackages © 2026

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