Trivial update: noted compatibility through WP 3.4+; explicitly stated license<\/p>","1.7.2":"
Trivial update: noted compatibility through WP 3.3+<\/p>","1.7.1":"
Trivial update: noted compatibility through WP 3.2+<\/p>","1.7":"
Recommended update. Highlights: added multiple hooks to allow customization; made leading and trailing slashes in paths optional; allow sending post_id arg to c2c_get_the_category_image_list(); verified WP 3.0 compatibility; other miscellaneous tweaks and fixes.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":"1","5":"1"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.7","1.7.1","1.7.2","1.7.3","v1.0","v1.1"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[610,89,497,133,86],"plugin_category":[50,57],"plugin_contributors":[78189],"plugin_business_model":[],"class_list":["post-1477","plugin","type-plugin","status-publish","hentry","plugin_tags-categories","plugin_tags-category","plugin_tags-icon","plugin_tags-image","plugin_tags-post","plugin_category-media","plugin_category-taxonomy","plugin_contributors-coffee2code","plugin_committers-coffee2code"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/category-images.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n
Display an image for each category associated with a post.<\/p>\n\n
Notes:<\/p>\n\n
This plugin provides the templates tag Related info about the function:<\/p>\n\n Must be run inside \"the loop\".<\/p>\n\n c2c_get_category_image_list() is another provided function, which is identical to Links: Plugin Homepage<\/a> | Plugin Directory Page<\/a> | Author Homepage<\/a><\/p>\n\n The plugin provides one optional template tag for use in your theme templates.<\/p>\n\n This displays the image associated with a post's categories.<\/p>\n\n 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>\n 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>\n\n \/\/ In showing the post singularly, then use a larger image, else use a small image\n if ( is_single() ) {\n c2c_the_category_image('', '', 'gif', '\/wp-content\/images\/cat-images\/large\/');\n } else {\n c2c_the_category_image('', '', 'gif', '\/wp-content\/images\/cat-images\/small\/');\n }<\/p><\/li>\n Show all images in a comma-separated line:<\/p>\n\n<\/li>\n Show all images in an unordered list:<\/p>\n\n<\/li>\n Assuming one category per post, just show the category image without further HTML markup:<\/p>\n\n< ?php c2c_the_category_image(' '); \/\/ note the space in the argument, necessary to turn off default 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>\n<\/ul>\n\n The 'c2c_get_category_image' hook allows you to use an alternative approach to safely invoke Arguments:<\/p>\n\n Example:<\/p>\n\n Instead of:<\/p>\n\n Do:<\/p>\n\n The 'c2c_get_the_category_image_list' hook allows you to use an alternative approach to safely invoke Arguments:<\/p>\n\n Example:<\/p>\n\n Instead of:<\/p>\n\n Do:<\/p>\n\n The 'c2c_the_category_image' hook allows you to use an alternative approach to safely invoke Arguments:<\/p>\n\n Example:<\/p>\n\n Instead of:<\/p>\n\n Do:<\/p>\n\n =\n* Add optional arg $post_id (default of false) to c2c_get_the_category_image_list() to allow specifying a post\n* Send $separator as arg in calls to get_category_parents()\n* Use get_options() instead of get_settings()\n* Note compatibility with WP 2.6+, 2.7+, 2.8+\n* Update copyright date<\/p>\n\nc2c_the_category_image()<\/code> which basically reproduces and extends the functionality of WordPress's core function 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>, the plugin could be a drop-in replacement for the_category()<\/code>. As is done in the_category()<\/code>, the image or text for each category is also a link back to that category's archive.<\/p>\n\n\n
c2c_the_category_image()<\/code> except that it doesn't echo the result.<\/p><\/li>\n<\/ul>\n\nTemplate Tags<\/h3>\n\n
Functions<\/h4>\n\n
\n
<?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>\n<\/ul>\n\nArguments<\/h4>\n\n
\n
$separator<\/code>\nOptional argument. The text and\/or HTML to appear between each of a post's category images.<\/p><\/li>\n$parents<\/code>\nOptional 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>\n$image_extensions<\/code>\nOptional 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 the_category()<\/code>). Default is 'png gif jpg'.<\/p><\/li>\n$image_dir<\/code>\nOptional 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>\n$use_name_if_no_image<\/code>\nOptional 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>\n$start_from<\/code>\nOptional argument. How to traverse the list of post's categories; either 'begin' or 'end'. Default is 'begin'<\/p><\/li>\n$limit<\/code>\nOptional argument. The maximum number of category images to be displayed. Default is 999 (basically, no limit)<\/p><\/li>\n$post_id<\/code>\nOptional argument. The Post ID. If false, then use the current post (i.e. while in the loop). Default is false.<\/p><\/li>\n<\/ul>\n\nExamples<\/h3>\n\n
\n
markups ?>\n\n
Filters<\/h3>\n\n
c2c_get_category_image (filter)<\/h4>\n\n
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>\n\n\n
c2c_get_category_image()<\/code><\/li>\n<\/ul>\n\n <?php $cat_images = c2c_get_category_image( $cat ); ?>\n<\/code><\/pre>\n\n <?php $cat_images = apply_filters( 'c2c_get_category_image', $cat ); ?>\n<\/code><\/pre>\n\nc2c_get_the_category_image_list (filter)<\/h4>\n\n
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>\n\n\n
c2c_get_the_category_image_list()<\/code><\/li>\n<\/ul>\n\n <?php $cat_list = c2c_get_the_category_image_list(); ?>\n<\/code><\/pre>\n\n <?php $cat_list = apply_filters( 'c2c_get_the_category_image_list', '' ); ?>\n<\/code><\/pre>\n\nc2c_the_category_image (action)<\/h4>\n\n
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>\n\n\n
c2c_the_category_image()<\/code><\/li>\n<\/ul>\n\n <?php c2c_the_category_image(); ?>\n<\/code><\/pre>\n\n <?php do_action( 'c2c_the_category_image' ); ?>\n<\/code><\/pre>\n\n\n\n
category-images.zip<\/code> inside the \/wp-content\/plugins\/<\/code> directory (or install via the built-in WordPress plugin installer)<\/li>\nc2c_the_category_image()<\/code>) for each category you wish to have an image for, placing the image into the wp-content\/images\/ directory (unless you specify another location in your call to c2c_the_category_image()<\/code>). Remember to give the filename the nice-name version of the category name.<\/li>\nc2c_the_category_image()<\/code> template function in your template (see examples below).<\/li>\n<\/ol>\n\n\n1.7.3<\/h4>\n\n
\n
1.7.2<\/h4>\n\n
\n
1.7.1<\/h4>\n\n
\n
1.7<\/h4>\n\n
\n
1.6 (unreleased)<\/h4>\n\n
1.5<\/h4>\n\n
\n
1.2<\/h4>\n\n
\n
1.1<\/h4>\n\n
\n
1.0<\/h4>\n\n
\n
0.92<\/h4>\n\n
\n
0.91<\/h4>\n\n
\n
0.9<\/h4>\n\n
\n