List categories

外掛說明

Simple plugin to display categories in any post or page with a shortcode. It’s basically a shortcode API interface to the wp_list_categories WordPress function. This means given any of the parameters accepted by the function, you can pass it in as a shortcode parameter to the categories shortcode.

Usage:

[categories orderby=count]

Will display links to all the categories and order them by number of posts in each category.

You can also list tags or any other WordPress taxonomy. You need to pass a value to the taxonomy parameter. For example to list tags: [categories taxonomy=post_tag title_li="Tags"].
By default, the usage shows:

  • No link to all categories
  • Sorts the list of Categories by the Category name in ascending order
  • Displayed in an unordered list style
  • Does not show the post count
  • Displays only Categories with posts
  • Sets the title attribute to the Category Description
  • Is not restricted to the child_of any Category
  • No feed or feed image used
  • Does not exclude any Category and includes all Categories
  • Displays the active Category with the CSS Class-Suffix ‘ current-cat’
  • Shows the Categories in hierarchical indented fashion
  • Display Category as the heading over the list
  • No SQL LIMIT is imposed (‘number’ => 0 is not shown above)
  • Displays (echos) the categories
  • No limit to depth
  • All categories.
  • The list is rendered using a new walker object of the the Walker_Category class

See wp_list_categories for usage.

Markup and Styling of Category Lists

Taken from the wp_list_categories official documentation.

By default, wp_list_categories() generates nested unordered lists (ul) within a single list item (li) titled “Categories”.

You can remove the outermost item and list by setting the title_li parameter to an empty string. You’ll need to wrap the output in an ordered list (ol) or unordered list yourself (see the examples above). If you don’t want list output at all, set the style parameter to none.

You can style the output with these CSS selectors :

li.categories { ... }  /* outermost list item */
li.cat-item { ... }
li.cat-item-7 { ... }  /* category ID #7, etc */
li.current-cat { ... }
li.current-cat-parent { ... }
ul.children { ... }

Show categories list in columns

For outputting the list into columns, you can use CSS’s multicolumns. Since by default the list is printed as an unordered list with the “categories” class, you can add this to your CSS:

.categories{
    column-count: 5;
    column-gap: 50px;
}

安裝方式

  • Upload the plugin’s directory into your wp-content/plugins/ directory.
  • Login to your WordPress Admin menu, go to Plugins, and activate it.

使用者評論

2023 年 7 月 24 日
I was looking for a way to list subcategories of a single main category.This plugin does the trick (and more)
2022 年 10 月 6 日
Thank you for the great plugin! It works perfectly with WP v6.0.2 and my Hello Theme and has saved me hours of work 🙂 Cheers!
2022 年 10 月 2 日
i hope these great works bless you with future work and good fortune. thank you kindly. oh and i tested this and works fine!
閱讀全部 15 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈List categories〉的開發相關工作。

參與者

將〈List categories〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

0.4

  • Tested up to the latest version of WordPress.

0.3

  • Tested up to the latest version of WordPress
  • Adds note about taxonomies, updates parameters

0.2

  • Fixes plugin content with wrong placement. Thanks windwww from the WP Forums.

0.1