=== Maple Icons ===
Contributors: jetrails
Tags: icons, svg, gutenberg, block, heroicons, lucide, feather, phosphor, material
Requires at least: 6.5
Tested up to: 6.7
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Insert beautiful open-source icons into your content with a Gutenberg block. Download icon sets from CDN and serve locally.
== Description ==
Maple Icons provides a simple way to insert high-quality, open-source icons into your WordPress content using the Gutenberg block editor.
= Features =
* **Multiple Icon Sets** - Choose from popular open-source icon libraries:
* Heroicons (~290 icons) - MIT License
* Lucide (~1400 icons) - ISC License
* Feather (~287 icons) - MIT License
* Phosphor (~1200 icons per style) - MIT License
* Material Symbols (~400 icons) - Apache 2.0 License
* **Local Storage** - Icons are downloaded from CDN and stored locally in your WordPress installation. No external requests are made when displaying icons on your site.
* **Gutenberg Block** - Easy-to-use block with:
* Search and filter icons
* Multiple style variants per set
* Size control (12px - 256px)
* Custom icon color
* Background color
* Padding and margin controls
* Stroke width adjustment
* Drop shadow effect
* **Performance Optimized**
* Icons are inline SVG - no additional HTTP requests
* No frontend JavaScript or CSS
* Works in RSS feeds and email
* **Accessible**
* Decorative icons automatically hidden from screen readers
* Optional accessible labels for meaningful icons
* Follows WCAG guidelines
= How It Works =
1. Go to Settings → Maple Icons
2. Download one or more icon sets
3. Set one icon set as active
4. In the Gutenberg editor, add a "Maple Icon" block
5. Search and select an icon
6. Customize size, color, and other settings
= Icon Storage =
Downloaded icons are stored in `wp-content/maple-icons/`. Each icon set is stored in its own subdirectory with the SVG files organized by style.
= Compatibility =
* WordPress 6.5+
* PHP 7.4+
* WooCommerce (HPOS compatible)
* Works with all properly coded themes
* Compatible with popular page builders that support Gutenberg blocks
== Installation ==
1. Upload the `maple-icons` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings → Maple Icons to download icon sets
4. Start using the "Maple Icon" block in your content
== Frequently Asked Questions ==
= Are the icons free to use? =
Yes! All icon sets included are open-source with permissive licenses (MIT, ISC, or Apache 2.0) that allow commercial use.
= Can I use multiple icon sets? =
You can download multiple icon sets, but only one can be active at a time. The active set is what appears in the Gutenberg block icon picker.
= Where are the icons stored? =
Icons are downloaded from CDN (jsdelivr.net) and stored locally in `wp-content/maple-icons/`. Once downloaded, no external requests are made to display icons.
= How do I change the icon color? =
Icons automatically inherit the text color from your theme. You can also set a custom color in the block settings panel.
= Will icons work in RSS feeds? =
Yes! Icons are saved as inline SVG in your post content, so they work in RSS feeds, email newsletters, and anywhere else your content is displayed.
= What happens if I uninstall the plugin? =
Existing icons in your content will remain as inline SVG. However, you won't be able to add new icons or use the block settings. The downloaded icon files in `wp-content/maple-icons/` will be removed on uninstall.
= Is this plugin GDPR compliant? =
Yes. Maple Icons does not collect any user data, set cookies, or make external requests after icons are downloaded. All icon files are stored locally on your server.
== Screenshots ==
1. Settings page - Download and manage icon sets
2. Icon picker modal in Gutenberg editor
3. Block settings panel with customization options
4. Icon block rendered on the frontend
== Changelog ==
= 1.0.0 =
* Initial release
* Support for Heroicons, Lucide, Feather, Phosphor, and Material Symbols
* Gutenberg block with full customization options
* Local icon storage
== Upgrade Notice ==
= 1.0.0 =
Initial release of Maple Icons.
