Content types Taxonomies: Lifecycle trait

Provides taxonomy lifecycle, data, and REST integration.

Capabilities and extension points

Registers dynamic taxonomy lifecycle hooks.

Dispatches term creation callbacks.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param array $arguments Arguments passed to wp_insert_term().

Handles a newly created term.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param array $arguments Arguments passed to wp_insert_term().

Dispatches term edit callbacks.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param array $arguments Arguments passed to wp_update_term().

Handles an edited term.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param array $arguments Arguments passed to wp_update_term().

Dispatches term save callbacks.

This runs after both term creation and term updates.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param bool $update Whether an existing term was updated.
• param array $arguments Arguments used to save the term.

Handles a saved term.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param bool $update Whether an existing term was updated.
• param array $arguments Arguments used to save the term.

Dispatches term deletion callbacks.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param \WP_Term $term Deleted term object.
• param array $object_ids Previously associated object IDs.

Handles a deleted term.

• param int $term_id Term ID.
• param int $term_taxonomy_id Term taxonomy ID.
• param \WP_Term $term Deleted term object.
• param array $object_ids Previously associated object IDs.

Filters a term value before WordPress validates and inserts it.

• param string|array $term Term name or structured term data.
• param string $taxonomy Taxonomy name.
• param array $arguments Arguments passed to wp_insert_term().
• return string|array|\WP_Error Filtered term value.

Filters a term value before WordPress validates and inserts it.

• param string|array $term Term name or structured term data.
• param array $arguments Arguments passed to wp_insert_term().
• return string|array|\WP_Error Filtered term value.

Filters wp_terms table data before WordPress inserts a term.

• param array $data Sanitized term data.
• param string $taxonomy Taxonomy name.
• param array $arguments Arguments passed to wp_insert_term().
• return array Filtered term data.

Filters wp_terms table data before WordPress updates a term.

• param array $data Sanitized term data.
• param int $term_id Term ID.
• param string $taxonomy Taxonomy name.
• param array $arguments Arguments passed to wp_update_term().
• return array Filtered term data.

Applies class-owned and public term data filters.

• param array $data Sanitized wp_terms table data.
• param int $term_id Term ID, or zero when creating a term.
• param bool $update Whether an existing term is updated.
• param array $arguments Arguments passed to the term operation.
• return array Filtered term data.

Filters wp_terms table data before WordPress saves it.

Override this method to control both term creation and updates.

• param array $data Sanitized wp_terms table data.
• param int $term_id Term ID, or zero when creating a term.
• param bool $update Whether an existing term is updated.
• param array $arguments Arguments passed to the term operation.
• return array Filtered term data.

Filters REST API query arguments for this taxonomy.

• param array $arguments Query arguments.
• param \WP_REST_Request $request REST API request.
• return array Filtered query arguments.

Filters a REST API response for this taxonomy.

• param \WP_REST_Response $response REST API response.
• param \WP_Term $term Term object.
• param \WP_REST_Request $request REST API request.
• return \WP_REST_Response Filtered REST API response.

Determines whether a value represents this taxonomy.

• param int|\WP_Term $term Term ID or object.
• return bool Whether the term belongs to this definition.

Source reference

This editable reference page is based on the PHP documentation in content-types/taxonomies/traits/trait-lifecycle.php.