_deprecated_file
_deprecated_file ( $file, $version, $replacement = '', $message = '' )
Parameters:- (string) file The file that was included.
- (string) version The version of WordPress that deprecated the file.
- (string) replacement Optional. The file that should have been included based on ABSPATH. Default empty string.
- (string) message Optional. A message regarding the change. Default empty string.
Defined at:Change Log: - Introduced in WordPress: 2.5.0
- Deprecated in WordPress: —
Description
Marks a file as deprecated and inform when it has been used.There is a {@see 'deprecated_file_included'} hook that will be called that can be used
to get the backtrace up to what file and function included the deprecated file.
The current behavior is to trigger a user error if `WP_DEBUG` is true.
This function is to be used in every file that is deprecated.