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
2730  *   trigger or false to not trigger error.
2731  *
2732  * @param string $file The file that was included
2733  * @param string $version The version of WordPress that deprecated the file
2734  * @param string $replacement Optional. The file that should have been included based on ABSPATH
2735  * @param string $message Optional. A message regarding the change
2736  */
2737 function _deprecated_file( $file, $version, $replacement = null, $message = '' ) {
2738
2739      do_action( 'deprecated_file_included', $file, $replacement, $version, $message );
2740
2741      // Allow plugin to filter the output error trigger
2742      if ( WP_DEBUG && apply_filters( 'deprecated_file_trigger_error', true ) ) {
2743           $message = empty( $message ) ? '' : ' ' . $message;
2744           if ( ! is_null( $replacement ) )
2745                trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.'), $file, $version, $replacement ) . $message );
2746           else
2747                trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s with no alternative available.'), $file, $version ) . $message );
2748      }