=== Block: Icons Font Awesome ===
Contributors: yukyhendiawan
Donate link: https://yukyhendiawan.com/
Tags: block, font awesome, icons, svg, gutenberg
Requires at least: 6.3
Tested up to: 6.8
Stable tag: 3.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Add and customize Font Awesome icons in the block editor — a lightweight Icon block that renders crisp inline SVG.

== Description ==

Block: Icons Font Awesome adds a single, focused **Icon block** to the WordPress block editor (Gutenberg). Pick from roughly 2,000 free Font Awesome 6 icons and drop them anywhere — no shortcodes, no page builder, no coding.

Icons render as **inline SVG**, so your site never loads the Font Awesome webfont or an extra stylesheet just to show an icon. That keeps pages fast and the markup clean.

= Features =

* **~2,000 free Font Awesome 6 icons** — Solid, Regular, and Brands.
* **Full-screen icon picker** with instant search (by name and keyword), a category sidebar with per-style counts, a style filter, and a "recently used" list.
* **Inline SVG output** — no webfont, no render-blocking icon CSS.
* **Styling controls** — color, hover color, size, and alignment.
* **Link support** — wrap the icon in a link, optionally opening in a new tab.
* **Accessibility** — mark an icon as decorative (hidden from screen readers) or give it a label; links always get an accessible name.
* **Global defaults** — a Settings page to set the default style, size, and color, and to choose which icon styles appear in the picker.

== Installation ==

1. Upload the plugin to the `/wp-content/plugins/` directory, or install it from **Plugins → Add New** in your dashboard.
2. Activate the plugin through the **Plugins** menu.
3. In the editor, add the **Font Awesome** block and click **Icon Library** to choose an icon.
4. (Optional) Visit **Icon Font Awesome → Settings** to set global defaults.

== Frequently Asked Questions ==

= Does this load the Font Awesome webfont on my site? =

No. Icons are saved as inline SVG, so the front end loads no Font Awesome CSS or webfont files.

= Which icons are included? =

The free Font Awesome 6 set — Solid, Regular, and Brands (about 2,000 icons).

= I used an older version of this plugin. Will my existing icons still work? =

Yes. Blocks created with the previous version are migrated automatically when you open the post in the editor. Re-save the post to update its front-end markup.

= Where do I set default colors and sizes? =

Under **Icon Font Awesome → Settings**, in the Block Defaults tab.

== Screenshots ==

1. The Icon block with the icon picker open.
2. Block controls: color, hover color, size, alignment, link, and accessibility.
3. The Settings page with global block defaults.

== Changelog ==

= 3.0.0 =
* Complete rewrite of the plugin.
* Icons now render as inline SVG — the Font Awesome webfont is no longer loaded on your site.
* New full-screen icon picker: search, category sidebar with counts, style filter (Solid, Regular, Brands), and recently used icons.
* New controls: color, hover color, size, alignment, link (with open-in-new-tab), and accessibility (decorative toggle or label).
* New Settings page for global defaults (default style, size, color) and the styles shown in the picker.
* Existing icon blocks are migrated automatically.

= 2.0.2 =
* Maintenance release.

== Upgrade Notice ==

= 3.0.0 =
Major update: the icon block has been rebuilt and icons now render as inline SVG. Existing icons are migrated automatically — review your content after updating.