WP hooks navigation: Home/browse • Actions index • Filters index
To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).
The best way to understand what a hook does is to look at where it occurs in the source code.
do_action( "hook_name" )apply_filters( "hook_name", "what_to_filter" ).Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.
| Line | Code |
|---|---|
| 2942 | * @param string $version The version of WordPress that deprecated the file |
| 2943 | * @param string $replacement Optional. The file that should have been included based on ABSPATH |
| 2944 | * @param string $message Optional. A message regarding the change |
| 2945 | */ |
| 2946 | function _deprecated_file( $file, $version, $replacement = null, $message = '' ) { |
| 2947 | |
| 2948 | do_action( 'deprecated_file_included', $file, $replacement, $version, $message ); |
| 2949 | |
| 2950 | // Allow plugin to filter the output error trigger |
| 2951 | if ( WP_DEBUG && apply_filters( 'deprecated_file_trigger_error', true ) ) { |
| 2952 | $message = empty( $message ) ? '' : ' ' . $message; |
| 2953 | if ( function_exists( '__' ) ) { |
| 2954 | if ( ! is_null( $replacement ) ) |
| 2955 | trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.'), $file, $version, $replacement ) . $message ); |
| 2956 | else |
| 2957 | trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s with no alternative available.'), $file, $version ) . $message ); |
| 2958 | } else { |
| 2959 | if ( ! is_null( $replacement ) ) |
| 2960 | trigger_error( sprintf( '%1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.', $file, $version, $replacement ) . $message ); |