pre_do_shortcode_tag
Filters whether to call a shortcode callback.
Returning a non-false value from filter will short-circuit the shortcode generation process, returning that value instead.
Использование
add_filter( 'pre_do_shortcode_tag', 'wp_kama_pre_do_shortcode_tag_filter', 10, 4 );
/**
* Function for `pre_do_shortcode_tag` filter-hook.
*
* @param false|string $output Short-circuit return value. Either false or the value to replace the shortcode with.
* @param string $tag Shortcode name.
* @param array $attr Shortcode attributes array, can be empty if the original arguments string cannot be parsed.
* @param array $m Regular expression match array.
*
* @return false|string
*/
function wp_kama_pre_do_shortcode_tag_filter( $output, $tag, $attr, $m ){
// filter...
return $output;
}
- $output(false|строка)
- Short-circuit return value. Either false or the value to replace the shortcode with.
- $tag(строка)
- Shortcode name.
- $attr(массив)
- Shortcode attributes array, can be empty if the original arguments string cannot be parsed.
- $m(массив)
- Regular expression match array.
Список изменений
| С версии 4.7.0 | Введена. |
| С версии 6.5.0 | The $attr parameter is always an array. |
Где вызывается хук
pre_do_shortcode_tag
wp-includes/shortcodes.php 427
$return = apply_filters( 'pre_do_shortcode_tag', false, $tag, $attr, $m );