Add option to pass an array of objects or IDs to $current_category in wp_list_categories()

[vilkatis]

I needed to pass an array of objects to $current_category a couple of times, and had to make a custom walker for that.
Would be nice if it was a part of core.

[boonebgorges]

Patch seems OK to me. Any chance you could take a swing at writing a few unit tests for it?

Out of curiosity, what is the use case for having more than one current_category?

[vilkatis]

Added unit tests

[vilkatis]

I added two unit tests that I could think of , don't know if that's enough or if I did them right.

I used it for some clients who had products belonging to a couple of categories at the same time , as they wanted all relevant categories to be highlighted in a sidebar menu.

[boonebgorges]

In 33767:

Rename param added to wp_list_categories() in [33764] to 'hide_title_if_empty'.

Props vilkatis, DrewAPicture.
Fixes #33565.

[SergeyBiryukov]

[33767] was for #33460.

[boonebgorges]

Replying to SergeyBiryukov:

[33767] was for #33460.

Gah.

[boonebgorges]

Replying to vilkatis:

I added two unit tests that I could think of , don't know if that's enough or if I did them right.

I used it for some clients who had products belonging to a couple of categories at the same time , as they wanted all relevant categories to be highlighted in a sidebar menu.

Thanks, this seems sensible.

Looking at it more closely, I don't think that it's a great idea for us to start accepting term objects in addition to term IDs. There aren't many places where we do this for terms (at least not that I can think of). When and if we have a proper WP_Term object, perhaps we can start thinking of retrofitting functions to accept it.

I've simplified the patch and the unit tests in 33565.2.diff​.

[vilkatis]

Yeah that looks great , thanks for the help ! Passing term IDs makes the most sense indeed

[boonebgorges]

In 33804:

In wp_list_categories(), 'current_category' should accept an array of values.

This allows the 'current-cat' or 'current-cat-parent' classes to be applied
to more than one item in the list.

Props vilkatis.
Fixes #33565.