=== Marbak Multi Image Field for ACF ===
Contributors: marbak
Tags: acf, images, custom fields, media library, elementor
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a lightweight multi-image field type to Advanced Custom Fields using the native WordPress media library.

== Description ==

Marbak Multi Image Field for ACF adds a lightweight multi-image field to Advanced Custom Fields.

It focuses on a simple core workflow:

* Select multiple images from the WordPress media library
* Preview selected images inside the field
* Reorder images with drag and drop
* Remove images easily
* Return gallery values as Image Array, Image URL, or Image ID

Optional Elementor integration is included through a custom dynamic tag, allowing the field to be used with Elementor Pro gallery-capable widgets.

This plugin is designed as a clean addon field type for ACF. It does not replace ACF Pro features or attempt to duplicate the full ACF Pro Gallery field.

= Requirements =

* WordPress 6.0 or newer
* PHP 7.4 or newer
* Advanced Custom Fields plugin installed and active

== Installation ==

1. Upload the plugin folder to the `/wp-content/plugins/` directory, or install it through the WordPress plugins screen.
2. Activate the plugin through the `Plugins` screen in WordPress.
3. Make sure `Advanced Custom Fields` is installed and active.
4. Edit a field group and add the new `Marbak Multi Image` field type.

== Frequently Asked Questions ==

= Does this work without ACF? =

No. This plugin is an addon field type for Advanced Custom Fields and requires ACF to be active.

= Does this replace the Gallery field in ACF Pro? =

No. This is a separate lightweight field type built for simple multi-image selection in ACF free version.

= What does the field store? =

The field stores an ordered array of WordPress attachment IDs.

= What return formats are supported? =

You can return each selected image as:

* Image Array
* Image URL
* Image ID

= Does this work with Elementor? =

Yes. If Elementor Pro is active, the plugin adds a custom dynamic tag for gallery-capable Elementor widgets.

== Screenshots ==

1. Marbak Multi Image field type in ACF
2. Empty multi-image field in the post editor
3. Selecting multiple images from Media Library
4. Selected images preview inside the field

== Changelog ==

= 1.0.0 =
* Initial release
* Added Marbak Multi Image custom field type for ACF
* Added multi-image selection via WordPress media library
* Added preview thumbnails, remove action, and drag-and-drop ordering
* Added Image Array, Image URL, and Image ID return formats
* Added optional Elementor Pro dynamic tag support for gallery-capable widgets
