wp_list_categories( array|string $args = '' ): void|string|false

User Contributed Notes

1. Skip to note 12 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 7You must log in to vote on the helpfulness of this note

   Display Categories Assigned to a Post

   Display the categories (or terms from other taxonomies) assigned to a post ordered by parent-child category relationship. Similar to the function get_the_category_list() which orders the categories by name. This example must be used inside the loop.

   $taxonomy = 'category';
   
   // Get the term IDs assigned to post.
   $post_terms = wp_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) );
   
   // Separator between links.
   $separator = ', ';
   
   if ( ! empty( $post_terms ) && ! is_wp_error( $post_terms ) ) {
   
   	$term_ids = implode( ',' , $post_terms );
   
   	$terms = wp_list_categories( array(
   		'title_li' => '',
   		'style'    => 'none',
   		'echo'     => false,
   		'taxonomy' => $taxonomy,
   		'include'  => $term_ids
   	) );
   
   	$terms = rtrim( trim( str_replace( '<br />',  $separator, $terms ) ), $separator );
   
   	// Display post categories.
   	echo  $terms;
   }
2. Skip to note 13 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 6You must log in to vote on the helpfulness of this note

   Include or Exclude Categories

   To sort categories alphabetically and include only the categories with IDs of 16, 3, 9 and 5, you could write the following code:

   <ul>
   	<?php wp_list_categories( array(
   		'orderby' => 'name',
   		'include' => array( 3, 5, 9, 16 )
   	) ); ?> 
   </ul>

   The following example displays category links sorted by name, shows the number of posts for each category, and excludes the category with the ID of 10 from the list.

   <ul>
   	<?php wp_list_categories( array(
   		'orderby'    => 'name',
   		'show_count' => true,
   		'exclude'    => array( 10 )
   	) ); ?> 
   </ul>
3. Skip to note 14 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Display or Hide the List Heading

   The title_li parameter sets or hides a title or heading for the category list generated by wp_list_categories. It defaults to ‘(__(‘Categories’)’, i.e. it displays the word “Categories” as the list’s heading. If the parameter is set to a null or empty value, no heading is displayed. The following example code excludes categories with IDs 4 and 7 and hides the list heading:

   <ul>
   	<?php wp_list_categories( array(
   		'exclude'  => array( 4,7 ),
   		'title_li' => ''
   	) ); ?>
   </ul>

   In the following example, only Categories with IDs 9, 5, and 23 are included in the list and the heading text has been changed to the word “Poetry”, with a heading style of :

   <ul>
   	<?php wp_list_categories( array(
   		'include'  => array( 5, 9, 23 ),
   		'title_li' => '<h2>' . __( 'Poetry', 'textdomain' ) . '</h2>'
   	) ); ?> 
   </ul>
4. Skip to note 15 content

   certainlyakey 8 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   Note that you can use all the arguments implemented for get_terms() function and WP_Term_Query::__construct. So, for example, the arguments meta_key or meta_value can be added and will do their job as well.
5. Skip to note 16 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   Remove Parentheses from Category Counts

   When show_count=1, each category count is surrounded by parentheses. In order to remove the parentheses without modifying core WordPress files, use the following code.

   $variable = wp_list_categories( array(
   	'echo' => false,
   	'show_count' => true,
   	'title_li' => '<h2>' . __( 'Categories', 'textdomain' ) . '</h2>'
   ) );
   
   $variable = preg_replace( '~\((\d+)\)(?=\s*+<)~', '$1', $variable );
   echo $variable;
6. Skip to note 17 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   Display Terms in a custom taxonomy

   With Version 3.0 the taxonomy parameter was added to enable wp_list_categories() function to list Custom Taxonomies. This example list the terms in the taxonomy genre:

   // List terms in a given taxonomy using wp_list_categories (also useful as a widget if using a PHP Code plugin)
   
   $taxonomy     = 'genre';
   $orderby      = 'name'; 
   $show_count   = false;
   $pad_counts   = false;
   $hierarchical = true;
   $title        = '';
   
   $args = array(
     'taxonomy'     => $taxonomy,
     'orderby'      => $orderby,
     'show_count'   => $show_count,
     'pad_counts'   => $pad_counts,
     'hierarchical' => $hierarchical,
     'title_li'     => $title
   );
   ?>
   
   <ul>
   	<?php wp_list_categories( $args ); ?>
   </ul>
7. Skip to note 18 content

   voichescudenis 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   All categories divided by comma.

   strip_tags( get_the_category_list( ', ', ', ' ) )
8. Skip to note 19 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Only Show Children of a Category

   The following example code generates category links, sorted by ID, only for the children of the category with ID 8; it shows the number of posts per category and hides category descriptions from the title attribute of the generated links. Note: If there are no posts in a parent Category, the parent Category will not display.

   <ul>
   	<?php wp_list_categories( array(
   		'orderby'            => 'id',
   		'show_count'         => true,
   		'use_desc_for_title' => false,
   		'child_of'           => 8
   	) ); ?>
   </ul>
9. Skip to note 20 content

   Codex 10 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

   Display Categories with RSS Feed Links

   The following example generates Category links sorted by name, shows the number of posts per Category, and displays links to the RSS feed for each Category.

   <ul>
   	<?php wp_list_categories( array(
   		'orderby'    => 'name',
   		'show_count' => true,
   		'feed'       => 'RSS'
   	) ); ?>
   </ul>

   To replace the rss link with a feed icon, you could write:

   <ul>
   	<?php wp_list_categories( array(
   		'orderby'    => 'name',
   		'show_count' => true,
   		'feed_image' => '/images/rss.gif'
   	) ); ?>
   </ul>
10. Skip to note 21 content

    Codex 10 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Markup and Styling of Category Lists

    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 { ... }
11. Skip to note 22 content

    nossfloda 6 years ago

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    ‘include’ is missing from the parameter list.

    • This code is a variation of one that already appears here that the last two arrays show the child categories of 17 and then exclude the main category showing only the children.

       $taxonomy = 'category'; $post_terms = wp_get_object_terms( $post->ID, $taxonomy, array( 'fields' => 'ids' ) ); $separator = ', '; if ( ! empty( $post_terms ) && ! is_wp_error( $post_terms ) ) { $term_ids = implode( ',', $post_terms ); $terms = wp_list_categories( array( 'title_li' => '', 'style' => 'none', 'echo' => false, 'taxonomy' => $taxonomy, 'include' => $term_ids, 'child_of' => 17, 'exclude' => 17 ) ); $terms = rtrim( trim( str_replace( '<br />', $separator, $terms ) ), $separator ); echo $terms; } 

      Artgallery75 5 years ago
    • ‘hierarchical’ is missing from the parameter list.

      nicholas.eymann 5 years ago