Changeset 31027

Timestamp:

01/03/2015 02:30:14 AM (12 years ago)

Author:

boonebgorges

Message:

Introduce 'category_css_classes' filter.

Paralleling the 'page_css_classes' filter, this allows developers to modify
the list of CSS classes used when creating category list markup via
Walker_Category.

Props sivel.
Fixes #16497.

File:

• trunk/src/wp-includes/category-template.php (modified) (1 diff)

trunk/src/wp-includes/category-template.php

@@ -1054 +1054 @@
                 if ( 'list' == $args['style'] ) {
                         $output .= "\t<li";
-                        $class = 'cat-item cat-item-' . $category->term_id;
+                        $css_classes = array(
+                                'cat-item',
+                                'cat-item-' . $category->term_id,
+                        );
+
                         if ( ! empty( $args['current_category'] ) ) {
                                 $_current_category = get_term( $args['current_category'], $category->taxonomy );
                                 if ( $category->term_id == $args['current_category'] ) {
-                                        $class .=  ' current-cat';
+                                        $css_classes[] = 'current-cat';
                                 } elseif ( $category->term_id == $_current_category->parent ) {
-                                        $class .=  ' current-cat-parent';
+                                        $css_classes[] = 'current-cat-parent';
                                 }
                         }
-                        $output .=  ' class="' . $class . '"';
+
+                        /**
+                         * Filter the list of CSS classes to include with each category in the list.
+                         *
+                         * @since 4.2.0
+                         *
+                         * @see wp_list_categories()
+                         *
+                         * @param array  $css_classes    An array of CSS classes to be applied
+                         *                               to each list item.
+                         * @param object $category       Category data object.
+                         * @param int    $depth          Depth of page, used for padding.
+                         * @param array  $args           An array of arguments.
+                         */
+                        $css_classes = implode( ' ', apply_filters( 'category_css_class', $css_classes, $category, $depth, $args ) );
+
+                        $output .=  ' class="' . $css_classes . '"';
                         $output .= ">$link\n";
                 } else {