register_term_meta() │ WP 4.9.8

Registers a meta key for terms.

Uses: register_meta()
1 time — 0.000001 sec (speed of light) | 50000 times — 0.26 sec (very fast) | PHP 7.1.11, WP 4.9.8

No Hooks.

Return

true|false. True if the meta key was successfully registered, false if not.

Usage

register_term_meta( $taxonomy, $meta_key, $args );
$taxonomy(string) (required)
Taxonomy to register a meta key for. Pass an empty string to register the meta key across all existing taxonomies.
$meta_key(string) (required)
The meta key to register.
$args(array) (required)
Data used to describe the meta key when registered. See register_meta() for a list of supported arguments.

Examples

1

#1 Registration of a meta-field for the taxonomy shelves 

register_term_meta( 'shelves', 'my_meta_key', [
	'show_in_rest'      => true,     // Add to the REST response
	'sanitize_callback' => 'absint', // Process the value of the field when saving it to the database, absint()
] );

You can do the same with register_meta(), like this:

register_meta( 'term', 'my_meta_key', [
	'object_subtype'    => 'shelves', // taxonomy
	'show_in_rest'      => true,
	'sanitize_callback' => 'absint',
] );
0

#2 Extended value of the show_in_rest attribute

Using this function with schema in the show_in_rest attribute. Adds this field to the REST query and also describes this field in the OPTIONS REST query.

register_term_meta( 'replica', 'nice_field', [
	'type'        => 'string',
	'description' => 'a nice description',
	'single'       => true,
	'show_in_rest' => [
		'schema' => [
			'type'     => 'string',
			'format'   => 'url',
			'context'  => [ 'view', 'edit' ],
			'readonly' => true,
	   ]
	],
] );

Changelog

Since 4.9.8 Introduced.

register_term_meta() code WP 6.7.1

wp-includes/taxonomy.php 
function register_term_meta( $taxonomy, $meta_key, array $args ) {
	$args['object_subtype'] = $taxonomy;

	return register_meta( 'term', $meta_key, $args );
}

WP extension (enhancement)

Metadatas (any)