Scott Reilly

Display an image for each category associated with a post.
Notes:
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.
Related info about the function:
<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>
Must be run inside “the loop”.
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.
</li>
</ul>
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>
<h3>Template Tags</h3>
The plugin provides one optional template tag for use in your theme templates.
<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>
This displays the image associated with a post’s categories.
<h4>Arguments</h4>
<ul>
<li>
<code>$separator</code> 
Optional argument. The text and/or HTML to appear between each of a post’s category images.
</li>
<li>
<code>$parents</code> 
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 ”.
</li>
<li>
<code>$image_extensions</code> 
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’.
</li>
<li>
<code>$image_dir</code> 
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/’
</li>
<li>
<code>$use_name_if_no_image</code> 
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.
</li>
<li>
<code>$start_from</code> 
Optional argument. How to traverse the list of post’s categories; either ‘begin’ or ‘end’. Default is ‘begin’
</li>
<li>
<code>$limit</code> 
Optional argument. The maximum number of category images to be displayed. Default is 999 (basically, no limit)
</li>
<li>
<code>$post_id</code> 
Optional argument. The Post ID. If false, then use the current post (i.e. while in the loop). Default is false.
</li>
</ul>
<h3>Examples</h3>
<ul>
<li>
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).
</li>
<li>
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:
// In showing the post singularly, then use a larger image, else use a small image 
 if ( is_single() ) { 
 c2c_the_category_image(”, ”, ‘gif’, ‘/wp-content/images/cat-images/large/’); 
 } else { 
 c2c_the_category_image(”, ”, ‘gif’, ‘/wp-content/images/cat-images/small/’); 
 }
</li>
<li>
Show all images in a comma-separated line:
</li>
<li>
Show all images in an unordered list:
</li>
<li>
Assuming one category per post, just show the category image without further HTML markup:
< ?php c2c_the_category_image(' '); // note the space in the argument, necessary to turn off default 
<ul> markups ?>
<h3>Filters</h3>
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.
</li>
</ul>
<h4>c2c_get_category_image (filter)</h4>
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.
Arguments:
<ul>
<li>same as for <code>c2c_get_category_image()</code></li>
</ul>
Example:
Instead of:
<pre><code> <?php $cat_images = c2c_get_category_image( $cat ); ?>
</code></pre>
Do:
<pre><code> <?php $cat_images = apply_filters( 'c2c_get_category_image', $cat ); ?>
</code></pre>
<h4>c2c_get_the_category_image_list (filter)</h4>
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.
Arguments:
<ul>
<li>same as for <code>c2c_get_the_category_image_list()</code></li>
</ul>
Example:
Instead of:
<pre><code> <?php $cat_list = c2c_get_the_category_image_list(); ?>
</code></pre>
Do:
<pre><code> <?php $cat_list = apply_filters( 'c2c_get_the_category_image_list', '' ); ?>
</code></pre>
<h4>c2c_the_category_image (action)</h4>
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.
Arguments:
<ul>
<li>same as for <code>c2c_the_category_image()</code></li>
</ul>
Example:
Instead of:
<pre><code> <?php c2c_the_category_image(); ?>
</code></pre>
Do:
<pre><code> <?php do_action( 'c2c_the_category_image' ); ?>
</code></pre>

Category Image(s)

Display an image for each category associated with a post.

themifyme

Insert the Themify Icons easily in your post content, WordPress menus, and widget titles.

Themify Icons

Nifty plugin that enables you to use the Themify Icons (https://themify.me/themify-icons) font on your site.

Category Image(s) vs Themify Icons