Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

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.

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
2941  * @uses do_action() Calls 'deprecated_file_included' and passes the file name and what to use instead.
2942  * @uses apply_filters() Calls 'deprecated_file_trigger_error' and expects boolean value of true to do trigger or false to not trigger error.
2943  *
2944  * @param string $file The file that was included
2945  * @param string $version The version of WordPress that deprecated the function
2946  * @param string $replacement Optional. The function that should have been called
2947  */
2948 function _deprecated_file($file, $version, $replacement=null) {
2949
2950      do_action('deprecated_file_included', $file, $replacement);
2951
2952      // Allow plugin to filter the output error trigger
2953      if( defined('WP_DEBUG') && ( true === WP_DEBUG ) && apply_filters( 'deprecated_file_trigger_error', true )) {
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 ) );
2956           else
2957                trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s with no alternative available.'), $file, $version ) );
2958      }
2959 }