Menu Adam R Brown

WP hooks navigation: Home/browseActions indexFilters index

Source View: deprecated_file_trigger_error

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
2852  * @param string $version The version of WordPress that deprecated the file
2853  * @param string $replacement Optional. The file that should have been included based on ABSPATH
2854  * @param string $message Optional. A message regarding the change
2855  */
2856 function _deprecated_file( $file, $version, $replacement = null, $message = '' ) {
2857
2858      do_action( 'deprecated_file_included', $file, $replacement, $version, $message );
2859
2860      // Allow plugin to filter the output error trigger
2861      if ( WP_DEBUG && apply_filters( 'deprecated_file_trigger_error', true ) ) {
2862           $message = empty( $message ) ? '' : ' ' . $message;
2863           if ( ! is_null( $replacement ) )
2864                trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.'), $file, $version, $replacement ) . $message );
2865           else
2866                trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s with no alternative available.'), $file, $version ) . $message );
2867      }
2868 }
2869 /**
2870  * Marks a function argument as deprecated and informs when it has been used.