Welcome, visitor! Log in
 

Source View: deprecated_function_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.

  • 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
2900   * @since 2.5.0
2901   * @access private
2902   *
2903   * @uses do_action() Calls 'deprecated_function_run' and passes the function name and what to use instead.
2904   * @uses apply_filters() Calls 'deprecated_function_trigger_error' and expects boolean value of true to do trigger or false to not trigger error.
2905   *
2906   * @param string $function The function that was called
2907   * @param string $version The version of WordPress that deprecated the function
2908   * @param string $replacement Optional. The function that should have been called
2909   */
2910  function _deprecated_function($function, $version, $replacement=null) {
2911  
2912       do_action('deprecated_function_run', $function, $replacement);
2913  
2914       // Allow plugin to filter the output error trigger
2915       if( defined('WP_DEBUG') && ( true === WP_DEBUG ) && apply_filters( 'deprecated_function_trigger_error', true )) {
2916            if( !is_null($replacement) )
2917                 trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s! Use %3$s instead.'), $function, $version, $replacement ) );
2918            else
2919                 trigger_error( sprintf( __('%1$s is <strong>deprecated</strong> since version %2$s with no alternative available.'), $function, $version ) );
2920       }
2921  }
2922  
2923  /**
2924   * Marks a file as deprecated and informs when it has been used.
2925   *
2926   * There is a hook deprecated_file_included that will be called that can be used
2927   * to get the backtrace up to what file and function included the deprecated
2928   * file.
2929   *
2930   * The current behavior is to trigger an user error if WP_DEBUG is defined and