WordPress.org
Get WordPress

Make WordPress Core

Changeset 53627


Ignore:
Timestamp:
07/01/2022 07:08:00 PM (4 years 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.