Changeset 7520 for trunk/wp-includes/taxonomy.php

Timestamp:

03/26/2008 06:37:19 AM (17 years ago)

Author:

ryan

Message:

Taxonomy links and template tags from andy. see #6357

File:

• trunk/wp-includes/taxonomy.php (modified) (9 diffs)

trunk/wp-includes/taxonomy.php

@@ -35 +35 @@
  * @uses $wp_taxonomies
  *
- * @param array|string $object_type Name of the type of taxonomy object
+ * @param array|string|object $object Name of the type of taxonomy object, or an object (row from posts)
  * @return array The names of all taxonomy of $object_type.
  */
-function get_object_taxonomies($object_type) {
+function get_object_taxonomies($object) {
     global $wp_taxonomies;
+
+    if ( is_object($object) ) {
+        if ( $object->post_type == 'attachment' )
+            return get_attachment_taxonomies($object);
+        $object = $object->post_type;
+    }
+
+    $object = (array) $object;
 
     $taxonomies = array();
     foreach ( $wp_taxonomies as $taxonomy ) {
-        if ( in_array($object_type, (array) $taxonomy->object_type) )
+        if ( array_intersect($object, (array) $taxonomy->object_type) )
             $taxonomies[] = $taxonomy->name;
     }
@@ -120 +128 @@
 
 /**
- * register_taxonomy() - Create or modify a taxonomy object.
+ * register_taxonomy() - Create or modify a taxonomy object. Do not use before init.
  *
  * A simple function for creating or modifying a taxonomy object based on the parameters given.
@@ -126 +134 @@
  * taxonomy name and another string for the object type.
  *
- * The function keeps a default set, allowing for the $args to be optional but allow the other
- * functions to still work. It is possible to overwrite the default set, which contains two
- * keys: hierarchical and update_count_callback.
- *
  * Nothing is returned, so expect error maybe or use is_taxonomy() to check whether taxonomy exists.
  *
@@ -135 +139 @@
  * hierarachical - has some defined purpose at other parts of the API and is a boolean value.
  * update_count_callback - works much like a hook, in that it will be called when the count is updated.
+ * rewrite - false to prevent rewrite, or array('slug'=>$slug) to customize permastruct; default will use $taxonomy as slug
+ * query_var - false to prevent queries, or string to customize query var (?$query_var=$term); default will use $taxonomy as query var
  *
  * @package WordPress
@@ -140 +146 @@
  * @since 2.3
  * @uses $wp_taxonomies Inserts new taxonomy object into the list
+ * @uses $wp_rewrite Adds rewrite tags and permastructs
+ * @uses $wp Adds query vars
  *
  * @param string $taxonomy Name of taxonomy object
@@ -146 +154 @@
  */
 function register_taxonomy( $taxonomy, $object_type, $args = array() ) {
-    global $wp_taxonomies, $wp_rewrite;
-
-    $defaults = array('hierarchical' => false, 'update_count_callback' => '');
+    global $wp_taxonomies, $wp_rewrite, $wp;
+
+    $defaults = array('hierarchical' => false, 'update_count_callback' => '', 'rewrite' => true, 'query_var' => true);
     $args = wp_parse_args($args, $defaults);
 
-    if ( !empty( $args['rewrite'] ) ) {
+    if ( false !== $args['query_var'] ) {
+        if ( empty($args['query_var']) )
+            $args['query_var'] = $taxonomy;
+        $args['query_var'] = sanitize_title_with_dashes($args['query_var']);
+        $wp->add_query_var($args['query_var']);
+    }
+
+    if ( false !== $args['rewrite'] ) {
         if ( !is_array($args['rewrite']) )
             $args['rewrite'] = array();
         if ( !isset($args['rewrite']['slug']) )
             $args['rewrite']['slug'] = sanitize_title_with_dashes($taxonomy);
-        $wp_rewrite->add_rewrite_tag("%$taxonomy%", '([^/]+)', "taxonomy=$taxonomy&term=");
-        $wp_rewrite->add_permastruct("{$args['rewrite']['slug']}/%$taxonomy%");
+        $wp_rewrite->add_rewrite_tag("%$taxonomy%", '([^/]+)', $args['query_var'] ? "{$args['query_var']}=" : "taxonomy=$taxonomy&term=$term");
+        $wp_rewrite->add_permastruct($taxonomy, "{$args['rewrite']['slug']}/%$taxonomy%");
     }
 
@@ -1037 +1052 @@
     $defaults = array('orderby' => 'name', 'order' => 'ASC', 'fields' => 'all');
     $args = wp_parse_args( $args, $defaults );
+
+    $terms = array();
+    if ( count($taxonomies) > 1 ) {
+        foreach ( $taxonomies as $index => $taxonomy ) {
+            $t = get_taxonomy($taxonomy);
+            if ( is_array($t->args) && $args != array_merge($args, $t->args) ) {
+                unset($taxonomies[$index]);
+                $terms = array_merge($terms, wp_get_object_terms($object_ids, $taxonomy, array_merge($args, $t->args)));
+            }
+        }
+    } else {
+        $t = get_taxonomy($taxonomies[0]);
+        if ( is_array($t->args) )
+            $args = array_merge($args, $t->args);
+    }
+
     extract($args, EXTR_SKIP);
 
@@ -1068 +1099 @@
 
     if ( 'all' == $fields || 'all_with_object_id' == $fields ) {
-        $terms = $wpdb->get_results($query);
+        $terms = array_merge($terms, $wpdb->get_results($query));
         update_term_cache($terms);
     } else if ( 'ids' == $fields || 'names' == $fields ) {
-        $terms = $wpdb->get_col($query);
+        $terms = array_merge($terms, $wpdb->get_col($query));
     } else if ( 'tt_ids' == $fields ) {
         $terms = $wpdb->get_col("SELECT tr.term_taxonomy_id FROM $wpdb->term_relationships AS tr INNER JOIN $wpdb->term_taxonomy AS tt ON tr.term_taxonomy_id = tt.term_taxonomy_id WHERE tr.object_id IN ($object_ids) AND tt.taxonomy IN ($taxonomies) ORDER BY tr.term_taxonomy_id $order");
@@ -1900 +1931 @@
 }
 
+/**
+ * get_term_link() - Generates a permalink for a taxonomy term archive
+ *
+ * @param object|int|string $term
+ * @param string $taxonomy
+ * @return string HTML link to taxonomy term archive
+ */
+function get_term_link( $term, $taxonomy ) {
+    global $wp_rewrite;
+
+    $termlink = $wp_rewrite->get_extra_permastruct($taxonomy);
+
+    if ( !is_object($term) ) {
+        if ( is_int($term) ) {
+            $term = &get_term($term, $taxonomy);
+        } else {
+            $term = &get_term_by('slug', $term, $taxonomy);
+        }
+    }
+    if ( is_wp_error( $term ) )
+        return $term;
+
+    $slug = $term->slug;
+
+    if ( empty($termlink) ) {
+        $file = get_option('home') . '/';
+        $t = get_taxonomy($taxonomy);
+        if ( $t->query_var )
+            $termlink = "$file?$t->query_var=$slug";
+        else
+            $termlink = "$file?taxonomy=$taxonomy&term=$slug";
+    } else {
+        $termlink = str_replace("%$taxonomy%", $slug, $termlink);
+        $termlink = get_option('home') . user_trailingslashit($termlink, 'category');
+    }
+    return apply_filters('term_link', $termlink, $term, $taxonomy);
+}
+
+function the_taxonomies($args = array()) {
+    $defaults = array(
+        'post' => 0,
+        'before' => '',
+        'sep' => ' ',
+        'after' => '',
+    );
+
+    $r = wp_parse_args( $args, $defaults );
+    extract( $r, EXTR_SKIP );
+
+    echo $before . join($sep, get_the_taxonomies($post)) . $after;
+}
+
+function get_the_taxonomies($post = 0) {
+    if ( is_int($post) )
+        $post =& get_post($post);
+    elseif ( !is_object($post) )
+        $post =& $GLOBALS['post'];
+
+    $taxonomies = array();
+
+    if ( !$post )
+        return $taxonomies;
+
+    $_template = '%s: %l.';
+
+    foreach ( get_object_taxonomies($post) as $taxonomy ) {
+        $t = (array) get_taxonomy($taxonomy);
+        if ( empty($t['label']) )
+            $t['label'] = $taxonomy;
+        if ( empty($t['args']) )
+            $t['args'] = array();
+        if ( empty($t['template']) )
+            $t['template'] = $_template;
+
+        $terms = get_object_term_cache($post->ID, $taxonomy);
+        if ( empty($terms) )
+            $terms = wp_get_object_terms($post->ID, $taxonomy, $t['args']);
+
+        $links = array();
+
+        foreach ( $terms as $term )
+            $links[] = "<a href='" . attribute_escape(get_term_link($term, $taxonomy)) . "'>$term->name</a>";
+
+        if ( $links )
+            $taxonomies[$taxonomy] = wp_sprintf($t['template'], $t['label'], $links, $terms);
+    }
+    return $taxonomies;
+}
+
+function get_post_taxonomies($post = 0) {
+    $post =& get_post($post);
+
+    return get_object_taxonomies($post);
+}
+
 ?>