Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: the_category

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

This hook occurs 3 times in this file.

Line Code
127  *                          in an unordered list. An empty string will result in the default behavior.
128  * @param string $parents Optional. How to display the parents.
129  * @param int $post_id Optional. Post ID to retrieve categories.
130  * @return string
131  */
132 function get_the_category_list( $separator = '', $parents = '', $post_id = false ) {
133      global $wp_rewrite;
134      if ( ! is_object_in_taxonomy( get_post_type( $post_id ), 'category' ) ) {
135           /** This filter is documented in wp-includes/category-template.php */
136           return apply_filters( 'the_category', '', $separator, $parents );
137      }
138
139      /**
140       * Filters the categories before building the category list.
141       *
142       * @since 4.4.0
143       *
144       * @param WP_Term[] $categories An array of the post's categories.
145       * @param int|bool  $post_id    ID of the post we're retrieving categories for. When `false`, we assume the
146       *                              current post in the loop.
147       */
148      $categories = apply_filters( 'the_category_list', get_the_category( $post_id ), $post_id );
149
150      if ( empty( $categories ) ) {
151           /** This filter is documented in wp-includes/category-template.php */
152           return apply_filters( 'the_category', __( 'Uncategorized' ), $separator, $parents );
153      }
154
155      $rel = ( is_object( $wp_rewrite ) && $wp_rewrite->using_permalinks() ) ? 'rel="category tag"' : 'rel="category"';
156
157      $thelist = '';
158      if ( '' == $separator ) {
159           $thelist .= '<ul class="post-categories">';
160           foreach ( $categories as $category ) {
161                $thelist .= "\n\t<li>";
 
Line Code
211       * Filters the category or list of categories.
212       *
213       * @since 1.2.0
214       *
215       * @param string $thelist   List of categories for the current post.
216       * @param string $separator Separator used between the categories.
217       * @param string $parents   How to display the category parents. Accepts 'multiple',
218       *                          'single', or empty.
219       */
220      return apply_filters( 'the_category', $thelist, $separator, $parents );
221 }
222
223 /**
224  * Checks if the current post is within any of the given categories.
225  *
226  * The given categories are checked against the post's categories' term_ids, names and slugs.
227  * Categories given as integers will only be checked against the post's categories' term_ids.
228  *
229  * Prior to v2.5 of WordPress, category names were not supported.