=== image² ACF Gallery Field ===
Contributors: image2
Tags: acf, gallery, elementor, custom fields
Requires at least: 6.0
Requires PHP: 7.4
Stable tag: 0.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds an ACF-compatible Gallery field type to ACF Free while preserving the native field type name "gallery" for drop-in compatibility with existing ACF Pro Gallery fields.

== Description ==

image² ACF Gallery Field is intentionally small. It supplies the Gallery field type that is otherwise available only in ACF Pro.

The plugin uses the native ACF field type name "gallery" and the same basic stored value shape (an ordered array of WordPress attachment IDs). Existing Gallery field definitions and values can therefore continue to work after moving from ACF Pro to ACF Free, provided this plugin is active.

ACF Free reserves "gallery" as a disabled Pro-only choice in its field type picker. For new fields, the plugin adds a selectable "Galerie" alias. When the field group is saved, that temporary alias is converted to the native field type "gallery". After reload, ACF Free may again label the saved type as "Galerie (Nur Pro)" in the field group editor; the field remains functional through this plugin.

The plugin intentionally stays idle while ACF Pro is active to avoid field-type collisions.

== Features ==

* Native field type name: gallery
* Existing ACF Pro Gallery field definitions remain compatible
* Ordered attachment-ID storage
* Add and remove images through the WordPress media library
* Add several images in one selection
* Drag-and-drop sorting
* Return formats: Image Array, Image ID, Image URL
* Preview image size
* Append or prepend new images
* Media library scope: all images or uploaded to the current post
* Minimum and maximum image count
* Minimum and maximum width and height
* Minimum and maximum file size
* Allowed file extensions
* Compatible with Elementor dynamic Gallery usage tested during development
* No migrations and no automatic rewriting of existing content

== Installation ==

1. Install and activate Advanced Custom Fields (Free).
2. Install and activate image² ACF Gallery Field.
3. Existing fields with type "gallery" are handled automatically.
4. To create a new Gallery field in ACF Free, select the additional selectable field type "Galerie". After saving the field group it is stored as type "gallery".

== Changelog ==

= 0.3.0 =
* Added a selectable admin alias for creating new Gallery fields in ACF Free.
* The alias is converted to the native "gallery" type when the field is saved.
* Changed the WordPress media frame to additive multi-selection for easier selection of several images.
* Removed the need for any DOM-based manipulation of ACF's disabled Pro-only Gallery picker entry.
* Kept the existing drop-in storage and Elementor compatibility behavior from 0.2.x.

= 0.2.0 =
* Added validation and field settings matching the ACF Pro Gallery schema used in compatibility testing.
* Added image constraints, library mode, insert mode and return formats.
* Stores attachment IDs as strings in the ordered array for legacy ACF Pro compatibility.

= 0.1.0 =
* Initial proof of concept.
