Alexander Lueken

e.nigma buttons is a lightweight plugin that adresses a common problem that applies to many WordPress users: Visually highlight a link (e.g. a download link). One great solution is the use of buttons
The purpose of a button is clear. You press that button and something happens. This is a well known principle that most users are aware of. In contrast to regular text links (e.g. a download link), buttons are more likely to be noticed, especially if you use them in combination with an icon.
e.nigma buttons allows you to easily create those visually attractive buttons using a simple shortcode environment.
Development of the plugin is an open process. The current version is available on github:
https://github.com/chemiker/enigma-buttons
Feel free to contribute and to fix errors or send improvements via github.
<h3>Shortcodes & Attributes</h3>
e.nigma buttons adds the shortcode <code>[button]</code> to your installation. The following options can be used to adjust the button for your needs:
<ul>
<li><code>label</code>: The label of your button</li>
<li><code>icon</code>: The icon of your button</li>
<li><code>link</code>: The link of your button</li>
<li><code>color</code>: The color of button</li>
<li><code>border</code>: yes (default) or no</li>
<li><code>size</code>: small, medium (default) or large</li>
<li><code>class</code>: Additional CSS classes that will be added to your buttons icon</li>
</ul>
Most of the shortcodes attributes are self explaining. However, it must be noted that the <code>icon</code> attribute can be filled by using modififed <a href="http://fontawesome.io/icons/" rel="nofollow ugc">Font Awesome shortcodes</a>.
For instance: If you want to use the GitHub icon you would search for that icon in the <a href="http://fontawesome.io/icons/" rel="nofollow ugc">list of all icons</a>. What you will find is the corresponding CSS class. For e.nigma buttons the name of the icon (which is obtained if stripping the “fa-” in the beginning of the CSS class) is used. For GitHub the CSS class would be <code>fa-github</code>. Thus, <code>github</code> is your value for the <code>icon</code> attribute.
<h4>Colors</h4>
The following colors are avaible: 
* green 
* orange 
* purple 
* cyan 
* white 
* red 
* black
In addition to those values you can also use a hex color code (e.g. #ff3600)
<h4>Icons</h4>
e.nigma buttons uses <a href="http://fontawesome.io/" rel="nofollow ugc">Font Awesome</a> by Dave Gandy as icon resource. <a href="http://fontawesome.io/icons/" rel="nofollow ugc">An overview over all available icons</a> can be found on their website.
<h4>Examples</h4>
<pre><code>[button label="My GitHub account" icon="github" color="orange" link="https://github.com/chemiker"]
</code></pre>
Brings you an linked, medium-sized, orange button that has a GitHub icon and the label “My GitHub account”.
<pre><code>[button icon="github" color="orange" link="https://github.com/chemiker" size="large"]
</code></pre>
Brings you an orange, large-sized, linked GitHub icon.

e.nigma buttons

e.nigma buttons allows you to easily add buttons to your posts, pages etc.

Joris van Montfort

Add icons to any rich text field in the WordPress block editor. Insert icons inline in paragraphs, headings, lists, buttons, or use the dedicated single icon block.
<h4>Features</h4>
<ul>
<li>Icon picker – Select icons from a searchable popup in the block editor toolbar.</li>
<li>Font Awesome included – Ships with Font Awesome 4.7, 5.x and 6.x. Choose your preferred version from the settings.</li>
<li>Custom SVG icon set – Upload your own SVG icons via a drag & drop uploader in the plugin settings. This is the recommended approach for the best performance.</li>
<li>Single icon block – A dedicated block with font size, color, alignment and spacing options.</li>
<li>ACF integration – Adds a “JVM Icon” field type for Advanced Custom Fields.</li>
</ul>
<a href="https://nl.wordpress.org/plugins/jvm-rich-text-icons/?preview=1" rel="nofollow ugc">See it in action</a>
<h4>How it works</h4>
Pick an icon from the toolbar while editing any rich text field. The plugin inserts a small HTML tag that gets styled by the chosen icon set.
<h4>Why use a custom SVG icon set?</h4>
When you use a custom SVG icon set, the plugin defaults to inline SVG rendering. This is a great choice for performance! Google PageSpeed Insights will thank you.
<ul>
<li>Better page speed – No render-blocking CSS or font files to download. Icons are part of the HTML itself.</li>
<li>Only loads what you use – Unlike Font Awesome which loads CSS for hundreds of icons, inline SVG only includes the icons that are actually on the page.</li>
<li>No external requests – Everything is served inline, so there are no extra HTTP requests for font or CSS files.</li>
<li>Inherits text color – Icons automatically use the surrounding text color, no extra CSS needed.</li>
<li>Fully reversible – The stored content in the database is not modified. You can switch between render technologies at any time from the plugin settings if you want to.</li>
</ul>
Alternative render technologies (CSS masks, ::before / ::after pseudo-elements) are also available for custom SVG icons if your use case requires it.
<h4>For developers</h4>
The plugin provides several filter hooks to customize its behavior. You can load your own icon set, CSS file, or change the icon class prefix.
Load a custom icon set file
<pre><code>add_filter( 'jvm_richtext_icons_iconset_file', function($file) {
 return get_stylesheet_directory() . '/path_to_my/icons.json';
});
</code></pre>
Load a custom CSS file
<pre><code>add_filter( 'jvm_richtext_icons_css_file', function($cssfile) {
 return get_stylesheet_directory_uri() . '/path_to_my/cssfile.css';
});
</code></pre>
To disable the default CSS file entirely:
<pre><code>add_filter( 'jvm_richtext_icons_css_file', '__return_false');
</code></pre>
Change the icon class prefix
<pre><code>add_filter( 'jvm_richtext_icons_base_class', function() {
 return 'my-custom-css-class-name';
});
</code></pre>
Disable the settings screen
<pre><code>add_filter( 'jvm_richtext_icons_show_settings', '__return_false');
</code></pre>
Please note that if you are loading a custom icon set with the plugin hook: <code>jvm_richtext_icons_css_file</code>, you should make sure the plugin is not set to My SVG uploads as this setting does not load any CSS file.

JVM Rich Text Icons

Thank you so much for the plugin, Joris! I am using a modded version of this plugin to insert a custom icon pack that I created. It was so easy to configure.

You have my utmost respect for this amazing plugin.

Incredible and Highly Extensible

Even though the plugin could not be activated due to a syntax error (which I fixed it - to be more accurate - bypassed it), it eliminates the need for me to create a similar block with ACF Pro for my projects, so thank you for this plugin.

Does one job, and does it well.

I can imagine something like this becoming part of core. Very well developed essential addon for the block editor

great gutenberg addon

Insert icons anywhere in your content — inline in text, headings, buttons, or as a standalone block.

e.nigma buttons vs JVM Rich Text Icons