log1x/acf-editor-palette

There is no license information available for the latest version (v1.2.0) of this package.

A replica Gutenberg color picker field for Advanced Custom Fields.

Fund package maintenance!
log1x

Installs: 168 508

Dependents: 0

Suggesters: 0

Security: 0

Stars: 95

Watchers: 9

Forks: 14

Open Issues: 7

Type:wordpress-plugin

v1.2.0 2024-07-24 14:50 UTC

README

Latest Stable Version Total Downloads Build Status

A Gutenberg-like editor palette color picker field for Advanced Custom Fields.

Field Example

Features

  • Colors are automatically loaded from theme.json and/or the editor palette.
  • Return format includes the default palette keys as well as background and text color classes for convenience.
  • Default value can optionally be set using the color's slug.
  • Colors can optionally be allowed/excluded from the palette.

Requirements

Installation

Bedrock

Install via Composer:

$ composer require log1x/acf-editor-palette

Manual

Download the latest release .zip and install into wp-content/plugins.

Usage

Field Group Example

^ array:5 [▼
  "name" => "Green (500)"
  "slug" => "green-500"
  "color" => "#0e9f6e"
  "text" => "has-text-color has-green-500-color"
  "background" => "has-background has-green-500-background-color"
]

ACF Composer

If you are on Sage 10 and using my ACF Composer package:

$field
  ->addField('my_color_field', 'editor_palette')
    ->setConfig('default_value', 'green-500')
    ->setConfig('allowed_colors', ['green-500', 'blue-500'])
    ->setConfig('exclude_colors', ['green-50', 'green-100'])
    ->setConfig('return_format', 'slug');

Bug Reports

If you discover a bug in ACF Editor Palette, please open an issue.

Contributing

Contributing whether it be through PRs, reporting an issue, or suggesting an idea is encouraged and appreciated.

License

ACF Editor Palette is provided under the MIT License.