WordPress Version: 6.2
/**
* Marks something as being incorrectly called.
*
* There is a hook {@see 'doing_it_wrong_run'} that will be called that can be used
* to get the backtrace up to what file and function called the deprecated
* function.
*
* The current behavior is to trigger a user error if `WP_DEBUG` is true.
*
* @since 3.1.0
* @since 5.4.0 This function is no longer marked as "private".
*
* @param string $function_name The function that was called.
* @param string $message A message explaining what has been done incorrectly.
* @param string $version The version of WordPress where the message was added.
*/
function _doing_it_wrong($function_name, $message, $version)
{
/**
* Fires when the given function is being used incorrectly.
*
* @since 3.1.0
*
* @param string $function_name The function that was called.
* @param string $message A message explaining what has been done incorrectly.
* @param string $version The version of WordPress where the message was added.
*/
do_action('doing_it_wrong_run', $function_name, $message, $version);
/**
* Filters whether to trigger an error for _doing_it_wrong() calls.
*
* @since 3.1.0
* @since 5.1.0 Added the $function_name, $message and $version parameters.
*
* @param bool $trigger Whether to trigger the error for _doing_it_wrong() calls. Default true.
* @param string $function_name The function that was called.
* @param string $message A message explaining what has been done incorrectly.
* @param string $version The version of WordPress where the message was added.
*/
if (WP_DEBUG && apply_filters('doing_it_wrong_trigger_error', true, $function_name, $message, $version)) {
if (function_exists('__')) {
if ($version) {
/* translators: %s: Version number. */
$version = sprintf(__('(This message was added in version %s.)'), $version);
}
$message .= ' ' . sprintf(
/* translators: %s: Documentation URL. */
__('Please see <a href="%s">Debugging in WordPress</a> for more information.'),
__('https://wordpress.org/documentation/article/debugging-in-wordpress/')
);
trigger_error(sprintf(
/* translators: Developer debugging message. 1: PHP function name, 2: Explanatory message, 3: WordPress version number. */
__('Function %1$s was called <strong>incorrectly</strong>. %2$s %3$s'),
$function_name,
$message,
$version
), E_USER_NOTICE);
} else {
if ($version) {
$version = sprintf('(This message was added in version %s.)', $version);
}
$message .= sprintf(' Please see <a href="%s">Debugging in WordPress</a> for more information.', 'https://wordpress.org/documentation/article/debugging-in-wordpress/');
trigger_error(sprintf('Function %1$s was called <strong>incorrectly</strong>. %2$s %3$s', $function_name, $message, $version), E_USER_NOTICE);
}
}
}