unregister_taxonomy_for_object_type( string $taxonomy, string $object_type ): bool

Removes an already registered taxonomy from an object type.

Contents

Parameters
Return
Source
Hooks
Related
- Uses
- Used By
Changelog
User Contributed Notes
- Feedback

Parameters

$taxonomy string Required: Name of taxonomy object.
$object_type string Required: Name of the object type.

Return

bool True if successful, false if not.

Source

File: wp-includes/taxonomy.php. View all references

function unregister_taxonomy_for_object_type( $taxonomy, $object_type ) {
	global $wp_taxonomies;

	if ( ! isset( $wp_taxonomies[ $taxonomy ] ) ) {
		return false;
	}

	if ( ! get_post_type_object( $object_type ) ) {
		return false;
	}

	$key = array_search( $object_type, $wp_taxonomies[ $taxonomy ]->object_type, true );
	if ( false === $key ) {
		return false;
	}

	unset( $wp_taxonomies[ $taxonomy ]->object_type[ $key ] );

	/**
	 * Fires after a taxonomy is unregistered for an object type.
	 *
	 * @since 5.1.0
	 *
	 * @param string $taxonomy    Taxonomy name.
	 * @param string $object_type Name of the object type.
	 */
	do_action( 'unregistered_taxonomy_for_object_type', $taxonomy, $object_type );

	return true;
}

View on Trac View on GitHub

Hooks

do_action( 'unregistered_taxonomy_for_object_type', string $taxonomy, string $object_type )

Fires after a taxonomy is unregistered for an object type.

Uses

Uses
Uses	Description
do_action() wp-includes/plugin.php	Calls the callback functions that have been added to an action hook.
get_post_type_object() wp-includes/post.php	Retrieves a post type object by name.

Used By

Used By
Used By	Description
WP_Post_Type::unregister_taxonomies() wp-includes/class-wp-post-type.php	Removes the post type from all taxonomies.

Changelog

Changelog
Version	Description
3.7.0	Introduced.

User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

Contributed by Jonathan Goldford — 6 years ago
Below is an example of how you can entirely remove tags from use for blog posts. This code will remove the Tags admin menu item, the Tags column when viewing the list of posts and the Tags metabox when editing a single post.
```
function wpdocs_unregister_tags_for_posts() {
    unregister_taxonomy_for_object_type( 'post_tag', 'post' );
}
add_action( 'init', 'wpdocs_unregister_tags_for_posts' );
```
Top ↑
Feedback
- Since PHP 8 this code shows an error in WordPress admin: Warning: Undefined array key 2 in /wp-admin/includes/plugin.php on line 1937 I had to disable this code from the functions.php file in multiple client websites. — By Tibow — 2 months ago
Log in to add feedback
Skip to note 2 content

You must log in to vote on the helpfulness of this noteVote results for this note: -1You must log in to vote on the helpfulness of this note

Contributed by Kabolobari Benakole — 6 years ago
```
function wpdocs_unregister_tags_for_posts() {
    unregister_taxonomy_for_object_type( 'post_tag', 'post' );
}
add_action( 'init', 'wpdocs_unregister_tags_for_posts' );
```
Needed to remove category from the default post but I get an “undefined offset: 2” error when I use the above code. Is it that this function is no longer in core or are there aspects to it that’re missing?
Log in to add feedback

You must log in before being able to contribute a note or feedback.