Alexander Lueken

<p>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</p>
<p>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.</p>
<p>e.nigma buttons allows you to easily create those visually attractive buttons using a simple shortcode environment.</p>
<p>Development of the plugin is an open process. The current version is available on github:</p>
<p>https://github.com/chemiker/enigma-buttons</p>
<p>Feel free to contribute and to fix errors or send improvements via github.</p>
<h3>Shortcodes & Attributes</h3>
<p><em>e.nigma buttons</em> adds the shortcode <code>[button]</code> to your installation. The following options can be used to adjust the button for your needs:</p>
<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>
<p>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>.</p>
<p>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 <em>e.nigma buttons</em> 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.</p>
<h4>Colors</h4>
<p>The following colors are avaible:<br />
* green<br />
* orange<br />
* purple<br />
* cyan<br />
* white<br />
* red<br />
* black</p>
<p>In addition to those values you can also use a hex color code (e.g. #ff3600)</p>
<h4>Icons</h4>
<p><em>e.nigma buttons</em> 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.</p>
<h4>Examples</h4>
<pre><code>[button label="My GitHub account" icon="github" color="orange" link="https://github.com/chemiker"]
</code></pre>
<p>Brings you an linked, medium-sized, orange button that has a GitHub icon and the label “My GitHub account”.</p>
<pre><code>[button icon="github" color="orange" link="https://github.com/chemiker" size="large"]
</code></pre>
<p>Brings you an orange, large-sized, linked GitHub icon.</p>


e.nigma buttons

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

Matt Keys

justinkruit

<p>Add a <a href="http://fontawesome.com/" rel="nofollow ugc">Font Awesome</a> icon field type to Advanced Custom Fields.</p>
<ul>
<li>Specify which FontAwesome icon sets to use (Solid, Regular, Light, Thin, Duotone, Duotone Sharp, Brands, and Custom Upload Icons) (Some features only available with FontAwesome 5.x or 6.x icons)</li>
<li>Create your own custom filtered list of FontAwesome icons to use with your fields. Use different custom icon sets with different fields</li>
<li>Returns Icon Element, Icon Class, Icon Unicode, or an Object including the element, class, unicode value, and SVG data (if applicable)</li>
<li>Optionally enqueues Font Awesome in footer where needed (when a FontAwesome field is being used on the page))</li>
<li>Integrates with the <a href="https://docs.fontawesome.com/apis/graphql" rel="nofollow ugc">FontAwesome GraphQL</a> for loading your <a href="https://docs.fontawesome.com/web/setup/use-kit" rel="nofollow ugc">FontAwesome Kits</a>, searching for icons, and loading the latest version of FontAwesome</li>
</ul>
<p>Note: It is recommended to let this plugin enqueue the latest version of Font Awesome on your front-end; or include the latest version yourself using your <a href="https://docs.fontawesome.com/web/setup/use-kit" rel="nofollow ugc">FontAwesome Kit</a>; so that available icons in the admin area will be displayed properly on your sites front-end.</p>
<h4>Compatibility</h4>
<p>This ACF field type is compatible with:<br />
* ACF 5.7+<br />
* FontAwesome 4.x, 5.x, 6.x and 7.x fonts</p>
<h3>Optional Configuration</h3>
<h3>Filters</h3>
<ul>
<li><strong>ACFFA_always_enqueue_fa</strong>: Return true to always enqueue FontAwesome on the frontend, even if no ACF FontAwesome fields are in use on the page. This will enqueue FontAwesome in the header instead of the footer.</li>
<li><strong>ACFFA_admin_enqueue_fa</strong>: Return false to stop enqueueing FontAwesome in the admin area. Useful if you already have FontAwesome enqueued by some other means.</li>
<li><strong>ACFFA_get_icons</strong>: (Applies to FontAwesome 4.x and 5.x icons only) Filter the array of icons and icon details loaded from the database</li>
<li><strong>ACFFA_get_fa_url</strong>: Filter the URL used for enqueuing FontAwesome in the frontend and admin areas of the site.</li>
<li><strong>ACFFA_override_major_version</strong>: Filter to manually set the ‘major’ version of FontAwesome to load (accepts either 4, 5, or 6). NOTE: This filter must be registered before any calls to ACF get_field() function are made.</li>
<li><strong>ACFFA_fa_api_key</strong>: Filter to programmatically set the FontAwesome API key.</li>
<li><strong>ACFFA_fa_kit_token</strong>: Filter to programmatically set the FontAwesome kit token.</li>
</ul>


Advanced Custom Fields: Font Awesome Field

Thank you for sharing this plugin with us


I used the plugin within my own custom plugin and was impressed with the quality of the code and the functionality of the plugin. I asked the developer for support and he got back to me within hours.Advised.


Great plugin quality and excellent support

Excellent Support

Adds a new 'Font Awesome Icon' field to the popular Advanced Custom Fields plugin.

e.nigma buttons vs Advanced Custom Fields: Font Awesome Field