Plugin Settings Page
When you first install your plugin, you will need to activate it with the license key provided at the time of purchase. Visit the plugin setting page by selecting Settings then Featured Images for Categories Pro in your WordPress Dashboard.
The settings page is shown below.
You can set the default options for the plugin, the shortcodes and widgets discussed later in this documentation will override these defaults.
- When displaying all of your featured images you can select how much padding in pixels each image will have around it
- Select the number of columns for the output of featured images
- Select the image size for the display of featured images – this supports all registered images sizes in your WordPress theme
Display featured images with a shortcode
To display featured images for categories or tags on a page or post in your WordPress site use this shortcode.
[FeaturedImagesCat taxonomy=’category’ columns=’3′]
Leaving out the columns option will use the default as per the above settings or you can override the defaults by specifying the number of columns in the shortcode.
To use with tags instead change the ‘category’ value to ‘post_tags’.
[FeaturedImagesCat taxonomy=’post_tag’ columns=’3′]
To use the plugin with custom taxonomies change ‘category’ the the name of your taxonomy.
[FeaturedImagesCat taxonomy=’mytaxonomy’ columns=’2′]
Altering the image size
Instead of using the default image size (thumbnail), use any registered image size by adding a new option imagesize to the shortcode. Please note this must be the name of the registered image size (e.g. home_slider) in your WordPress theme.
[FeaturedImagesCat taxonomy=’mytaxonomy’ columns=’3′ imagesize=’myImageSize’]
Display the Category name and description
This is new in version 1.3
There are two new arguments that are available in the shortcode:
- showCatName – set to ‘true’ to show the category name under the featured image
- showCatDesc – set to ‘true’ to show the category description under the featured image
[FeaturedImagesCat taxonomy=’mytaxonomy’ columns=’2′ showCatName=’true’]
[FeaturedImagesCat taxonomy=’mytaxonomy’ columns=’2′ showCatName=’true’ showCatDesc=’true’]
The screenshot below shows an example with category names being printed (click for a larger view).
Category descriptions are core functionality in WordPress, they are editable in the dashboard in the category or custom taxonomy editor.
The screenshot below shows this editor with a description added, it’s this description that can then be displayed by the showCatDesc argument.
Limit the categories that are displayed
This is new in version 1.3
The short code now also supports the ability to limit the categories that are printed. With the new argument include you can specify a list of categories using their IDs.
[FeaturedImagesCat taxonomy=’mytaxonomy’ columns=’2′ include=’2,4,6,23′]
There is also an argument that will force the shortcode to only show top level categories (i.e. categories that have no parent).
[FeaturedImagesCat taxonomy=’mytaxonomy’ columns=’2′ parentcatsonly=”true”]
The following functionality was introduced in version 1.4
This option allows you to specify one or more category IDs. The shortcode will then display only categories that are child categories of those specified.
This is how the new option works.
[FeaturedImagesCat taxonomy=’category’ columns=’2′ childrenonly=”1,4,65″ ]
From the example, categories that are children on 1, 4 or 65 would be displayed.
Hide categories / taxonomies without posts
Use the argument hideempty to not show categories that don’t have published posts.
[FeaturedImagesCat taxonomy=’category’ columns=’2′ hideempty=’1′]
Show all categories with a widget
There are two widgets available in the plugin. Go to Appearance then Widget in your WordPress Dashboard. The first widget Featured Images for Categories allows you to show all the categories or taxonomies in a widget area.
Start by choosing the data to work with. The Taxonomy drop down will show category, post_tag as well as all of your registered custom taxonomies.
Next choose the number of columns you would like the output to show.
The Order By field allows you to choose the sort order, for example by name, id or slug.
Hide Empty allows you to mute categories that don’t have any posts assigned to them.
The final option, padding, allows you to set the amount of padding (in pixels) each image will receive when displayed.
Show one featured category
The second widget Featured Images for Categories – Term allows you to select one item from a category, tag or custom taxonomy to be displayed in a widget area.
The options are similar to the above widget with the main difference being the Term option.
If you choose category in the taxonomy setting the widget will show you all of the category names for you to select one to feature in this widget.
There is a new option here Display term, this allows you to suppress the printing of the item’s name, or choose to print it above or below the featured image.
Developer access to featured images
Version 1.3 of the plugin has a new function available for developers to access the featured image that has been assigned to a category.
Return an HTML image tag for the featured image
Using the function ‘fifc_the_tax_thumbnail’ and setting three arguments:
- Category ID
- Taxonomy ID
- Image size (optional *)
The image size accepts any registered image size that is operating in your current WordPress theme, if not included the function will default to thumbnail.
The function will return the image HTML tag including the URL to the specific image.
Example usage: $myImage = fifc_the_tax_thumbnail(4,’category’,’thumbnail’);
Return the URL to the featured image
Using the function ‘fifc_get_tax_thumbnail’ you can have just the image URL returned.
Example usage $myURL = fifc_get_tax_thumbnail( $category_id, $taxonomy, ‘thumbnail’);
If you have questions for further problems that are not covered here please visit our support centre here.
View more information about this plugin and purchasing options.