Index: category-template.php =================================================================== --- category-template.php (revision 6597) +++ category-template.php (working copy) @@ -1,11 +1,29 @@ get_category_permastruct(); @@ -44,6 +71,19 @@ return apply_filters('category_link', $catlink, $category_id); } +/** + * get_category_parents() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 1.2.0 + * + * @param unknown_type $id + * @param unknown_type $link + * @param unknown_type $separator + * @param unknown_type $nicename + * @return unknown + */ function get_category_parents($id, $link = FALSE, $separator = '/', $nicename = FALSE){ $chain = ''; $parent = &get_category($id); @@ -65,6 +105,18 @@ return $chain; } +/** + * get_the_category() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 0.71 + * @uses $post + * @global mixed $term_cache + * + * @param unknown_type $id + * @return unknown + */ function get_the_category($id = false) { global $post; @@ -88,10 +140,32 @@ return $categories; } +/** + * _usort_terms_by_name() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.3.0 + * + * @param unknown_type $a + * @param unknown_type $b + * @return unknown + */ function _usort_terms_by_name($a, $b) { return strcmp($a->name, $b->name); } +/** + * _usort_terms_by_ID() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.3.0 + * + * @param unknown_type $a + * @param unknown_type $b + * @return unknown + */ function _usort_terms_by_ID($a, $b) { if ( $a->term_id > $b->term_id ) return 1; @@ -101,6 +175,16 @@ return 0; } +/** + * get_the_category_by_ID() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 0.71 + * + * @param unknown_type $cat_ID + * @return unknown + */ function get_the_category_by_ID($cat_ID) { $cat_ID = (int) $cat_ID; $category = &get_category($cat_ID); @@ -109,6 +193,17 @@ return $category->name; } +/** + * get_the_category_list() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 1.5.1 + * + * @param unknown_type $separator + * @param unknown_type $parents + * @return unknown + */ function get_the_category_list($separator = '', $parents='') { global $wp_rewrite; $categories = get_the_category(); @@ -167,6 +262,16 @@ return apply_filters('the_category', $thelist, $separator, $parents); } +/** + * in_category() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 1.2.0 + * + * @param unknown_type $category + * @return unknown + */ function in_category( $category ) { // Check if the current post is in the given category global $post; @@ -179,10 +284,28 @@ return false; } +/** + * the_category() - {@internal Missing Short Description}} + * + * @since 0.71 + * + * @param unknown_type $separator + * @param unknown_type $parents + */ function the_category($separator = '', $parents='') { echo get_the_category_list($separator, $parents); } +/** + * category_description() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.1.0 + * + * @param unknown_type $category + * @return unknown + */ function category_description($category = 0) { global $cat; if ( !$category ) @@ -191,6 +314,16 @@ return get_term_field('description', $category, 'category'); } +/** + * wp_dropdown_categories() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.1.0 + * + * @param unknown_type $args + * @return unknown + */ function wp_dropdown_categories($args = '') { $defaults = array( 'show_option_all' => '', 'show_option_none' => '', @@ -241,6 +374,16 @@ return $output; } +/** + * wp_list_categories() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.1.0 + * + * @param unknown_type $args + * @return unknown + */ function wp_list_categories($args = '') { $defaults = array( 'show_option_all' => '', 'orderby' => 'name', @@ -307,6 +450,16 @@ return $output; } +/** + * wp_tag_cloud() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.3.0 + * + * @param unknown_type $args + * @return unknown + */ function wp_tag_cloud( $args = '' ) { $defaults = array( 'smallest' => 8, 'largest' => 22, 'unit' => 'pt', 'number' => 45, @@ -327,9 +480,20 @@ echo apply_filters( 'wp_tag_cloud', $return, $args ); } -// $tags = prefetched tag array ( get_tags() ) -// $args['format'] = 'flat' => whitespace separated, 'list' => UL, 'array' => array() -// $args['orderby'] = 'name', 'count' +/** + * wp_generate_tag_cloud() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * $tags = prefetched tag array ( get_tags() ) + * $args['format'] = 'flat' => whitespace separated, 'list' => UL, 'array' => array() + * $args['orderby'] = 'name', 'count' + * + * @since 2.3.0 + * + * @param unknown_type $tags + * @param unknown_type $args + * @return unknown + */ function wp_generate_tag_cloud( $tags, $args = '' ) { global $wp_rewrite; $defaults = array( @@ -402,12 +566,30 @@ // Helper functions // +/** + * walk_category_tree() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.1.0 + * + * @return unknown + */ function walk_category_tree() { $walker = new Walker_Category; $args = func_get_args(); return call_user_func_array(array(&$walker, 'walk'), $args); } +/** + * walk_category_dropdown_tree() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.1.0 + * + * @return unknown + */ function walk_category_dropdown_tree() { $walker = new Walker_CategoryDropdown; $args = func_get_args(); @@ -418,6 +600,16 @@ // Tags // +/** + * get_tag_link() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.3.0 + * + * @param unknown_type $tag_id + * @return unknown + */ function get_tag_link( $tag_id ) { global $wp_rewrite; $taglink = $wp_rewrite->get_tag_permastruct(); @@ -437,6 +629,16 @@ return apply_filters('tag_link', $taglink, $tag_id); } +/** + * get_the_tags() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.3.0 + * + * @param unknown_type $id + * @return unknown + */ function get_the_tags( $id = 0 ) { global $post; @@ -458,6 +660,18 @@ return $tags; } +/** + * get_the_tag_list() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.3.0 + * + * @param unknown_type $before + * @param unknown_type $sep + * @param unknown_type $after + * @return unknown + */ function get_the_tag_list( $before = '', $sep = '', $after = '' ) { $tags = get_the_tags(); @@ -481,6 +695,18 @@ return $tag_list; } +/** + * the_tags() - {@internal Missing Short Description}} + * + * {@internal Missing Long Description}} + * + * @since 2.3.0 + * + * @param unknown_type $before + * @param unknown_type $sep + * @param unknown_type $after + * @return unknown + */ function the_tags( $before = 'Tags: ', $sep = ', ', $after = '' ) { $return = get_the_tag_list($before, $sep, $after); if ( is_wp_error( $return ) ) @@ -489,4 +715,4 @@ echo $return; } -?> +?> \ No newline at end of file