Scott Reilly

<p>Display an image for each category associated with a post.</p>
<p>Notes:</p>
<p>This plugin provides the templates tag <code>c2c_the_category_image()</code> which basically reproduces and extends the functionality of WordPress’s core function <code>the_category()</code> to add the ability to display a category image instead of the category name in the link to the category archive.  With its $image_extensions argument defaulted to <code>""</code>, the plugin could be a drop-in replacement for <code>the_category()</code>.  As is done in <code>the_category()</code>, the image or text for each category is also a link back to that category’s archive.</p>
<p>Related info about the function:</p>
<ul>
<li>If $image_extensions is defined, but no image is found for the category, then nothing is displayed for that category.</li>
<li>$image_extensions can be defined as a space separated list of image extensions.  Files will be checked with the image extensions in the order those extensions were provided; default is ‘png gif jpg’.</li>
<li>The number of category links/images displayed can be limited via the $limit argument</li>
<li>Category image  tags are defined with class=”catimage” for stylesheet manipulation.</li>
<li>The result can be filtered via the filter named “c2c_the_category_image”.</li>
<li>
<p>Must be run inside “the loop”.</p>
<p>c2c_get_category_image_list() is another provided function, which is identical to <code>c2c_the_category_image()</code> except that it doesn’t echo the result.</p>
</li>
</ul>
<p>Links: <a href="http://coffee2code.com/wp-plugins/category-images/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/extend/plugins/category-images/" rel="ugc">Plugin Directory Page</a> | <a href="http://coffee2code.com" rel="nofollow ugc">Author Homepage</a></p>
<h3>Template Tags</h3>
<p>The plugin provides one optional template tag for use in your theme templates.</p>
<h4>Functions</h4>
<ul>
<li><code><?php function c2c_the_category_image( $seperator='', $parents='', $image_extensions='png gif jpg', $image_dir='/wp-content/images/', $use_name_if_no_image=false, $start_from='begin', $limit=999 ) ?></code></li>
</ul>
<p>This displays the image associated with a post’s categories.</p>
<h4>Arguments</h4>
<ul>
<li>
<p><code>$separator</code><br />
Optional argument.  The text and/or HTML to appear between each of a post’s category images.</p>
</li>
<li>
<p><code>$parents</code><br />
Optional argument.  Allows you to specify if you want ancestor categories of a post’s category to be imaged and linked as well.  Valid options are ‘multiple’, ‘single’, and ”. Default is ”.</p>
</li>
<li>
<p><code>$image_extensions</code><br />
Optional argument.  A space-separated list of image extensions (case insensitive).  If defined as ” then no image is retrieved and the category name is displayed instead (a la <code>the_category()</code>).  Default is ‘png gif jpg’.</p>
</li>
<li>
<p><code>$image_dir</code><br />
Optional argument.  The directory in which the category image(s) reside.  The value should be a location relative to the main URL of your blog.  Default is ‘/wp-content/images/’</p>
</li>
<li>
<p><code>$use_name_if_no_image</code><br />
Optional argument.  Boolean value (true or false) indicating if the name of the category should be displayed for each category that does not have an associated image.  Default is false.</p>
</li>
<li>
<p><code>$start_from</code><br />
Optional argument.  How to traverse the list of post’s categories; either ‘begin’ or ‘end’.  Default is ‘begin’</p>
</li>
<li>
<p><code>$limit</code><br />
Optional argument.  The maximum number of category images to be displayed.  Default is 999 (basically, no limit)</p>
</li>
<li>
<p><code>$post_id</code><br />
Optional argument.  The Post ID.  If false, then use the current post (i.e. while in the loop).  Default is false.</p>
</li>
</ul>
<h3>Examples</h3>
<ul>
<li>
<p>You can opt to treat only certain categories as having a graphical representation by defining an image for them but not creating images for the non-graphically represented categories (as in you can have a subset of categories that dictate what image to be displayed for the post).</p>
</li>
<li>
<p>You can take advantage of the $image_extension and/or $image_dir arguments to display different category icons under different contexts, i.e. if showing a $single post, choose to use a ‘png’ image, otherwise use ‘gif’; or locate your images in different directories ‘/wp-content/images/cat-images/small/’ and ‘/wp-content/images/cat-images/large/’ and decide based on context where to get the image(s) from:</p>
<p>// In showing the post singularly, then use a larger image, else use a small image<br />
  if ( is_single() ) {<br />
    c2c_the_category_image(”, ”, ‘gif’, ‘/wp-content/images/cat-images/large/’);<br />
  } else {<br />
    c2c_the_category_image(”, ”, ‘gif’, ‘/wp-content/images/cat-images/small/’);<br />
  }</p>
</li>
<li>
<p>Show all images in a comma-separated line:</p>
</li>
<li>
<p>Show all images in an unordered list:</p>
</li>
<li>
<p>Assuming one category per post, just show the category image without further HTML markup:</p>
<p>< ?php c2c_the_category_image(' ');  // note the space in the argument, necessary to turn off default </p>
<ul> markups ?></p>
<h3>Filters</h3>
<p>The plugin exposes two filters and one action for hooking.  Typically, customizations utilizing these hooks would be put into your active theme’s functions.php file, or used by another plugin.</p>
</li>
</ul>
<h4>c2c_get_category_image (filter)</h4>
<p>The ‘c2c_get_category_image’ hook allows you to use an alternative approach to safely invoke <code>c2c_get_category_image()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for <code>c2c_get_category_image()</code></li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code>    <?php $cat_images = c2c_get_category_image( $cat ); ?>
</code></pre>
<p>Do:</p>
<pre><code>    <?php $cat_images = apply_filters( 'c2c_get_category_image', $cat ); ?>
</code></pre>
<h4>c2c_get_the_category_image_list (filter)</h4>
<p>The ‘c2c_get_the_category_image_list’ hook allows you to use an alternative approach to safely invoke <code>c2c_get_the_category_image_list()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for <code>c2c_get_the_category_image_list()</code></li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code>    <?php $cat_list = c2c_get_the_category_image_list(); ?>
</code></pre>
<p>Do:</p>
<pre><code>    <?php $cat_list = apply_filters( 'c2c_get_the_category_image_list', '' ); ?>
</code></pre>
<h4>c2c_the_category_image (action)</h4>
<p>The ‘c2c_the_category_image’ hook allows you to use an alternative approach to safely invoke <code>c2c_the_category_image()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</p>
<p>Arguments:</p>
<ul>
<li>same as for <code>c2c_the_category_image()</code></li>
</ul>
<p>Example:</p>
<p>Instead of:</p>
<pre><code>    <?php c2c_the_category_image(); ?>
</code></pre>
<p>Do:</p>
<pre><code>    <?php do_action( 'c2c_the_category_image' ); ?>
</code></pre>


Category Image(s)

Display an image for each category associated with a post.

Mickey Kay

MIGHTYminnow

Aaron [MIGHTYminnow]

<p><a href="https://travis-ci.com/MickeyKay/better-font-awesome" rel="nofollow ugc"></a></p>
<p><strong>Do you find this plugin helpful? Please consider <a href="https://wordpress.org/support/view/plugin-reviews/better-font-awesome" rel="ugc">leaving a 5-star review</a>.</strong></p>
<p>Better Font Awesome allows you to automatically integrate the latest available version of <a href="http://fontawesome.io/" rel="nofollow ugc">Font Awesome</a> into your WordPress project, along with accompanying CSS, shortcodes, and TinyMCE icon shortcode generator.</p>
<h4>Features</h4>
<ul>
<li>
<p><strong>Always up-to-date</strong> – automatically fetches the most recent available version of Font Awesome, meaning you no longer need to manually update the version included in your theme/plugin.</p>
</li>
<li>
<p><strong>Backwards compatible</strong> – shortcode output is automatically updated depending on which version of Font Awesome you choose, meaning that you can switch versions without having to modify your shortcodes.</p>
</li>
<li>
<p><strong>Compatible with other plugins</strong> – designed to work with shortcodes generated with plugins like <a href="https://wordpress.org/plugins/font-awesome/" title="Font Awesome Icons" rel="ugc">Font Awesome Icons</a>, <a href="https://wordpress.org/plugins/font-awesome-more-icons/" title="Font Awesome More Icons" rel="ugc">Font Awesome More Icons</a>, and <a href="https://wordpress.org/plugins/font-awesome-shortcodes/" rel="ugc">Font Awesome Shortcodes</a>, so you can switch to Better Font Awesome and your existing shortcodes will still work.</p>
</li>
<li>
<p><strong>CDN speeds</strong> – Font Awesome CSS is pulled from the super-fast and reliable <a href="http://www.jsdelivr.com/#!fontawesome" rel="nofollow ugc">jsDelivr CDN</a>.</p>
</li>
<li>
<p><strong>Shortcode generator</strong> – includes an easy-to-use TinyMCE dropdown shortcode generator.</p>
</li>
</ul>
<h4>Settings</h4>
<p>All settings can be adjusted via <strong>Settings → Better Font Awesome</strong>.</p>
<h4>Usage</h4>
<p>Better Font Awesome can be used in 3 different ways: shortcode, HTML, and TinyMCE</p>
<h4>1. Shortcode</h4>
<pre><code>[icon name="flag" class="2x spin border" unprefixed_class="my-custom-class"]
</code></pre>
<p>Note that prefixes (<code>fa-</code> and <code>icon-</code>) are not required, but if you do include them things will still work just fine! Better Font Awesome is smart enough to know what version of Font Awesome you’re using and correct of the appropriate prefix.</p>
<p>That means that all of the following shortcodes will work, regardless of what version of Font Awesome you choose:<br />
    [icon name=”flag” class=”2x spin border”]<br />
    [icon name=”icon-flag” class=”icon-2x icon-spin icon-border”]<br />
    [icon name=”fa-flag” class=”fa-2x fa-spin fa-border”]<br />
    [icon name=”icon-flag” class=”fa-2x spin icon-border”]</p>
<p>You can read more about shortcode usage on <a href="https://github.com/MickeyKay/better-font-awesome-library#shortcode" rel="nofollow ugc">Github</a></p>
<h4>2. TinyMCE</h4>
<p>Better Font Awesome also provides you with an easy-to-use drop down menu when editing in TinyMCE’s visual mode. Check out our <a href="https://wordpress.org/plugins/better-font-awesome/screenshots/" title="Screenshots" rel="ugc">Screenshots</a> to see what it looks like.</p>
<h4>3. HTML</h4>
<p>Note that prefixes are required for HTML usage, and are version-specific. For this reason, shortcode usage is encouraged over HTML. If you do want to use HTML, however, you can read more on the <a href="http://fortawesome.github.io/Font-Awesome/examples/" rel="nofollow ugc">Font Awesome site</a>.</p>
<h4>Advanced / Integration</h4>
<p>Better Font Awesome is built around the <a href="https://github.com/MickeyKay/better-font-awesome-library" rel="nofollow ugc">Better Font Awesome Library</a>. This library allows you to integrate Better Font Awesome into any custom project you want to create (perhaps a theme or plugin with a constantly up-to-date icon list), and includes all the <a href="https://github.com/MickeyKay/better-font-awesome-library#filters" rel="nofollow ugc">filters</a> you might need.</p>
<h4>Languages / Translations</h4>
<ul>
<li>English</li>
<li>French (thanks to <a href="http://www.pixemotion.fr" rel="nofollow ugc">David Tisserand</a>)</li>
</ul>
<h4>Credits</h4>
<p>Many thanks to the following plugins and their authors:</p>
<ul>
<li><a href="https://wordpress.org/plugins/font-awesome/" title="Font Awesome Icons" rel="ugc">Font Awesome Icons</a> by <a href="http://rachelbaker.me/" title="Rachel Baker" rel="nofollow ugc">Rachel Baker</a></li>
<li><a href="https://wordpress.org/plugins/font-awesome-more-icons/" title="Font Awesome More Icons" rel="ugc">Font Awesome More Icons</a> by <a href="http://webguysaz.com/" title="Web Guys" rel="nofollow ugc">Web Guys</a></li>
<li><a href="https://wordpress.org/plugins/font-awesome-shortcodes/" rel="ugc">Font Awesome Shortcodes</a> by <a href="https://profiles.wordpress.org/foolsrun/" title="FoolsRun" rel="nofollow ugc">FoolsRun</a></li>
<li>Dmitriy Akulov and the awesome folks at <a href="http://www.jsdelivr.com/" rel="nofollow ugc">jsDelivr</a></li>
</ul>
<p>And many thanks to the following folks who helped with testing and QA:</p>
<ul>
<li><a href="http://vanishingforests.org/" rel="nofollow ugc">Jeffrey Dubinksy</a></li>
<li><a href="https://twitter.com/_neilgee" rel="nofollow ugc">Neil Gee</a></li>
<li><a href="https://twitter.com/MichaelBeil" rel="nofollow ugc">Michael Beil</a></li>
<li><a href="https://twitter.com/rob_neu" rel="nofollow ugc">Rob Neue</a></li>
<li><a href="https://twitter.com/GaryJ" rel="nofollow ugc">Gary Jones</a></li>
<li><a href="https://twitter.com/JanHoekdotCom" rel="nofollow ugc">Jan Hoek</a></li>
</ul>


Better Font Awesome

1. It is not really compatible with font-awesome official plugin. I have this shortcode [icon name="fort-awesome" prefix="fab"] but not rendered correctly in this plugin.

2. There is only one version available while the screenshot showing version select box which make me understand that there are multiple versions to use. It is okay to use latest but just update screenshot please.

3. FAQ said there is checkbox Remove existing Font Awesome styles but there is not. The only remove I see is Attempt to remove Font Awesome CSS and shortcodes added by other plugins and themes which is very unclear that it will be mess up my post data or not.

4. They use only CDN, no local file option available. If I have to install a site in local network without internet access then this will be dead end. To be fair, this choice is not negative or positive but just my comment.

5. This plugin leave junk in my DB. The option name better-font-awesome_options still exists after uninstalled. The WordPress document is recommended to clean up the data on uninstall. Read more at Plugin Handbook / Plugin Basics / Uninstall Methods

Not compatible and SS/FAQ outdated

The Better Font Awesome plugin for WordPress. Shortcodes, HTML, TinyMCE, various Font Awesome versions, backwards compatibility, CDN speeds, and more.

Category Image(s) vs Better Font Awesome