Changeset 36243 for trunk/src/wp-includes/taxonomy.php

Timestamp:

01/09/2016 02:57:22 PM (9 years ago)

Author:

swissspidy

Message:

Taxonomy: Introduce unregister_taxonomy().

This new function can be used to completely unregister non built-in taxonomies.

Fixes #35227.

File:

• trunk/src/wp-includes/taxonomy.php (modified) (1 diff)

trunk/src/wp-includes/taxonomy.php

@@ -474 +474 @@
      */
     do_action( 'registered_taxonomy', $taxonomy, $object_type, $args );
+}
+
+/**
+ * Unregister a taxonomy.
+ *
+ * Can not be used to unregister built-in taxonomies.
+ *
+ * @since 4.5.0
+ *
+ * @global WP    $wp            Current WordPress environment instance.
+ * @global array $wp_taxonomies List of taxonomies.
+ *
+ * @param string $taxonomy Taxonomy name.
+ * @return bool|WP_Error True on success, WP_Error on failure.
+ */
+function unregister_taxonomy( $taxonomy ) {
+    if ( ! taxonomy_exists( $taxonomy ) ) {
+        return new WP_Error( 'invalid_taxonomy', __( 'Invalid Taxonomy' ) );
+    }
+
+    $taxonomy_args = get_taxonomy( $taxonomy );
+
+    // Do not allow unregistering internal taxonomies.
+    if ( $taxonomy_args->_builtin ) {
+        return new WP_Error( 'invalid_taxonomy', __( 'Unregistering a built-in taxonomy is not allowed' ) );
+    }
+
+    global $wp, $wp_taxonomies;
+
+    // Remove query var.
+    if ( false !== $taxonomy_args->query_var ) {
+        $wp->remove_query_var( $taxonomy_args->query_var );
+    }
+
+    // Remove rewrite tags and permastructs.
+    if ( false !== $taxonomy_args->rewrite ) {
+        remove_rewrite_tag( "%$taxonomy%" );
+        remove_permastruct( $taxonomy );
+    }
+
+    // Unregister callback handling for metabox.
+    remove_filter( 'wp_ajax_add-' . $taxonomy, '_wp_ajax_add_hierarchical_term' );
+
+    // Remove the taxonomy.
+    unset( $wp_taxonomies[ $taxonomy ] );
+
+    /**
+     * Fires after a taxonomy is unregistered.
+     *
+     * @since 4.5.0
+     *
+     * @param string $taxonomy Taxonomy name.
+     */
+    do_action( 'unregistered_taxonomy', $taxonomy );
+
+    return true;
 }