apply_filters( 'pre_insert_term', string|WP_Error $term, string $taxonomy, array|string $args )
- Since
- 3.0.0, 6.1.0
Filters a term before it is sanitized and inserted into the database.
Compatibility
- WordPress
- since 6.1.0
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0).
Parameters
$termstring|WP_Error- The term name to add, or a WP_Error object if there's an error.
$taxonomystring- Taxonomy slug.
$argsarray|string- Array or query string of arguments passed to wp_insert_term().
Where this hook fires · 1
wp-includes/taxonomy.php:2441wp_insert_term()
Source code
<?php * @since 6.1.0 The `$args` parameter was added. * * @param string|WP_Error $term The term name to add, or a WP_Error object if there's an error. * @param string $taxonomy Taxonomy slug. * @param array|string $args Array or query string of arguments passed to wp_insert_term(). */ $term = apply_filters( 'pre_insert_term', $term, $taxonomy, $args ); if ( is_wp_error( $term ) ) { return $term; } if ( is_int( $term ) && 0 === $term ) {Changelog
Introduced in 3.0.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
6.1.0
The
$args parameter was added.from the docblock3.0.0
Introduced.from the docblock
About this page
- Parsed data
- Generated from the wordpress-develop 6.9.7 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.