Make WordPress Core

Changeset 53627


Ignore:
Timestamp:
07/01/2022 07:08:00 PM (20 months ago)
Author:
johnbillion
Message:

Taxonomy: Pass the $args parameter to all actions and filters in wp_insert_term() and wp_update_term().

This allows actions and filters to access potentially useful contextual information when terms are inserted and updated.

Props mboynes

Fixes #55441

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-includes/taxonomy.php

    r53170 r53627  
    23472347     *
    23482348     * @since 3.0.0
     2349     * @since 6.1.0 The `$args` parameter was added.
    23492350     *
    23502351     * @param string|WP_Error $term     The term name to add, or a WP_Error object if there's an error.
    23512352     * @param string          $taxonomy Taxonomy slug.
    2352      */
    2353     $term = apply_filters( 'pre_insert_term', $term, $taxonomy );
     2353     * @param array|string    $args     Array or query string of arguments for inserting a term.
     2354     */
     2355    $term = apply_filters( 'pre_insert_term', $term, $taxonomy, $args );
    23542356
    23552357    if ( is_wp_error( $term ) ) {
     
    25752577     *
    25762578     * @since 2.3.0
     2579     * @since 6.1.0 The `$args` parameter was added.
    25772580     *
    25782581     * @param int    $term_id  Term ID.
    25792582     * @param int    $tt_id    Term taxonomy ID.
    25802583     * @param string $taxonomy Taxonomy slug.
    2581      */
    2582     do_action( 'create_term', $term_id, $tt_id, $taxonomy );
     2584     * @param array  $args     Term arguments passed to the function.
     2585     */
     2586    do_action( 'create_term', $term_id, $tt_id, $taxonomy, $args );
    25832587
    25842588    /**
     
    25942598     *
    25952599     * @since 2.3.0
    2596      *
    2597      * @param int $term_id Term ID.
    2598      * @param int $tt_id   Term taxonomy ID.
    2599      */
    2600     do_action( "create_{$taxonomy}", $term_id, $tt_id );
     2600     * @since 6.1.0 The `$args` parameter was added.
     2601     *
     2602     * @param int   $term_id Term ID.
     2603     * @param int   $tt_id   Term taxonomy ID.
     2604     * @param array $args    Term arguments passed to the function.
     2605     */
     2606    do_action( "create_{$taxonomy}", $term_id, $tt_id, $args );
    26012607
    26022608    /**
     
    26042610     *
    26052611     * @since 2.3.0
    2606      *
    2607      * @param int $term_id Term ID.
    2608      * @param int $tt_id   Term taxonomy ID.
    2609      */
    2610     $term_id = apply_filters( 'term_id_filter', $term_id, $tt_id );
     2612     * @since 6.1.0 The `$args` parameter was added.
     2613     *
     2614     * @param int   $term_id Term ID.
     2615     * @param int   $tt_id   Term taxonomy ID.
     2616     * @param array $args    Term arguments passed to the function.
     2617     */
     2618    $term_id = apply_filters( 'term_id_filter', $term_id, $tt_id, $args );
    26112619
    26122620    clean_term_cache( $term_id, $taxonomy );
     
    26192627     *
    26202628     * @since 2.3.0
     2629     * @since 6.1.0 The `$args` parameter was added.
    26212630     *
    26222631     * @param int    $term_id  Term ID.
    26232632     * @param int    $tt_id    Term taxonomy ID.
    26242633     * @param string $taxonomy Taxonomy slug.
    2625      */
    2626     do_action( 'created_term', $term_id, $tt_id, $taxonomy );
     2634     * @param array  $args     Term arguments passed to the function.
     2635     */
     2636    do_action( 'created_term', $term_id, $tt_id, $taxonomy, $args );
    26272637
    26282638    /**
     
    26382648     *
    26392649     * @since 2.3.0
    2640      *
    2641      * @param int $term_id Term ID.
    2642      * @param int $tt_id   Term taxonomy ID.
    2643      */
    2644     do_action( "created_{$taxonomy}", $term_id, $tt_id );
     2650     * @since 6.1.0 The `$args` parameter was added.
     2651     *
     2652     * @param int   $term_id Term ID.
     2653     * @param int   $tt_id   Term taxonomy ID.
     2654     * @param array $args    Term arguments passed to the function.
     2655     */
     2656    do_action( "created_{$taxonomy}", $term_id, $tt_id, $args );
    26452657
    26462658    /**
     
    26512663     *
    26522664     * @since 5.5.0
     2665     * @since 6.1.0 The `$args` parameter was added.
    26532666     *
    26542667     * @param int    $term_id  Term ID.
     
    26562669     * @param string $taxonomy Taxonomy slug.
    26572670     * @param bool   $update   Whether this is an existing term being updated.
    2658      */
    2659     do_action( 'saved_term', $term_id, $tt_id, $taxonomy, false );
     2671     * @param array  $args     Term arguments passed to the function.
     2672     */
     2673    do_action( 'saved_term', $term_id, $tt_id, $taxonomy, false, $args );
    26602674
    26612675    /**
     
    26712685     *
    26722686     * @since 5.5.0
    2673      *
    2674      * @param int  $term_id Term ID.
    2675      * @param int  $tt_id   Term taxonomy ID.
    2676      * @param bool $update  Whether this is an existing term being updated.
    2677      */
    2678     do_action( "saved_{$taxonomy}", $term_id, $tt_id, false );
     2687     * @since 6.1.0 The `$args` parameter was added.
     2688     *
     2689     * @param int   $term_id Term ID.
     2690     * @param int   $tt_id   Term taxonomy ID.
     2691     * @param bool  $update  Whether this is an existing term being updated.
     2692     * @param array $args    Term arguments passed to the function.
     2693     */
     2694    do_action( "saved_{$taxonomy}", $term_id, $tt_id, false, $args );
    26792695
    26802696    return array(
     
    32353251     *
    32363252     * @since 2.9.0
     3253     * @since 6.1.0 The `$args` parameter was added.
    32373254     *
    32383255     * @param int    $term_id  Term ID.
    32393256     * @param string $taxonomy Taxonomy slug.
    3240      */
    3241     do_action( 'edit_terms', $term_id, $taxonomy );
     3257     * @param array  $args     Arguments passed to wp_update_term().
     3258     */
     3259    do_action( 'edit_terms', $term_id, $taxonomy, $args );
    32423260
    32433261    $data = compact( 'name', 'slug', 'term_group' );
     
    32673285     *
    32683286     * @since 2.9.0
     3287     * @since 6.1.0 The `$args` parameter was added.
    32693288     *
    32703289     * @param int    $term_id  Term ID.
    32713290     * @param string $taxonomy Taxonomy slug.
    3272      */
    3273     do_action( 'edited_terms', $term_id, $taxonomy );
     3291     * @param array  $args     Arguments passed to wp_update_term().
     3292     */
     3293    do_action( 'edited_terms', $term_id, $taxonomy, $args );
    32743294
    32753295    /**
     
    32773297     *
    32783298     * @since 2.9.0
     3299     * @since 6.1.0 The `$args` parameter was added.
    32793300     *
    32803301     * @param int    $tt_id    Term taxonomy ID.
    32813302     * @param string $taxonomy Taxonomy slug.
    3282      */
    3283     do_action( 'edit_term_taxonomy', $tt_id, $taxonomy );
     3303     * @param array  $args     Arguments passed to wp_update_term().
     3304     */
     3305    do_action( 'edit_term_taxonomy', $tt_id, $taxonomy, $args );
    32843306
    32853307    $wpdb->update( $wpdb->term_taxonomy, compact( 'term_id', 'taxonomy', 'description', 'parent' ), array( 'term_taxonomy_id' => $tt_id ) );
     
    32893311     *
    32903312     * @since 2.9.0
     3313     * @since 6.1.0 The `$args` parameter was added.
    32913314     *
    32923315     * @param int    $tt_id    Term taxonomy ID.
    32933316     * @param string $taxonomy Taxonomy slug.
    3294      */
    3295     do_action( 'edited_term_taxonomy', $tt_id, $taxonomy );
     3317     * @param array  $args     Arguments passed to wp_update_term().
     3318     */
     3319    do_action( 'edited_term_taxonomy', $tt_id, $taxonomy, $args );
    32963320
    32973321    /**
     
    33023326     *
    33033327     * @since 2.3.0
     3328     * @since 6.1.0 The `$args` parameter was added.
    33043329     *
    33053330     * @param int    $term_id  Term ID.
    33063331     * @param int    $tt_id    Term taxonomy ID.
    33073332     * @param string $taxonomy Taxonomy slug.
    3308      */
    3309     do_action( 'edit_term', $term_id, $tt_id, $taxonomy );
     3333     * @param array  $args     Arguments passed to wp_update_term().
     3334     */
     3335    do_action( 'edit_term', $term_id, $tt_id, $taxonomy, $args );
    33103336
    33113337    /**
     
    33213347     *
    33223348     * @since 2.3.0
    3323      *
    3324      * @param int $term_id Term ID.
    3325      * @param int $tt_id   Term taxonomy ID.
    3326      */
    3327     do_action( "edit_{$taxonomy}", $term_id, $tt_id );
     3349     * @since 6.1.0 The `$args` parameter was added.
     3350     *
     3351     * @param int   $term_id Term ID.
     3352     * @param int   $tt_id   Term taxonomy ID.
     3353     * @param array $args    Arguments passed to wp_update_term().
     3354     */
     3355    do_action( "edit_{$taxonomy}", $term_id, $tt_id, $args );
    33283356
    33293357    /** This filter is documented in wp-includes/taxonomy.php */
     
    33393367     *
    33403368     * @since 2.3.0
     3369     * @since 6.1.0 The `$args` parameter was added.
    33413370     *
    33423371     * @param int    $term_id  Term ID.
    33433372     * @param int    $tt_id    Term taxonomy ID.
    33443373     * @param string $taxonomy Taxonomy slug.
    3345      */
    3346     do_action( 'edited_term', $term_id, $tt_id, $taxonomy );
     3374     * @param array  $args     Arguments passed to wp_update_term().
     3375     */
     3376    do_action( 'edited_term', $term_id, $tt_id, $taxonomy, $args );
    33473377
    33483378    /**
     
    33583388     *
    33593389     * @since 2.3.0
    3360      *
    3361      * @param int $term_id Term ID.
    3362      * @param int $tt_id   Term taxonomy ID.
    3363      */
    3364     do_action( "edited_{$taxonomy}", $term_id, $tt_id );
     3390     * @since 6.1.0 The `$args` parameter was added.
     3391     *
     3392     * @param int   $term_id Term ID.
     3393     * @param int   $tt_id   Term taxonomy ID.
     3394     * @param array $args    Arguments passed to wp_update_term().
     3395     */
     3396    do_action( "edited_{$taxonomy}", $term_id, $tt_id, $args );
    33653397
    33663398    /** This action is documented in wp-includes/taxonomy.php */
    3367     do_action( 'saved_term', $term_id, $tt_id, $taxonomy, true );
     3399    do_action( 'saved_term', $term_id, $tt_id, $taxonomy, true, $args );
    33683400
    33693401    /** This action is documented in wp-includes/taxonomy.php */
    3370     do_action( "saved_{$taxonomy}", $term_id, $tt_id, true );
     3402    do_action( "saved_{$taxonomy}", $term_id, $tt_id, true, $args );
    33713403
    33723404    return array(
Note: See TracChangeset for help on using the changeset viewer.