=== Ably Custom Icon Field for ACF ===
Contributors: ablyperu
Tags: acf, icons, custom field, icon picker, ably peru
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.0.6
License: GPL-2.0+

Ably Custom Icon Field for ACF adds a visual custom field for selecting uploaded icon classes in Advanced Custom Fields (ACF).

== Description ==

Ably Custom Icon Field for ACF adds a custom field type for Advanced Custom Fields (ACF) with a visual icon picker:

* **Visual grid**: Display imported icons in a searchable modal.
* **Live search**: Filter icons by label or CSS class.
* **Multiple collections**: Import, review, and remove multiple IcoMoon ZIP collections.
* **Safe field values**: Validate selected icon classes against the available icon list.

== External icon fonts ==

External icon libraries are optional. The plugin does not bundle third-party icon fonts. Administrators may provide authorized CDN URLs in the plugin settings and are responsible for complying with the applicable license terms.

== Installation ==

1. Upload the `ably-custom-icon-field-for-acf` folder to `/wp-content/plugins/`.
2. Activate the plugin from the WordPress Plugins screen.
3. Install and activate Advanced Custom Fields (ACF).
4. Go to **Custom Icons > General Settings** and import an IcoMoon ZIP export.

You can import multiple ZIP collections. Imported fonts and icon classes are kept together, and each collection can be removed from the settings page when it is no longer needed.

The settings page shows the imported ZIP name, import date, and icon count.

== Usage ==

1. Go to ACF > Field Groups.
2. Add a field and select the "Ab Icon" field type.
3. Choose the return format: CSS class or HTML.

=== In templates ===

**Class format:**
```php
<?php $icon = get_field('my_icon'); ?>
<i class="<?php echo esc_attr($icon); ?>"></i>
```

== Changelog ==

= 2.0.4 =
* Added a responsive administration interface.
* Added multiple IcoMoon collection management.
* Added icon copy actions and collection deletion controls.

= 1.0.0 =
* Initial release for Ably Peru.
* Added a compact visual icon picker.
