Plugin Directory

Test out the new Plugin Directory and let us know what you think.
!This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Post Category Index Generator

Allows the user to insert a index of posts and categories on page/post.

  1. Install the plugin either by uploading the contents of post-category-index-generator.zip to the '/wp-content/plugins/' directory or by using the 'Add New' in 'Plugins' menu in WordPress
  2. Activate the plugin through the 'Plugins' menu in WordPress


  • category - slug ot the category to parse. (mandatory)
  • display - type of index to generate wich can be: list or tree.
  • show - elements that will be displayed. Parameters are: category_name and post_title.
  • links - elements that will contain a hyperlink to the element instead of normal text. Parameters are: category_name, subcategory_name and post_title.
  • hide_empty - hides/displays empty categories. Parameters are: true or false. (default: false)
  • order - set the order of the posts. Parameters are: asc (ascending) and desc (descending).
  • orderby - set the wich parameter will be used when in the posts order. Parameters are: author, date, category, title, modified, menu_order, parent, ID and rand.
  • hide_categories - list of categories (and its posts) that will not be displayed. In tree display this will include also the subcategories.
  • hide_category_posts - list of categories wich the its posts that will not be displayed.
  • tags_or and tags_and - list of tags wich will be used to filter. When both parameters are set, only the tags_and will be used.
  • post_sections - parts of the post that will be displayed. Parameters are: excerpt, a html tag or a css html selectors separated with commas. For more info the html tags and css html selectors check the examples and and the section How to find HTML elements? in http://simplehtmldom.sourceforge.net/manual.htm.
  • postappend and postappend_link - appends part of the post to the post title and uses same options of the the post_sections parameter. postappend will produce normal text while postappend_link will produce a link.
  • postappend_prefix and postappend_separator - prefix and separator to be used then the parameters postappend or postappend_link are used. Options are comma, space and dash.


Examples for the parameters

Displays only subcategories (ignores the empty ones) in tree index.

  • [pcig category=category-2 hide_empty=true]

Displays main category name, subcategories names (ignores the empty ones), post titles with hyperlinks in tree index.

  • [pcig category=category-2 show=category_name,post_title links=post_title hide_empty=true]

Displays subcategories names, subcategories names with hyperlinks and post titles with hyperlinks ordered by post title (in ascending order) in tree index.

  • [pcig category=category-2 show=post_title links=subcategory_name,post_title order=asc orderby=title]

Displays main category name, subcategories names (ignores the empty ones), post titles with hyperlinks in list index.

  • [pcig category=category-2 display=list show=category_name,post_title links=post_title hide_empty=true]

Displays main category name, subcategories names, ignores the content of 2 categories and ignore posts from other 2 categories.

  • [pcig category=category-2 show=category_name,post_title hide_categories=category3,category-4 hide_category_posts=category5,category-6]

Displays main category name, subcategories names and post_title of post that have both tags.

  • [pcig category=category-2 show=category_name,post_title tags_and=tag1,tag2]

Displays subcategories names, post titles with hyperlinks and the posts excerpts, heading 1 and heading 2 titles in tree index.

  • [pcig category=category-2 show=post_title links=post_title post_sections=h1,h2,post_excerpt]

Displays subcategories names, post titles with hyperlinks and the content of every html element in the post with the id equal to id123 (parameter that always starts with a number sign (#) ) and class equal class123 (parameter that always starts with a dot (.) ).

  • [pcig category=category-2 show=post_title links=post_title post_sections=#id123,.class123]

Displays subcategories names, post_excerpt and h1 elements appended to the post titles, using a dash as separator between elements and dash between the title and the elements.

  • [pcig category=category-2 show=post_title postappend_prefix=dash postappend_separator=dash postappend=post_excerpt,h1]


The code generated by this plugin will contain some html classes will allow to style the index by add css rules to the theme's css file. The following classes can be used:

  • pcig-ul-list and pcig-top-ul-list - list class
  • pcig-li-item - list element class
  • pcig-category - category span element
  • pcig-category-link - hyperlink class
  • pcig-post-title pcig-post-excerpt pcig-post-title-link - post span class

Examples of css

Change the left margin of the index of the index:

.pcig-top-ul-list{ margin-left: 5px; }

Use image bullets for categories:

.pcig-ul-list{ list-style-type:none; }
.pcig-category{ padding-left: 20px; background:transparent url(redcheck.gif) no-repeat scroll 0 0;}

Requires: 3.0 or higher
Compatible up to: 3.4.2
Last Updated: 4 years ago
Active Installs: 1,000+


4.8 out of 5 stars


Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,2,2 100,2,2 100,1,1
100,1,1 67,3,2 100,1,1