WP_Ability::invoke_callback( callable $callback, mixed $input = null ): mixed

Invokes a callable, ensuring the input is passed through only if the input schema is defined.

Parameters

$callbackcallablerequired: The callable to invoke.
$inputmixedoptional: The input data for the ability.
Default:null

Return

mixed The result of the callable execution, or a WP_Error if the callback threw.

Source

protected function invoke_callback( callable $callback, $input = null ) {
	$args = array();
	if ( ! empty( $this->get_input_schema() ) ) {
		$args[] = $input;
	}

	try {
		return $callback( ...$args );
	} catch ( Throwable $e ) {
		return new WP_Error(
			'ability_callback_exception',
			sprintf(
				/* translators: 1: Ability name, 2: Exception message. */
				__( 'Ability "%1$s" callback threw an exception: %2$s' ),
				esc_html( $this->name ),
				esc_html( $e->getMessage() )
			)
		);
	}
}

View all references View on Trac View on GitHub

Uses	Description
WP_Ability::get_input_schema()`wp-includes/abilities-api/class-wp-ability.php`	Retrieves the input schema for the ability.
__()`wp-includes/l10n.php`	Retrieves the translation of $text.
esc_html()`wp-includes/formatting.php`	Escaping for HTML blocks.
WP_Error::__construct()`wp-includes/class-wp-error.php`	Initializes the error.

Show 2 more Show less

Used by	Description
WP_Ability::check_permissions()`wp-includes/abilities-api/class-wp-ability.php`	Checks whether the ability has the necessary permissions.
WP_Ability::do_execute()`wp-includes/abilities-api/class-wp-ability.php`	Executes the ability callback.

Changelog

Version	Description
6.9.0	Introduced.

User Contributed Notes

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