wp_should_disable_pings_for_environment(): bool

Determines whether pings should be disabled for the current environment.

Description

By default, all pings (outgoing pingbacks, trackbacks, and ping service notifications, as well as incoming pingbacks and trackbacks) are disabled for non-production environments (‘local’, ‘development’, ‘staging’).

Return

bool True if pings should be disabled, false otherwise.

Source

function wp_should_disable_pings_for_environment() {
	$environment_type = wp_get_environment_type();
	$should_disable   = 'production' !== $environment_type;

	/**
	 * Filters whether pings should be disabled for the current environment.
	 *
	 * Returning false re-enables pings in non-production environments.
	 * Returning true disables pings even in production.
	 *
	 * @since 7.1.0
	 *
	 * @param bool   $should_disable  Whether pings should be disabled. Default true
	 *                                for non-production environments, false for production.
	 * @param string $environment_type The current environment type as returned by
	 *                                 wp_get_environment_type().
	 */
	return apply_filters( 'wp_should_disable_pings_for_environment', $should_disable, $environment_type );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘wp_should_disable_pings_for_environment’, bool $should_disable, string $environment_type ): Filters whether pings should be disabled for the current environment.

Uses	Description
wp_get_environment_type()`wp-includes/load.php`	Retrieves the current environment type.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Used by	Description
wp_maybe_disable_trackback_for_environment()`wp-includes/comment.php`	Rejects incoming trackbacks in non-production environments.
wp_maybe_disable_xmlrpc_pingback_for_environment()`wp-includes/comment.php`	Removes the pingback XML-RPC method in non-production environments.
wp_maybe_disable_outgoing_pings_for_environment()`wp-includes/comment.php`	Removes outgoing ping callbacks in non-production environments.

Changelog

Version	Description
7.1.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.