=== Visual Picker for ACF Flexible Content ===
Contributors: gmnuriddin
Donate link: https://buymeacoffee.com/gmnuriddin
Tags: acf, flexible content, custom fields, layouts, page builder
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Replace the ACF Flexible Content layout dropdown with a visual picker — preview layouts as cards, search them, and add one or many with a click.

== Description ==

**The Problem:** ACF Flexible Content Dropdown Being Hard to Use with Complex Layouts.
**The Solution:** This Visual Picker Plugin Which Enables You to Freely Choose Layouts by Previewing their Images, Titles and Descriptions.

**Premium Features (Free):** 
* **Multi-selection:** You can select multiple layouts and add them at once;
* **Re-ordering:** You can re-order selected layouts before inserting them;
* **Search:** You can search and find layouts quickly before you add them;

https://www.youtube.com/watch?v=WGZNCLoG8Lo

= Requirements =

This plugin extends the **Flexible Content** field, which is part of **Advanced Custom Fields PRO**. ACF PRO 6.0 or later must be installed and active.

== Installation ==

1. Install and activate **Advanced Custom Fields PRO** (6.0+).
2. Install this plugin through the Plugins screen, or upload the ZIP.
3. Activate it. You'll be taken to the settings page on first activation.
4. Open any Flexible Content field in the ACF field group editor and set an image, title, and description for each layout.
5. When editing a post or page, click "Add Layout" to open the picker modal.

== Frequently Asked Questions ==

= Does this require ACF PRO? =

Yes. The Flexible Content field is a PRO-only feature of Advanced Custom Fields, so ACF PRO 6.0 or later must be active.

= Does it work with the free version of ACF? =

No — Flexible Content is not available in the free version of ACF, so this plugin needs ACF PRO.

= How many layouts can I use? =

As many as your field defines. Click a card to add a single layout, or use the numbered badges to select several and add them all at once — subject to whatever maximum the field itself sets.

= How do I add more than one layout at a time? =

In the picker modal, hover a card and click its circular badge to select it. The badge shows the position it will be added in. Select as many as you like, optionally click "Reorder Selected" to drag them into a different order, then click "Add selected".

= Where do the thumbnails and descriptions come from? =

You set them per layout inside the ACF field group editor, in the field's settings panel.

= Is there a paid version? =

No. Everything the plugin does is included here for free.

== Screenshots ==

1. The layout picker — every layout shown as a card with its thumbnail, title, and description.
2. Multi-select — numbered badges show the order the layouts will be added in.
3. Reorder mode — drag your selection into the exact order you want before inserting.
4. Instant search — type to filter the layouts, with matching text highlighted.
5. The layout preview thumbnail shown inside each row while editing a page.
6. Setting a thumbnail, title, and description for each layout in the ACF field group editor.

== Changelog ==

= 1.1.2 =
* Documentation updates.

= 1.1.1 =
* Documentation and plugin directory listing updates only. No functional changes.

= 1.1.0 =
* All previously separate premium features are now included for free: instant search with highlighted matches, multi-select with batch add, and drag-to-reorder before inserting.
* The settings page now lists the included features instead of pointing to a paid add-on.
* No changes to layout metadata, storage, or the developer filter — existing field configuration is untouched.

= 1.0.0 =
* First release. A visual modal picker for ACF Flexible Content: preview each layout as a card with a thumbnail, title, and description, then add it with a click.

== Upgrade Notice ==

= 1.1.2 =
Documentation updates.

= 1.1.1 =
Documentation and listing updates only. No functional changes.

= 1.1.0 =
Search, multi-select batch add, and drag-to-reorder are now included for free. No settings or data changes required.

= 1.0.0 =
First release of Visual Picker for ACF Flexible Content.
