This plugin is a WordPress implementation of a selection of Double-E Design's Comet Components library for use as ACF Flexible Content modules.
This plugin provides default fields, template parts, CSS, and occasionally JS for their output as per the Comet Components library. Some filter hooks are provided to enable some theme-level customisation without having to override entire templates, remove actions, run duplicate functions at higher priority, etc.
Usage with the Comet Canvas (Classic) theme as a parent theme is also recommended as this provides even more integration with Comet Components for a clean and consistent experience for both users and admins. This plugin has not been tested with themes other than Comet Canvas (Classic) and custom themes based on it.
You might also be interested in using Double-E Design's ACF Dynamic Preview plugin, which this plugin is designed to be compatible with.
:::warning
Use the get_*_modules filters with extreme caution. Renaming or removing fields will remove them and/or their current data from the UI, but will not remove it from the database. The intention of these hooks is primarily to allow themes to add fields and options.
:::
| Filter | Provides theme-level customisation of... |
|---|---|
comet_acf_get_basic_modules |
the ACF fields for the basic page layout modules. |
comet_acf_get_complex_modules |
the ACF fields for the page layout modules that contain repeaters with nested flexible modules. |
comet_acf_get_nestable_modules |
the modules that can be used within modules with nested repeaters (e.g. accordions). |
comet_acf_flexible_modules_post_types |
the post types that the provided flexible modules are enabled for. |
comet_acf_flexible_content_is_nested |
whether a given top-level flexible content module should be treated as nested at render time. For example, if a theme's single post template has a single wrapping container, top-level modules should be treated as nested to avoid duplicate containers. Arguments are $isNested, $layout, and $post_id so you can easily check context like post type and module (layout) type. |
If you're reading this from GitHub, you're seeing the mirror of the Comet Components WordPress ACF Plugin package that is here for the purposes of publishing to Packagist and installing via Composer.
Development of this project belongs in the main Comet Components monorepo.
When working on this plugin within the monorepo, use composer.local.json so that symlinked local packages are used:
$env:COMPOSER = "composer.local.json"; composer update --prefer-source