Source View: deprecated_file_included

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

  • Action hooks look like this: do_action( "hook_name" )
  • Filter hooks look like this: 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.

Source View

Line Code
2950  *   trigger or false to not trigger error.
2951  *
2952  * @param string $file The file that was included
2953  * @param string $version The version of WordPress that deprecated the file
2954  * @param string $replacement Optional. The file that should have been included based on ABSPATH
2955  * @param string $message Optional. A message regarding the change
2956  */
2957 function _deprecated_file( $file, $version, $replacement = null, $message = '' ) {
2958
2959      do_action( 'deprecated_file_included', $file, $replacement, $version, $message );
2960
2961      // Allow plugin to filter the output error trigger
2962      if ( WP_DEBUG && apply_filters( 'deprecated_file_trigger_error', true ) ) {
2963           $message = empty( $message ) ? '' : ' ' . $message;
2964           if ( function_exists( '__' ) ) {
2965                if ( ! is_null( $replacement ) )
2966                     trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.'), $file, $version, $replacement ) . $message );
2967                else
2968                     trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s with no alternative available.'), $file, $version ) . $message );