wc_deprecated_hook() │ WC 3.3.0

Wrapper for deprecated hook so we can apply some extra logic.

Returns

null. Nothing (null).

Usage

wc_deprecated_hook( $hook, $version, $replacement, $message );

$hook(string) (required)

The hook that was used.

$version(string) (required)

The version of WordPress that deprecated the hook.

$replacement(string)

The hook that should have been used.
Default: null

$message(string)

A message regarding the change.
Default: null

Changelog

wc_deprecated_hook() wc deprecated hook code ^{WC 10.3.6}

function wc_deprecated_hook( $hook, $version, $replacement = null, $message = null ) {
	// @codingStandardsIgnoreStart
	if ( wp_doing_ajax() || WC()->is_rest_api_request() ) {
		do_action( 'deprecated_hook_run', $hook, $replacement, $version, $message );

		$message    = empty( $message ) ? '' : ' ' . $message;
		$log_string = "{$hook} is deprecated since version {$version}";
		$log_string .= $replacement ? "! Use {$replacement} instead." : ' with no alternative available.';

		error_log( $log_string . $message );
	} else {
		_deprecated_hook( $hook, $version, $replacement, $message );
	}
	// @codingStandardsIgnoreEnd
}