WordPress.org
Get WordPress

Make WordPress Core


Ignore:
Timestamp:
11/29/2019 09:40:58 PM (6 years ago)
Author:
SergeyBiryukov
Message:

Docs: Correct @param type for the function parameter in tests_add_filter() and _test_filter_build_unique_id().

Synchronize documentation for add_filter(), tests_add_filter(), _wp_filter_build_unique_id(), _test_filter_build_unique_id().

Add a note that $tag and $priority are no longer used in _wp_filter_build_unique_id() since [46220], and the function always returns a string now.

Props donmhico, remcotolsma, SergeyBiryukov.
Fixes #47407. See #48303.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-includes/plugin.php

    r46792 r46801  
    9494 * @since 0.71
    9595 *
    96  * @global array $wp_filter      A multidimensional array of all hooks and the callbacks hooked to them.
     96 * @global array $wp_filter A multidimensional array of all hooks and the callbacks hooked to them.
    9797 *
    9898 * @param string   $tag             The name of the filter to hook the $function_to_add callback to.
    9999 * @param callable $function_to_add The callback to be run when the filter is applied.
    100100 * @param int      $priority        Optional. Used to specify the order in which the functions
    101  *                                  associated with a particular action are executed. Default 10.
     101 *                                  associated with a particular action are executed.
    102102 *                                  Lower numbers correspond with earlier execution,
    103103 *                                  and functions with the same priority are executed
    104  *                                  in the order in which they were added to the action.
     104 *                                  in the order in which they were added to the action. Default 10.
    105105 * @param int      $accepted_args   Optional. The number of arguments the function accepts. Default 1.
    106106 * @return true
    … …  
    120120 * @since 2.5.0
    121121 *
    122  * @global array $wp_filter Stores all of the filters.
     122 * @global array $wp_filter Stores all of the filters and actions.
    123123 *
    124124 * @param string        $tag               The name of the filter hook.
    … …  
    171171 * @since 0.71
    172172 *
    173  * @global array $wp_filter         Stores all of the filters.
     173 * @global array $wp_filter         Stores all of the filters and actions.
    174174 * @global array $wp_current_filter Stores the list of current filters with the current one last.
    175175 *
    … …  
    219219 * functions hooked to `$tag` are supplied using an array.
    220220 *
    221  * @global array $wp_filter         Stores all of the filters
    222  * @global array $wp_current_filter Stores the list of current filters with the current one last
     221 * @global array $wp_filter         Stores all of the filters and actions.
     222 * @global array $wp_current_filter Stores the list of current filters with the current one last.
    223223 *
    224224 * @param string $tag  The name of the filter hook.
    … …  
    267267 * @since 1.2.0
    268268 *
    269  * @global array $wp_filter         Stores all of the filters
     269 * @global array $wp_filter Stores all of the filters and actions.
    270270 *
    271271 * @param string   $tag                The filter hook to which the function to be removed is hooked.
    … …  
    293293 * @since 2.7.0
    294294 *
    295  * @global array $wp_filter  Stores all of the filters
     295 * @global array $wp_filter Stores all of the filters and actions.
    296296 *
    297297 * @param string   $tag      The filter to remove hooks from.
    … …  
    434434 *              by adding it to the function signature.
    435435 *
    436  * @global array $wp_filter         Stores all of the filters
     436 * @global array $wp_filter         Stores all of the filters and actions.
    437437 * @global array $wp_actions        Increments the amount of times action was triggered.
    438  * @global array $wp_current_filter Stores the list of current filters with the current one last
     438 * @global array $wp_current_filter Stores the list of current filters with the current one last.
    439439 *
    440440 * @param string $tag    The name of the action to be executed.
    … …  
    508508 * @see do_action() This function is identical, but the arguments passed to the
    509509 *                  functions hooked to `$tag` are supplied using an array.
    510  * @global array $wp_filter         Stores all of the filters
     510 * @global array $wp_filter         Stores all of the filters and actions.
    511511 * @global array $wp_actions        Increments the amount of times action was triggered.
    512  * @global array $wp_current_filter Stores the list of current filters with the current one last
     512 * @global array $wp_current_filter Stores the list of current filters with the current one last.
    513513 *
    514514 * @param string $tag  The name of the action to be executed.
    … …  
    868868 * @access private
    869869 *
    870  * @global array $wp_filter  Stores all of the filters
     870 * @global array $wp_filter Stores all of the filters and actions.
    871871 *
    872872 * @param array $args The collected parameters from the hook that was called.
    … …  
    898898 *
    899899 * @since 2.2.3
     900 * @since 5.3.0 Removed workarounds for spl_object_hash().
     901 *              `$tag` and `$priority` are no longer used,
     902 *              and the function always returns a string.
    900903 * @access private
    901904 *
    902  * @global array $wp_filter Storage for all of the filters and actions.
     905 * @global array $wp_filter Stores all of the filters and actions.
    903906 * @staticvar int $filter_id_count
    904907 *
    905  * @param string   $tag      Used in counting how many hooks were applied
    906  * @param callable $function Used for creating unique id
    907  * @param int|bool $priority Used in counting how many hooks were applied. If === false
    908  *                           and $function is an object reference, we return the unique
    909  *                           id only if it already has one, false otherwise.
    910  * @return string|false Unique ID for usage as array key or false if $priority === false
    911  *                      and $function is an object reference, and it does not already have
    912  *                      a unique id.
     908 * @param string   $tag      Unused. The name of the filter to build ID for.
     909 * @param callable $function The function to generate ID for.
     910 * @param int      $priority Unused. The order in which the functions associated
     911 *                           with a particular action are executed.
     912 * @return string Unique ID for usage as array key.
    913913 */
    914914function _wp_filter_build_unique_id( $tag, $function, $priority ) {
    … …  
    921921
    922922    if ( is_object( $function ) ) {
    923         // Closures are currently implemented as objects
     923        // Closures are currently implemented as objects.
    924924        $function = array( $function, '' );
    925925    } else {
    … …  
    928928
    929929    if ( is_object( $function[0] ) ) {
    930         // Object Class Calling
     930        // Object class calling.
    931931        return spl_object_hash( $function[0] ) . $function[1];
    932932    } elseif ( is_string( $function[0] ) ) {
    933         // Static Calling
     933        // Static calling.
    934934        return $function[0] . '::' . $function[1];
    935935    }
Note: See TracChangeset for help on using the changeset viewer.