=== LolaCore for ACF ===
Contributors: vanguardhive
Tags: acf, custom fields, ai assistant, ai automation, lola
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build and fill ACF field groups, fields, post types and values by asking Lola in wp-admin. She previews every change before writing it. 30 abilities.

== Description ==

Setting up custom fields in ACF is a click marathon. New group, add a field, pick the type, set the location rules, repeat for every field, then go post by post entering the values. On a real content model that is an afternoon lost to the admin screen, and changing a field type later means digging back into the group editor to do it all again.

LolaCore for ACF moves that work into a sentence. Ask Lola to create a field group for your products with SKU, weight, dimensions and a gallery, assign it to the product post type, and set the SKU on a specific post. She reads what already exists, builds what is missing, and shows you exactly what she is about to change before she touches the database.

Because LolaCore keeps memory of your site, the next request builds on the last one. Lola already knows your field structure, so you stop re-explaining it every time.

It needs [LolaCore](https://wordpress.org/plugins/lolacore) and Advanced Custom Fields (Free or Pro) active on the same site.

For a full walkthrough with examples, see [lolacore.com/lolacore-for-acf](https://lolacore.com/lolacore-for-acf).

= 30 abilities across six areas =

Field groups (7 abilities)

* List, get, create, update, delete, duplicate, and toggle the active status of ACF field groups.
* Location shortcuts accept `post_type`, `page_template`, `user_role`, `options_page`, and `post_taxonomy`.
* Export any field group as JSON for backups or moving it to another site.

Fields (5 abilities)

* List the fields inside a group, inspect field type schemas, and add, update or delete field definitions.
* Field types are validated against your ACF edition before anything is written.

Values (5 abilities)

* Read and write stored field values on posts, users, terms, and options.
* Fetch a single value, every value on an object, or the full field object before you write.

Custom post types (4 abilities)

* List, create, update, and delete the custom post types ACF manages: movies, events, properties, recipes, anything your site tracks as its own kind of content.

Custom taxonomies (4 abilities)

* List, create, update, and delete custom taxonomies, and link them to the right post types when Lola creates them.

Options pages (4 abilities, ACF Pro)

* List, create, update, and delete ACF options page definitions for site-wide settings such as a logo, social links, or footer text.
* These four activate automatically when Lola detects ACF Pro. With ACF Free the addon exposes 26 abilities; with ACF Pro, 30.

= You approve before anything changes =

Every mutating action runs through LolaCore's dry-run flow. Lola states what she is about to do and waits. You approve or you cancel. Nothing is written to your site until you say so, which matters when one bad edit to a field group can break how your content displays.

= It runs inside your WordPress admin =

You work with Lola in the LolaCore chat in wp-admin, the panel you already use. You describe what you want in plain language, she picks the right tool and fills the parameters, and you watch each change land instead of switching to an outside app to check whether it worked.

= Third-party addon, not affiliated with ACF =

LolaCore for ACF is built by LolaCore. It is not affiliated with, endorsed by, or sponsored by WP Engine or Advanced Custom Fields. "ACF" and "Advanced Custom Fields" are trademarks of WP Engine. You install Advanced Custom Fields separately, either the Free version from the WordPress.org directory or ACF Pro under your own license.

= What you need =

* WordPress 7.0+
* PHP 8.1+
* [LolaCore](https://wordpress.org/plugins/lolacore), active
* [Advanced Custom Fields](https://wordpress.org/plugins/advanced-custom-fields/) or ACF Pro, active

ACF Pro is optional. The four options page abilities and Pro-only field types such as gallery, repeater, flexible content and clone become available automatically when Lola detects that Pro is active.

== Installation ==

1. Install and activate [LolaCore](https://wordpress.org/plugins/lolacore) and Advanced Custom Fields (Free or Pro).
2. Upload the `lolacore-for-acf` folder to `wp-content/plugins/`, or install the ZIP from Plugins → Add New → Upload Plugin.
3. Activate LolaCore for ACF from the Plugins screen.
4. Open the Lola chat in wp-admin. The ACF domain appears on its own with all abilities ready.

No extra configuration. No API keys for this addon.

== Frequently Asked Questions ==

= Do I need LolaCore to use this? =

Yes. This addon adds ACF abilities to LolaCore. It does not run on its own. Install and activate LolaCore first.

= Do I need ACF Pro? =

No. The 26 Free abilities handle field groups, fields, values, custom post types, taxonomies and export out of the box. ACF Pro adds the four options page abilities and Pro-only field types (gallery, repeater, flexible content, clone), for 30 total. Pro features are rejected with a clear message when only ACF Free is installed.

= Is this an official ACF plugin? =

No. It is a third-party addon by LolaCore. ACF is a product of WP Engine, and we are not affiliated with them or the ACF team.

= Does this addon send my data anywhere? =

No. Every operation runs inside your WordPress installation through the ACF PHP API. When you chat with Lola, your messages go to the AI provider you configured in WordPress (Settings → Connectors). This addon only connects ACF to LolaCore's action system.

= What happens if I deactivate ACF? =

The addon shows an admin notice and stops registering its abilities until Advanced Custom Fields is active again. No fatal errors.

= Will it do more later? =

Yes. Each release widens what Lola can do with ACF. Tell us what you model most and it shapes what comes next.

== Changelog ==

= 1.1.0 =
* Added custom post types: list, create, update, delete (4 abilities).
* Added custom taxonomies: list, create, update, delete, with post type linking (4 abilities).
* Added ACF Pro options pages: list, create, update, delete (4 abilities, activate when Pro is detected).
* Added field group export to JSON for backups and site-to-site migration.
* Total abilities: 26 with ACF Free, 30 with ACF Pro.

= 1.0.0 =
* Initial public release.
* 17 ACF abilities: 7 for field groups, 5 for fields, 5 for values.
* LolaCore chat integration with dry-run confirmation on every write.
* Field type validation for ACF Free and Pro editions.
* Location rule shortcuts for common assignment patterns.

== Upgrade Notice ==

= 1.1.0 =
Adds custom post types, taxonomies, ACF Pro options pages, and field group export. 30 abilities total.

= 1.0.0 =
First release. Requires LolaCore and Advanced Custom Fields.
