Linkify Categories

Screenshots

The plugin provides a widget called “Linkify Catagories” as well as a template tag, c2c_linkify_categories(), which allow you to easily specify categories to list and how to list them. Categories are specified by either ID or slug. See other parts of the documentation for example usage and capabilities. Links: Plugin Homepage | Plugin Directory Page | Author Homepage Template Tags The plugin provides one template tag for use in your theme templates, functions.php, or plugins. Functions <?php c2c_linkify_categories( $categories, $before = '', $after = '', $between = ', ', $before_last = '', $none = '' ) ?> Displays links to each of any number of categories specified via category IDs/slugs Arguments $categories A single category ID/slug, or multiple category IDs/slugs defined via an array, or multiple categories IDs/slugs defined via a comma-separated and/or space-separated string $before (optional) To appear before the entire category listing (if categories exist or if ‘none’ setting is specified) $after (optional) To appear after the entire category listing (if categories exist or if ‘none’ setting is specified) $between (optional) To appear between categories $before_last (optional) To appear between the second-to-last and last element, if not specified, ‘between’ value is used $none (optional) To appear when no categories have been found. If blank, then the entire function doesn’t display anything Examples These are all valid calls: <?php c2c_linkify_categories("43 92"); ?> Outputs something like: <a href="http://yourblog.com/category/books">Books</a>, <a href="http://yourblog.com/category/movies">Movies</a> <ul><?php c2c_linkify_categories("43, 92", "<li>", "</li>", "</li><li>"); ?></ul> Outputs something like: <ul><li><a href="http://yourblog.com/category/books">Books</a></li><li><a href="http://yourblog.com/category/movies">Movies</a></li></ul> <?php c2c_linkify_categories(""); // Assume you passed an empty string as the first value ?> Displays nothing. <?php c2c_linkify_categories("", "", "", "", "", "No related categories."); // Assume you passed an empty string as the first value ?> Outputs: No related categories.<h3>Filters</h3> The plugin exposes one action for hooking. c2c_linkify_categories (action) The ‘c2c_linkify_categories’ hook allows you to use an alternative approach to safely invoke c2c_linkify_categories() in such a way that if the plugin were to be deactivated or deleted, then your calls to the function won’t cause errors in your site. Arguments: same as for c2c_linkify_categories() Example: Instead of: <?php c2c_linkify_categories( "43, 92", 'Categories: ' ); ?> Do: <?php do_action( 'c2c_linkify_categories', "43, 92", 'Categories: ' ); ?>