=== Icon List Block ===
Contributors: snehalpancholi
Tags: gutenberg, block, icon list, svg icons, list block
Requires at least: 6.2
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A Gutenberg block for creating beautiful icon-enhanced lists with 20 built-in SVG icons, colour controls, and vertical/horizontal layout options.

== Description ==

**Icon List Block** adds a fully-featured Gutenberg block that lets you build styled icon lists without writing a single line of HTML or CSS. Pick from 20 hand-crafted inline SVG icons, set the icon colour, control the size of icons and text, adjust the spacing between items, and switch between vertical stacking or a wrapping horizontal pill layout — all from the native block editor.

**Key Features**

* 20 built-in inline SVG icons — check, star, heart, bolt, fire, target, thumbs-up, lock, globe, clock, calendar, mail, phone, tag, gift, and more
* Per-item icon selection directly in the editor
* Rich text editing per item (bold, italic, link supported)
* Icon colour picker with live preview
* Icon size control (12 px – 48 px)
* Item spacing control (4 px – 48 px)
* Text size control (12 px – 32 px)
* Vertical and horizontal (wrapping flex) layout modes
* Dynamic server-side rendering — always reflects the latest icon SVG
* Zero build-step JavaScript — works out of the box
* Accessibility-ready: icons use `aria-hidden="true"`
* Fully responsive CSS using CSS custom properties

**Use Cases**

* Feature comparison lists
* Pricing table bullet points
* Step-by-step guides
* Benefits sections on landing pages
* FAQ summaries
* About-page highlights

== Installation ==

1. Upload the `icon-list-block` folder to `/wp-content/plugins/`.
2. Activate the plugin through **Plugins › Installed Plugins**.
3. Open any post or page in the block editor.
4. Search for **"Icon List"** in the block inserter (the + button).
5. Insert the block and customise your list in the editor.

== Frequently Asked Questions ==

= Does this plugin require a build step or Node.js? =

No. The editor JavaScript is plain ES6 that runs directly in the browser. You do not need Node, npm, or webpack to use or modify the plugin.

= Can I add my own icons? =

In version 1.0 the icons are hard-coded in `icon-list-block.php` inside `addlc_ilb_get_icon()`. Developers can add new entries to the `$icons` array and register matching options in the editor's icon dropdown.

= Will my lists break if I deactivate the plugin? =

The block stores its data as block attributes in post content. If the plugin is deactivated, WordPress will render the block as an "unknown block" comment and your raw content is preserved. Reactivating the plugin immediately restores the rendered output.

= Is the output accessible? =

Yes. Icon `<span>` elements carry `aria-hidden="true"` so screen readers skip the decorative SVG and read only the text content.

= Can I use this in FSE / Full Site Editing themes? =

Yes. The block is a standard dynamic Gutenberg block and works in any context that supports the block editor, including template editing in FSE themes.

== Screenshots ==

1. **Vertical list** — A four-item vertical icon list with custom icon colour in the editor.
2. **Horizontal layout** — Items displayed as a wrapping row of icon-text pairs.
3. **Inspector Controls** — Colour picker, size controls, spacing, and layout selector in the sidebar.
4. **Icon selector** — Per-item dropdown showing all 20 available icons.
5. **Frontend rendering** — Clean, lightweight output on the published post.

== Changelog ==

= 1.0.0 =
* Initial release.
* 20 inline SVG icons.
* Vertical and horizontal layout modes.
* Per-item icon selector and rich-text editing.
* CSS custom properties for all visual controls.
* Dynamic server-side rendering.

== Upgrade Notice ==

= 1.0.0 =
Initial release — no upgrade steps required.
