[wp-trac] [WordPress Trac] #19780: Named category functions/docs need cleaning up

WordPress Trac wp-trac at lists.automattic.com
Sun Jan 8 22:22:20 UTC 2012


#19780: Named category functions/docs need cleaning up
--------------------------+-----------------------------
 Reporter:  DrewAPicture  |      Owner:
     Type:  enhancement   |     Status:  new
 Priority:  normal        |  Milestone:  Awaiting Review
Component:  Taxonomy      |    Version:
 Severity:  normal        |   Keywords:
--------------------------+-----------------------------
 Spawning from a small discussion in #19766, 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 Categoriies'.

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

-- 
Ticket URL: <http://core.trac.wordpress.org/ticket/19780>
WordPress Trac <http://core.trac.wordpress.org/>
WordPress blogging software


More information about the wp-trac mailing list