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
170  * @param string $separator Optional, default is empty string. Separator for between the categories.
171  * @param string $parents Optional. How to display the parents.
172  * @param int $post_id Optional. Post ID to retrieve categories.
173  * @return string
174  */
175 function get_the_category_list( $separator = '', $parents='', $post_id = false ) {
176      global $wp_rewrite;
177      $categories = get_the_category( $post_id );
178      if ( !is_object_in_taxonomy( get_post_type( $post_id ), 'category' ) )
179           return apply_filters( 'the_category', '', $separator, $parents );
180
181      if ( empty( $categories ) )
182           return apply_filters( 'the_category', __( 'Uncategorized' ), $separator, $parents );
183
184      $rel = ( is_object( $wp_rewrite ) && $wp_rewrite->using_permalinks() ) ? 'rel="category tag"' : 'rel="category"';
185
186      $thelist = '';
187      if ( '' == $separator ) {
188           $thelist .= '<ul class="post-categories">';
189           foreach ( $categories as $category ) {
190                $thelist .= "\n\t<li>";
191                switch ( strtolower( $parents ) ) {
 
Line Code
224                          $thelist .= "$category->cat_name</a>";
225                          break;
226                     case '':
227                     default:
228                          $thelist .= '<a href="' . get_category_link( $category->term_id ) . '" title="' . esc_attr( sprintf( __( "View all posts in %s" ), $category->name ) ) . '" ' . $rel . '>' . $category->name.'</a>';
229                }
230                ++$i;
231           }
232      }
233      return apply_filters( 'the_category', $thelist, $separator, $parents );
234 }
235
236
237 /**
238  * Check if the current post in within any of the given categories.
239  *
240  * The given categories are checked against the post's categories' term_ids, names and slugs.
241  * Categories given as integers will only be checked against the post's categories' term_ids.
242  *