cloakwp/acf-abstractions

A set of OOP abstractions around ACF to improve developer experience.

Maintainers

Details

github.com/cloak-labs/acf-abstractions

Source

Issues

Installs: 21

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 0

Forks: 0

Open Issues: 0

Type:wordpress-plugin

0.0.6 2025-02-17 21:25 UTC

Requires

LGPL-3.0-only 513d852e1a5369d6af9332ad860883b30f190d64

This package is auto-updated.

Last update: 2025-02-17 21:25:24 UTC

README

A set of OOP abstractions around ACF to improve developer experience.

This package is meant to be used alongside the wonderful vinkla/extended-acf package, which provides OOP abstractions for registering fields. This package simply extends that package with some useful extras:

  • Register ACF Groups with the FieldGroup class (a wrapper around vinkla/extended-acf's register_extended_field_group function)
  • Register ACF Blocks with the Block class (all registered block instances become accessible via the BlockRegistry singleton)
  • Register ACF Options Pages with the OptionsPage class
  • Some useful, special fields that extend ACF's built-in field types:
    • InnerBlocks - An auto-populated ACF Flexible Content field enabling you to select/arrange ACF blocks (assuming you register your ACF blocks via this package's Block class). Assigning InnerBlocks as a field of an ACF block enables nesting blocks within each other for powerful block composability. You can control which blocks are available for selection on a per-instance basis via the includes and excludes methods.
    • HorizontalAlignment - An auto-populated ACF Button Group field with options for left, center, right, and justify (displayed as icons). You can control which of those 4 options are available on a per-instance basis.
    • VerticalAlignment - An auto-populated ACF Button Group field with options for top, center, and bottom (displayed as icons). You can control which of those 3 options are available on a per-instance basis.
    • MenuSelect - An auto-populated ACF Select field allowing you to select a registered WordPress menu.
    • PostTypeSelect - An auto-populated ACF Select field allowing you to select a registered WordPress post type.
    • ThemeColorPicker - An auto-populated ACF Radio Button field allowing you to select a color from the active theme's theme.json color palette, with special CSS styling to mimic the built-in Gutenberg color picker.
    • ResponsiveField - Enable screen breakpoint-specific values for any ACF field by simply wrapping it in a ResponsiveField instance (eg. ResponsiveField::make(Number::make('Gap'))). Under-the-hood, it uses a Group and set of Tab fields, and duplicates the provided field for each breakpoint tab. The resulting value output is your_field_name: { mobile: '1', tablet: '2', tablet_wide: '3', laptop: '4', desktop: '5', desktop_wide: '6' }. You can define which breakpoints are available on a per-instance basis.

Installation

composer require cloakwp/acf-abstractions

Usage

Docs coming soon -- for now, see the source code of this package's src directory; it's mostly self-documenting.