gurolcaydas

Create and display custom lists with titles and content using the [gurols_list] shortcode.

Gurol's List

A simple plugin to manage and display custom lists using a shortcode.

Fernando Briano

Simple plugin to display categories in any post or page with a shortcode. It’s basically a shortcode API interface to the <a href="https://developer.wordpress.org/reference/functions/wp_list_categories/" rel="nofollow ugc">wp_list_categories</a> WordPress function. This means given any of the <a href="https://developer.wordpress.org/reference/functions/wp_list_categories/#parameters" rel="nofollow ugc">parameters</a> accepted by the function, you can pass it in as a shortcode parameter to the <code>categories</code> shortcode.
Usage:
<pre><code>[categories orderby=count]
</code></pre>
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 <code>taxonomy</code> parameter. For example to list tags: <code>[categories taxonomy=post_tag title_li="Tags"]</code>. 
By default, the usage shows:
<ul>
<li>No link to all categories</li>
<li>Sorts the list of Categories by the Category name in ascending order</li>
<li>Displayed in an unordered list style</li>
<li>Does not show the post count</li>
<li>Displays only Categories with posts</li>
<li>Sets the title attribute to the Category Description</li>
<li>Is not restricted to the child_of any Category</li>
<li>No feed or feed image used</li>
<li>Does not exclude any Category and includes all Categories</li>
<li>Displays the active Category with the CSS Class-Suffix ‘ current-cat’</li>
<li>Shows the Categories in hierarchical indented fashion</li>
<li>Display Category as the heading over the list</li>
<li>No SQL LIMIT is imposed (‘number’ => 0 is not shown above)</li>
<li>Displays (echos) the categories</li>
<li>No limit to depth</li>
<li>All categories.</li>
<li>The list is rendered using a new walker object of the the Walker_Category class</li>
</ul>
See <a href="https://developer.wordpress.org/reference/functions/wp_list_categories/" rel="nofollow ugc">wp_list_categories</a> for usage.
<h3>Markup and Styling of Category Lists</h3>
Taken from the <a href="https://codex.wordpress.org/Template_Tags/wp_list_categories#Markup_and_Styling_of_Category_Lists" rel="nofollow ugc">wp_list_categories official documentation</a>.
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 :
<pre><code>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 { ... }
</code></pre>
For instance, you can remove the bullet points next to each category with:
<pre><code>.cat-item {
 list-style-type: none
}
</code></pre>
<h3>Show categories list in columns</h3>
For outputting the list into columns, you can use <a href="https://www.w3.org/TR/css-multicol-1/" rel="nofollow ugc">CSS’s multicolumns</a>. Since by default the list is printed as an unordered list with the “categories” class, you can add this to your CSS:
<pre><code>.categories{
 column-count: 5;
 column-gap: 50px;
}
</code></pre>

List categories

Thanks for publishing this little plugin. I ended up taking the code and integrating it into a custom solution but the plugin is well put together and pretty powerful.
Some better docs would help make it more useful for folks.
Thanks for making this available!



Elegantly Written

Simple plugin to display categories in any post or page with a shortcode.

Gurol's List vs List categories