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.

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.

Category Image(s) vs JVM Rich Text Icons