Download the PHP package boxuk/wp-iconography without Composer
On this page you can find all versions of the php package boxuk/wp-iconography. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download boxuk/wp-iconography
More information about boxuk/wp-iconography
Files in boxuk/wp-iconography
Package wp-iconography
Short Description Adds Material Icons to the Block Editor
License
Informations about the package wp-iconography
Box WordPress Iconography Support
Add the ability to add icons inline to your content in the WordPress block editor.
Quick Start!
Add this plugin to your WordPress site and include a configuration file and it's ready to use!
If you're using composer, then it's as simple as composer require boxuk/wp-iconography
.
Configuration
Configuration files are based on a schema that allows you to quickly define the configuration.
They're loaded automatically from wp-content/themes/{theme_name}/icons/*.config.json
, or you can define any custom paths using the filter available:
There's also example configuration files included in the plugin, so if you want to load Material Symbols you can just load the config included using this snippet:
There's loads of filters available to change the way icons load, so feel free to look through the source code at the available filters. And if there's function that doesn't work for you, PRs are always welcome!
Configuration Schema
The Schema for configuration includes:
- Title - the name output in the editor.
- Name - the unique key/name for the icon set. I'd recommend
namespace/name
format. - Tag Name - this is the HTML tag that will be used to generate the output for the icon.
- Class Name - this is used to generate the output for the icon
- URL - the CSS file to load
- Additional CSS - any inline CSS to include that might be relevant.
- Icons - an array of:
- Label - the value to use in the admin interface. Used for searches and is displayed on hover.
- Content - the content inside the HTML generated.
Sample JSON file:
Generated output:
Contributing
Please do not submit any Pull Requests here. They will be closed.
Please submit your PR here instead: https://github.com/boxuk/wp-packages
This repository is what we call a "subtree split": a read-only subset of that main repository. We're looking forward to your PR there!