Make WordPress Core

Opened 12 years ago

Closed 9 years ago

#19780 closed enhancement (maybelater)

Named category functions/docs need cleaning up

Reported by: drewapicture's profile DrewAPicture Owned by:
Milestone: Priority: normal
Severity: normal Version:
Component: Taxonomy Keywords: has-patch needs-refresh needs-unit-tests
Focuses: Cc:

Description (last modified by helenyhou)

Spawning from a small discussion in #19776, I think it's about time something is done to deal with the older named category functions such as wp_category_dropdown and wp_list_categories in category-template.php

These functions aren't technically category-only as they accept a set $taxonomy. And because they are actually taxonomy-agnostic, I think we have a few different routes we can take to clean up after ourselves a bit:

A) Lock down these functions to 'categories'-only in favor of new, taxonomy-agnostic ones.

B) Leave the functions alone but let the inline-docs and hard-coded strings such as 'No Categories' reflect their versatility. e.g. 'No Terms' vs 'No Categories'.

C) Deprecate these older functions in deference to newer, taxonomy-agnostic ones.

Attachments (4)

19780.diff (1.8 KB) - added by evansolomon 12 years ago.
19780.2.diff (1.8 KB) - added by evansolomon 12 years ago.
Fixes gramatical typos. Props helenyhou
19780.3.diff (8.7 KB) - added by lkwdwrd 11 years ago.
19780.4.diff (13.2 KB) - added by DrewAPicture 8 years ago.
wp_list_terms()

Download all attachments as: .zip

Change History (17)

#1 @DrewAPicture
12 years ago

Sorry, should be #19776. Can somebody modify the description? Edit: Thanks, helenyhou

Last edited 12 years ago by DrewAPicture (previous) (diff)

#2 @helenyhou
12 years ago

  • Description modified (diff)

@evansolomon
12 years ago

#3 @evansolomon
12 years ago

19780.diff adds wp_dropdown_terms() and wp_list_terms() as wrappers for their respective "category" functions. It doesn't deprecate the existing functions or change their behavior, it just adds the new ones.

The main benefit here is making it easier for people to find the functions that do what they want. For example, when looking for a function to list terms I didn't realize that I could pass a taxonomy to wp_list_categories(), which was frustrating for a while.

#4 @helenyhou
12 years ago

  • Keywords has-patch added

@evansolomon
12 years ago

Fixes gramatical typos. Props helenyhou

#5 @Offereins
11 years ago

I'd prefer this rewrite to taxonomy-agnostic behaviour to be more complete. Therefor also the filters (like list_cats, wp_list_cats, wp_dropdown_cats) and the filters in the Walker classes should be rewritten to a taxonomy-agnostic style. Additionally 1) the list_cats filter in the Walker classes would do great when sending the $args variable as third parameter and 2) we might not wrap each list item with an <a> tag by default; I could think of use cases where I would want to set a custom href attribute on it or don't use an <a> tag at all (@see Walker_Category::start_el()).

Concerning the wp_dropdown_terms and wp_list_terms solutions, I'd say they'd be better off the other way around, as the base of the category functions instead of the wrapper type like it's suggested in 19780.diff. This would result in wp_dropdown_categories being a wrapper for wp_dropdown_terms etc.

Last edited 11 years ago by Offereins (previous) (diff)

@lkwdwrd
11 years ago

#6 @lkwdwrd
11 years ago

Ran into this the other day. wp_dropdown_categories is a misnomer, and should really be a wrapper for something like wp_dropdown_terms to make it more clear. Same with wp_list_categories and wp_list_terms. Finished patching for wp_dropdown_terms, and I will continue working on wp_list_terms when I have a chance, but I figure I'll post what I've got so far so others can give feedback if desired.

#7 @lkwdwrd
11 years ago

  • Cc lkwdwrd added

#8 @DrewAPicture
11 years ago

Now, 19780.3.diff is what I call a great first patch! (wcpdx contributor day)

#9 @ramiy
11 years ago

Related #16677

#10 @wonderboymusic
10 years ago

#19776 was marked as a duplicate.

#11 @wonderboymusic
10 years ago

  • Keywords needs-refresh needs-unit-tests added
  • Milestone changed from Awaiting Review to Future Release

If anyone wants to work on this, could be a 4.0 thing

#12 @DrewAPicture
10 years ago

I want to work on this. :-)

#13 @DrewAPicture
9 years ago

  • Milestone Future Release deleted
  • Resolution set to maybelater
  • Status changed from new to closed

No meaningful interest in 2 years, and this is not a priority for me right now. Closing as maybelater.

@DrewAPicture
8 years ago

wp_list_terms()

Note: See TracTickets for help on using tickets.