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

Adds an already registered taxonomy to an object type.

Contents

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

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 register_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;
	}

	if ( ! in_array( $object_type, $wp_taxonomies[ $taxonomy ]->object_type, true ) ) {
		$wp_taxonomies[ $taxonomy ]->object_type[] = $object_type;
	}

	// Filter out empties.
	$wp_taxonomies[ $taxonomy ]->object_type = array_filter( $wp_taxonomies[ $taxonomy ]->object_type );

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

	return true;
}

View on Trac View on GitHub

Hooks

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

Fires after a taxonomy is registered 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::register_taxonomies() wp-includes/class-wp-post-type.php	Registers the taxonomies for the post type.

Changelog

Changelog
Version	Description
3.0.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 davidguerreiro — 6 years ago
Do not forget to use the init hook to run this function. If not, the taxonomy and / or the CPT you want to reference might not have been created yet.
```
/**
 * Share taxonomy pdf-groups with posts
 *
 * @return void
 */
function namespace_share_category_with_pages() {
	register_taxonomy_for_object_type( 'category', 'page' );
}

add_action( 'init', 'namespace_share_category_with_pages' );
```
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 Codex — 8 years ago
Example
```
<?php register_taxonomy_for_object_type( 'category', 'page' ); ?> 
```
Log in to add feedback

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