Ticket #20359: category-template-#20359.php.diff

category-template.php

@@ -390 +390 @@
  * in the category.
  *     'hide_empty' (bool|int) default is 1 - Whether to hide categories that
  * don't have any posts attached to them.
- *     'use_desc_for_title' (bool|int) default is 1 - Whether to use the
- * description instead of the category title.
+ *     'use_desc_for_title' (string) default is 'desc' - Control title attributes
+ * of category links. 'desc' => Output cat descriptions; 'viewall' => Output
+ * 'View all posts filed under @category'; 'none' => Does not output titles.
  *     'feed' - See {@link get_categories()}.
  *     'feed_type' - See {@link get_categories()}.
  *     'feed_image' - See {@link get_categories()}.
@@ -415 +416 @@
                 'orderby' => 'name', 'order' => 'ASC',
                 'style' => 'list',
                 'show_count' => 0, 'hide_empty' => 1,
-                'use_desc_for_title' => 1, 'child_of' => 0,
+                'use_desc_for_title' => 'desc', 'child_of' => 0,
                 'feed' => '', 'feed_type' => '',
                 'feed_image' => '', 'exclude' => '',
                 'exclude_tree' => '', 'current_category' => 0,
@@ -826 +827 @@
                 $cat_name = esc_attr( $category->name );
                 $cat_name = apply_filters( 'list_cats', $cat_name, $category );
                 $link = '<a href="' . esc_attr( get_term_link($category) ) . '" ';
-                if ( $use_desc_for_title == 0 || empty($category->description) )
+                if ( $use_desc_for_title === 'desc' )
+                        $link .= 'title="' . esc_attr( strip_tags( apply_filters( 'category_description', $category->description, $category ) ) ) . '"';
+                elseif ( $use_desc_for_title === 'viewall' )
                         $link .= 'title="' . esc_attr( sprintf(__( 'View all posts filed under %s' ), $cat_name) ) . '"';
-                else
-                        $link .= 'title="' . esc_attr( strip_tags( apply_filters( 'category_description', $category->description, $category ) ) ) . '"';
+                elseif ( $use_desc_for_title === 'none' )
+                        $link = $link;
                 $link .= '>';
                 $link .= $cat_name . '</a>';
 

deprecated.php

@@ -622 +622 @@
  * @param int $optiondates
  * @param int $optioncount
  * @param int $hide_empty
- * @param int $use_desc_for_title
+ * @param string $use_desc_for_title
  * @param bool $children
  * @param int $child_of
  * @param int $categories
@@ -634 +634 @@
  * @return unknown
  */
 function 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,
+                                   $optioncount = 0, $hide_empty = 1, $use_desc_for_title = 'desc', $children=false, $child_of=0, $categories=0,
                                    $recurse=0, $feed = '', $feed_image = '', $exclude = '', $hierarchical=false) {
         _deprecated_function( __FUNCTION__, '2.1', 'wp_list_categories()' );