Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: single_cat_title

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
173      $year = get_query_var('year');
174      $monthnum = get_query_var('monthnum');
175      $day = get_query_var('day');
176      $title = '';
177
178      // If there's a category
179      if ( !empty($cat) ) {
180                // category exclusion
181                if ( !stristr($cat,'-') )
182                     $title = apply_filters('single_cat_title', get_the_category_by_ID($cat));
183      } elseif ( !empty($category_name) ) {
184           if ( stristr($category_name,'/') ) {
185                     $category_name = explode('/',$category_name);
186                     if ( $category_name[count($category_name)-1] )
187                          $category_name = $category_name[count($category_name)-1]; // no trailing slash
188                     else
189                          $category_name = $category_name[count($category_name)-2]; // there was a trailling slash
190           }
191           $cat = get_term_by('slug', $category_name, 'category', OBJECT, 'display');
192           if ( $cat )
193                $title = apply_filters('single_cat_title', $cat->name);
194      }
195
196      if ( !empty($tag) ) {
197           $tag = get_term($tag, 'post_tag', OBJECT, 'display');
198           if ( is_wp_error( $tag ) )
199                return $tag;
200           if ( ! empty($tag->name) )
201                $title = apply_filters('single_tag_title', $tag->name);
202      }
 
Line Code
283           else
284                return strip_tags($title);
285      }
286 }
287
288
289 function single_cat_title($prefix = '', $display = true ) {
290      $cat = intval( get_query_var('cat') );
291      if ( !empty($cat) && !(strtoupper($cat) == 'ALL') ) {
292           $my_cat_name = apply_filters('single_cat_title', get_the_category_by_ID($cat));
293           if ( !empty($my_cat_name) ) {
294                if ( $display )
295                     echo $prefix.strip_tags($my_cat_name);
296                else
297                     return strip_tags($my_cat_name);
298           }
299      } else if ( is_tag() ) {
300           return single_tag_title($prefix, $display);
301      }