WordPress.org
Get WordPress

Make WordPress Core


Ignore:
Timestamp:
03/01/2006 01:30:19 PM (20 years ago)
Author:
ryan
Message:

wp_list_cats() rework. Add walk_tree() and walk_category_tree(). Use get_categories() for query.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/wp-includes/template-functions-category.php

    r3570 r3582  
    253253    if ( !isset($r['use_desc_for_title']) )
    254254        $r['use_desc_for_title'] = 1;
    255     if ( !isset($r['children']) )
    256         $r['children'] = true;
    257255    if ( !isset($r['child_of']) )
    258256        $r['child_of'] = 0;
    259     if ( !isset($r['categories']) )
    260         $r['categories'] = 0;
    261     if ( !isset($r['recurse']) )
    262         $r['recurse'] = 0;
    263257    if ( !isset($r['feed']) )
    264258        $r['feed'] = '';
    … …  
    268262        $r['exclude'] = '';
    269263    if ( !isset($r['hierarchical']) )
    270         $r['hierarchical'] = true;
    271 
    272     return list_cats($r['optionall'], $r['all'], $r['sort_column'], $r['sort_order'], $r['file'],   $r['list'], $r['optiondates'], $r['optioncount'], $r['hide_empty'], $r['use_desc_for_title'], $r['children'], $r['child_of'], $r['categories'], $r['recurse'], $r['feed'], $r['feed_image'], $r['exclude'], $r['hierarchical']);
     264        $r['hierarchical'] = false;
     265    if ( !isset($r['title_li']) )
     266        $r['title_li'] = '';
     267
     268    $q['orderby'] = $r['sort_column'];
     269    $q['order'] = $r['sort_order'];
     270    $q['include_last_update_time'] = $r['optiondates'];
     271   
     272    extract($r);
     273
     274    $args = add_query_arg($q, $args);
     275    $categories = get_categories($args);
     276
     277    $output = '';
     278    if ( $title_li && $list )
     279            $output = '<li class="categories">' . $r['title_li'] . '<ul>';
     280
     281    if ( empty($categories) ) {
     282        if ( $list)
     283            $output .= '<li>' . __("No categories") . '</li>';
     284        else
     285            $output .= __("No categories");
     286    } else {
     287        global $wp_query;
     288        $current_category = $wp_query->get_queried_object_id();
     289        if ( $hierarchical )
     290            $depth = 0;  // Walk the full depth.
     291        else
     292            $depth = -1; // Flat.
     293
     294        $output .= walk_category_tree($categories, $depth, '_category_list_element_start', '_category_list_element_end', '_category_list_level_start', '_category_list_level_end', $current_category, $r);
     295    }
     296
     297    if ( $title_li && $list )
     298        $output .= '</ul></li>';
     299           
     300    echo apply_filters('list_cats', $output);
     301}
     302
     303function _category_list_level_start($output, $depth, $cat, $args) {
     304    if (! $args['list'])
     305        return $output;
     306
     307    $indent = str_repeat("\t", $depth);
     308    $output .= "$indent<ul class='children'>\n";
     309    return $output;
     310}
     311
     312function _category_list_level_end($output, $depth, $cat, $args) {
     313    if (! $args['list'])
     314        return $output;
     315
     316    $indent = str_repeat("\t", $depth);
     317    $output .= "$indent</ul>\n";
     318    return $output;
     319}
     320
     321function _category_list_element_start($output, $category, $depth, $current_category, $args) {
     322    extract($args);
     323
     324    $link = '<a href="' . get_category_link($category->cat_ID) . '" ';
     325    if ( $use_desc_for_title == 0 || empty($category->category_description) )
     326        $link .= 'title="'. sprintf(__("View all posts filed under %s"), wp_specialchars($category->cat_name)) . '"';
     327    else
     328        $link .= 'title="' . wp_specialchars(apply_filters('category_description',$category->category_description,$category)) . '"';
     329    $link .= '>';
     330    $link .= apply_filters('list_cats', $category->cat_name, $category).'</a>';
     331
     332    if ( (! empty($feed_image)) || (! empty($feed)) ) {
     333        $link .= ' ';
     334
     335        if ( empty($feed_image) )
     336            $link .= '(';
     337
     338        $link .= '<a href="' . get_category_rss_link(0, $category->cat_ID, $category->category_nicename) . '"';
     339
     340        if ( !empty($feed) ) {
     341            $title = ' title="' . $feed . '"';
     342            $alt = ' alt="' . $feed . '"';
     343            $name = $feed;
     344            $link .= $title;
     345        }
     346
     347        $link .= '>';
     348
     349        if ( !empty($feed_image) )
     350            $link .= "<img src='$feed_image' $alt$title" . ' />';
     351        else
     352            $link .= $name;
     353        $link .= '</a>';
     354        if (empty($feed_image))
     355            $link .= ')';
     356    }
     357
     358    if ( intval($optioncount) == 1 )
     359        $link .= ' ('.intval($category->category_count).')';
     360
     361    if ( $optiondates ) {
     362        if ( $optiondates == 1 )
     363            $optiondates = 'Y-m-d';
     364        $link .= ' ' . gmdate($optiondates,$category->last_update_timestamp);
     365    }
     366
     367    if ( $list ) {
     368        $output .= "\t<li";
     369        if ( ($category->cat_ID == $current_category) && is_category() )
     370            $output .=  ' class="current-cat"';
     371        $output .= ">$link\n";
     372    } else {
     373        $output .= "\t$link<br />\n";
     374    }
     375
     376    return $output;
     377}
     378
     379function _category_list_element_end($output, $category, $depth, $cat, $args) {
     380    if (! $args['list'])
     381        return $output;
     382
     383    $output .= "</li>\n";
     384    return $output;
    273385}
    274386
    275387function list_cats($optionall = 1, $all = 'All', $sort_column = 'ID', $sort_order = 'asc', $file = '', $list = true, $optiondates = 0, $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 1, $children=FALSE, $child_of=0, $categories=0, $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=FALSE) {
    276     global $wpdb, $wp_query;
    277     // Optiondates now works
    278     if ( '' == $file )
    279         $file = get_settings('home') . '/';
    280 
    281     $exclusions = '';
    282     if ( !empty($exclude) ) {
    283         $excats = preg_split('/[\s,]+/',$exclude);
    284         if ( count($excats) ) {
    285             foreach ( $excats as $excat ) {
    286                 $exclusions .= ' AND cat_ID <> ' . intval($excat) . ' ';
    287             }
    288         }
    289     }
    290 
    291     $exclusions = apply_filters('list_cats_exclusions', $exclusions );
    292 
    293     if ( intval($categories) == 0 ) {
    294         $sort_column = 'cat_'.$sort_column;
    295 
    296         $query = "
    297             SELECT cat_ID, cat_name, category_nicename, category_description, category_parent, category_count
    298             FROM $wpdb->categories
    299             WHERE cat_ID > 0 $exclusions
    300             ORDER BY $sort_column $sort_order";
    301 
    302         $categories = $wpdb->get_results($query);
    303     }
    304 
    305     if ( $optiondates ) {
    306         $cat_dates = $wpdb->get_results("   SELECT category_id,
    307         UNIX_TIMESTAMP( MAX(post_date) ) AS ts
    308         FROM $wpdb->posts, $wpdb->post2cat, $wpdb->categories
    309         WHERE post_type = 'post' AND post_status = 'publish' AND post_id = ID $exclusions
    310         GROUP BY category_id");
    311         foreach ( $cat_dates as $cat_date ) {
    312             $category_timestamp["$cat_date->category_id"] = $cat_date->ts;
    313         }
    314     }
    315 
    316     $num_found=0;
    317     $thelist = "";
    318 
    319     foreach ( $categories as $category ) {
    320         if ( ( intval($hide_empty) == 0 || $category->category_count) && (!$hierarchical || $category->category_parent == $child_of) ) {
    321             $num_found++;
    322             $link = '<a href="'.get_category_link($category->cat_ID).'" ';
    323             if ( $use_desc_for_title == 0 || empty($category->category_description) )
    324                 $link .= 'title="'. sprintf(__("View all posts filed under %s"), wp_specialchars($category->cat_name)) . '"';
    325             else
    326                 $link .= 'title="' . wp_specialchars(apply_filters('category_description',$category->category_description,$category)) . '"';
    327             $link .= '>';
    328             $link .= apply_filters('list_cats', $category->cat_name, $category).'</a>';
    329 
    330             if ( (! empty($feed_image)) || (! empty($feed)) ) {
    331 
    332                 $link .= ' ';
    333 
    334                 if ( empty($feed_image) )
    335                     $link .= '(';
    336 
    337                 $link .= '<a href="' . get_category_rss_link(0, $category->cat_ID, $category->category_nicename) . '"';
    338 
    339                 if ( !empty($feed) ) {
    340                     $title = ' title="' . $feed . '"';
    341                     $alt = ' alt="' . $feed . '"';
    342                     $name = $feed;
    343                     $link .= $title;
    344                 }
    345 
    346                 $link .= '>';
    347 
    348                 if ( !empty($feed_image) )
    349                     $link .= "<img src='$feed_image' $alt$title" . ' />';
    350                 else
    351                     $link .= $name;
    352 
    353                 $link .= '</a>';
    354 
    355                 if (empty($feed_image))
    356                     $link .= ')';
    357             }
    358 
    359             if ( intval($optioncount) == 1 )
    360                 $link .= ' ('.intval($category->category_count).')';
    361 
    362             if ( $optiondates ) {
    363                 if ( $optiondates == 1 )
    364                     $optiondates = 'Y-m-d';
    365                 $link .= ' ' . gmdate($optiondates, $category_timestamp["$category->cat_ID"]);
    366             }
    367 
    368             if ( $list ) {
    369                 $thelist .= "\t<li";
    370                 if (($category->cat_ID == $wp_query->get_queried_object_id()) && is_category()) {
    371                     $thelist .=  ' class="current-cat"';
    372                 }
    373                 $thelist .= ">$link\n";
    374             } else {
    375                 $thelist .= "\t$link<br />\n";
    376             }
    377 
    378             if ($hierarchical && $children)
    379                 $thelist .= list_cats($optionall, $all, $sort_column, $sort_order, $file, $list, $optiondates, $optioncount, $hide_empty, $use_desc_for_title, $hierarchical, $category->cat_ID, $categories, 1, $feed, $feed_image, $exclude, $hierarchical);
    380             if ($list)
    381                 $thelist .= "</li>\n";
    382         }
    383     }
    384     if ( !$num_found && !$child_of ) {
    385         if ( $list ) {
    386             $before = '<li>';
    387             $after = '</li>';
    388         }
    389         echo $before . __("No categories") . $after . "\n";
    390         return;
    391     }
    392     if ( $list && $child_of && $num_found && $recurse ) {
    393         $pre = "\t\t<ul class='children'>";
    394         $post = "\t\t</ul>\n";
    395     } else {
    396         $pre = $post = '';
    397     }
    398     $thelist = $pre . $thelist . $post;
    399     if ( $recurse )
    400         return $thelist;
    401     echo apply_filters('list_cats', $thelist);
     388    $query = "optionall=$optionall&all=$all&sort_column=$sort_column&sort_order=$sort_order&list=$list&optiondates=$optiondates&optioncount=$optioncount&hide_empty=$hide_empty&use_desc_for_title=$use_desc_for_title&child_of=$child_of&feed=$feed&feed_image=$feed_image&exclude=$exclude&hierarchical=$hierarchical";
     389    return wp_list_cats($query);
    402390}
    403391
    … …  
    409397    else
    410398        return false;
     399}
     400
     401function &_get_cat_children($category_id, $categories) {
     402    if ( empty($categories) )
     403        return array();
     404
     405    $category_list = array();
     406    foreach ( $categories as $category ) {
     407        if ( $category->category_parent == $category_id ) {
     408            $category_list[] = $category;
     409            if ( $children = _get_cat_children($category->cat_ID, $categories) )
     410                $category_list = array_merge($category_list, $children);
     411        }
     412    }
     413
     414    return $category_list;
    411415}
    412416
    … …  
    426430    if ( !isset($r['hide_empty']) )
    427431        $r['hide_empty'] = true;
     432    if ( !isset($r['include_last_update_time']) )
     433        $r['include_last_update_time'] = false;
     434    if ( !isset($r['hierarchical']) )
     435        $r['hierarchical'] = 1;
    428436
    429437    $r['orderby'] = "cat_" . $r['orderby'];
    430438
     439    extract($r);
     440
    431441    $exclusions = '';
    432     if ( !empty($r['exclude']) ) {
    433         $excategories = preg_split('/[\s,]+/',$r['exclude']);
     442    $having = '';
     443    $where = 'cat_ID > 0';
     444
     445    $exclusions = '';
     446    if ( !empty($exclude) ) {
     447        $excategories = preg_split('/[\s,]+/',$exclude);
    434448        if ( count($excategories) ) {
    435449            foreach ( $excategories as $excat ) {
    … …  
    438452        }
    439453    }
    440 
    441     $categories = $wpdb->get_results("SELECT * " .
    442         "FROM $wpdb->categories " .
    443         "$exclusions " .
    444         "ORDER BY " . $r['orderby'] . " " . $r['order']);
     454    $exclusions = apply_filters('list_cats_exclusions', $exclusions );
     455    $where .= $exclusions;
     456
     457    if ( $hide_empty ) {
     458        if ( 'link' == $type )
     459            $having = 'HAVING link_count > 0';
     460        else
     461            $having = 'HAVING category_count > 0';
     462    }
     463
     464    $categories = $wpdb->get_results("SELECT * FROM $wpdb->categories WHERE $where $having ORDER BY $orderby $order");
    445465
    446466    if ( empty($categories) )
    447467        return array();
    448468
    449     if ( $r['hide_empty'] ) {
    450         foreach ( $categories as $category ) {
    451             $count = 0;
    452             if ( 'link' == $r['type'] ) {
    453                 $count = $category->link_count;
    454             } else {
    455                 $count = $category->category_count;
    456             }
    457             if ( $count )
    458                 $the_categories[] = $category;
    459         }
    460         $categories = $the_categories;
    461     }
    462 
    463     /* if ( $r['child_of'] )
    464         $categories = & get_category_children($r['child_of'], $categories); */
     469    if ( $include_last_update_time ) {
     470        $stamps = $wpdb->get_results("SELECT category_id, UNIX_TIMESTAMP( MAX(post_date) ) AS ts FROM $wpdb->posts, $wpdb->post2cat, $wpdb->categories
     471                            WHERE post_status = 'publish' AND post_id = ID AND $where GROUP BY category_id");
     472        global $cat_stamps;
     473        foreach ($stamps as $stamp)
     474            $cat_stamps[$stamp->category_id] = $stamp->ts;
     475        function stamp_cat($cat) {
     476            global $cat_stamps;
     477            $cat->last_update_timestamp = $cat_stamps[$cat->cat_ID];
     478            return $cat;   
     479        }
     480        $categories = array_map('stamp_cat', $categories);
     481        unset($cat_stamps);
     482    }
     483
     484    if ( $child_of || $hierarchical )
     485        $categories = & _get_cat_children($child_of, $categories);
    465486
    466487    return $categories;
Note: See TracChangeset for help on using the changeset viewer.