wpseek.com
A WordPress-centric search engine for devs and theme authors
unregister_taxonomy › WordPress Function
Since4.5.0
Deprecatedn/a
› unregister_taxonomy ( $taxonomy )
Parameters: |
|
Returns: |
|
Defined at: |
|
Codex: |
Unregisters a taxonomy.
Can not be used to unregister built-in taxonomies.Related Functions: register_taxonomy, unregister_meta_key, is_taxonomy, get_taxonomy, unregister_taxonomy_for_object_type
Source
function unregister_taxonomy( $taxonomy ) {
global $wp_taxonomies;
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.' ) );
}
$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;
}