unregister_taxonomy( string $taxonomy )
Unregisters a taxonomy.
Description Description
Can not be used to unregister built-in taxonomies.
Parameters Parameters
- $taxonomy
-
(string) (Required) Taxonomy name.
Return Return
(bool|WP_Error) True on success, WP_Error on failure or if the taxonomy doesn't exist.
Source Source
File: wp-includes/taxonomy.php
function unregister_taxonomy( $taxonomy ) {
if ( ! taxonomy_exists( $taxonomy ) ) {
return new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );
}
$taxonomy_object = get_taxonomy( $taxonomy );
// Do not allow unregistering internal taxonomies.
if ( $taxonomy_object->_builtin ) {
return new WP_Error( 'invalid_taxonomy', __( 'Unregistering a built-in taxonomy is not allowed.' ) );
}
global $wp_taxonomies;
$taxonomy_object->remove_rewrite_rules();
$taxonomy_object->remove_hooks();
// 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;
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 4.5.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
add_action( 'init', 'wpname_unregister_taxonomy' ); function wpname_unregister_taxonomy() { unregister_taxonomy( 'product_category'); }Unregister the Taxonomy simple example:
if( !function_exists( 'plugin_prefix_unregister_taxonomy' ) ) { function plugin_prefix_unregister_taxonomy(){ unregister_taxonomy( 'project-type' ); } } add_action('init','plugin_prefix_unregister_taxonomy');