=== Leshaabr Flexible Page Builder for ACF PRO ===
Contributors: leshaabr
Donate link: https://oleksii-abrosimov.com/flexible-page-builder-for-acf-pro/
Tags: acf, advanced-custom-fields, page-builder, layout-builder, content-builder
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Flexible Page Builder for ACF PRO. Build reusable page sections and layouts, while keeping the backend clean and lightweight.

== Description ==

Leshaabr Flexible Page Builder for ACF PRO adds a reusable, section-based page builder on top of the Advanced Custom Fields PRO flexible content field.

**Important: This plugin requires Advanced Custom Fields PRO 6.0+ and does not include ACF PRO. You must have a valid ACF PRO license and plugin installed and activated.**

### Pricing and add-ons

- The **core plugin** is completely **free**.
- The plugin includes **three free starter add-ons** out of the box, so you can build real layouts without any additional purchases:
  - **Hero** – banners grid or slider for prominent page headers and hero sections.
  - **Rows** – flexible rows with text content and image, ideal for feature sections and info blocks.
  - **Icons** – grid or slider of icons with text, perfect for services, features, or highlights.
- Additional, optional **premium add-ons** for more advanced layouts and use cases are available on the developer's website:
  https://oleksii-abrosimov.com/flexible-page-builder-for-acf-pro/

The free core + three bundled add-ons provide a usable builder on their own. Premium add-ons are entirely optional and extend the functionality for more complex projects.

### Key Features

* Uses ACF PRO flexible content to build reusable sections.
* Simple, lightweight backend UI focused on content structure.
* Includes three free starter add-ons/sections (Hero, Rows, Icons) ready to use.
* Additional premium add-ons available on the author's website for advanced layouts and specific use cases.
* Reusable layouts/sections that can be imported and activated from the plugin admin.
* Optional basic styling included so everything looks clean out of the box.
* Front-end rendering is theme-friendly and easy to style with your own CSS.
* Designed for performance – no heavy visual builder overhead.
* Basic styling included.

### External services used

- **Vimeo API** (thumbnail fetching): Used optionally when video backgrounds are configured. Sends only the public Vimeo video URL to retrieve thumbnail image. No personal data sent.
  [Vimeo Terms](https://vimeo.com/terms) | [Vimeo Privacy](https://vimeo.com/privacy)

- **YouTube API** (thumbnail fetching): Used optionally when YouTube video backgrounds are configured. Sends only the public YouTube video URL to retrieve thumbnail image. No personal data sent.
  [YouTube Terms](https://www.youtube.com/t/terms) | [Google Privacy](https://policies.google.com/privacy)

- **Fancybox**: Used for images previews. No personal data sent.
  [Fancybox License](https://fancyapps.com/fancybox/license)



### Who is it for?

* Developers who build custom themes with ACF PRO.
* Agencies who want reusable section layouts across projects.
* Site owners who prefer structured content blocks over drag-and-drop builders.

### Demo video

Watch a short demo of Leshaabr Flexible Page Builder for ACF PRO:
https://www.youtube.com/@leshaabr

== Screenshots ==

1. Flexible Page Builder sections list in the WordPress admin (installed sections and add-ons).
2. Editing a single section layout with ACF PRO fields.
3. Example front-end page composed from multiple reusable sections (Hero, Rows, Icons).
4. Settings page with basic styling and options enabled.
5. Importing additional add-ons from a ZIP file.

== Installation ==

1. Make sure you have **Advanced Custom Fields PRO 6.0 or higher** installed and activated.
2. Upload the plugin files to the `/wp-content/plugins/leshaabr-flexible-sections-builder-for-acf-pro` directory,
   or install it through the WordPress "Plugins → Add New" screen.
3. Activate the plugin through the "Plugins" screen in WordPress.
4. On first activation, the plugin will import default ACF field group with the three sections.
5. Open any page or post where the flexible fields are assigned and use the "Flexible Page Builder" sections to build your layout.
6. Place the display function in your theme template (`single.php`, `page.php` etc.):
    if ( function_exists( 'leshaabr_flexible_fields' ) ) leshaabr_flexible_fields();

== Changelog ==

= 1.1 =
* Added support for theme templates overrides
* Minor improvements

= 1.0 =
* Initial release.
* Core Flexible Page Builder integration with ACF PRO flexible content.
* Basic styles option and default sections import.
* Three free starter add-ons bundled with the plugin (Hero, Rows, Icons).