Execute functions hooked on a specific filter hook, specifying arguments in an array.
This function is identical to apply_filters, but the arguments passed to the functions hooked to $tag are supplied using an array.
<?php apply_filters_ref_array( $tag, $args ); ?>
Call added filters and pass an array of arguments:
$args = array( 'arg_1', true, 'foo', 'arg_4' ); apply_filters_ref_array( 'my_filter', $args );
This is the same as:
apply_filters( 'my_filter', 'arg_1', true, 'foo', 'arg_4' );
add_filter('my_filter', 'my_callback'); function my_callback( $args ) { //access values with $args[0], $args[1] etc. }
Because the array was passed by reference, any changes to the array elements are applied to the original array outside of the function's scope.
add_action('my_filter', 'my_callback', 10, 4 ); function my_callback( $arg1, $arg2, $arg3, $arg4 ) { //access values with $args1, $args2 etc. }
This method copies the array elements into the parameter variables. Any changes to the parameter variables do not affect the original array.
apply_filters_ref_array( 'my_filter', array( &$args )); add_action('my_filter', 'my_callback'); function my_callback( &$args ) { //access values with $args[0], $args[1] etc. }
Because the original array was passed by reference, any changes to the array elements are applied to the original array outside of the function's scope.
Since: 3.0.0
apply_filters_ref_array() is located in wp-includes/plugin.php
.