WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

WP_Ability::do_execute()

WP_Ability::do_execute( mixed $input = null ): mixed|WP_Error

In this article

Back to top

Executes the ability callback.

Parameters

$inputmixedoptional
The input data for the ability.

Default:null

Return

mixed|WP_Error The result of the ability execution, or WP_Error on failure.

Source

protected function do_execute( $input = null ) {
	if ( ! is_callable( $this->execute_callback ) ) {
		return new WP_Error(
			'ability_invalid_execute_callback',
			/* translators: %s ability name. */
			sprintf( __( 'Ability "%s" does not have a valid execute callback.' ), esc_html( $this->name ) )
		);
	}

	return $this->invoke_callback( $this->execute_callback, $input );
}

View all references View on Trac View on GitHub

UsesDescription
WP_Ability::invoke_callback()wp-includes/abilities-api/class-wp-ability.php

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

__()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 moreShow less
Used byDescription
WP_Ability::execute()wp-includes/abilities-api/class-wp-ability.php

Executes the ability after input validation and running a permission check.

Changelog

VersionDescription
6.9.0Introduced.

User Contributed Notes

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