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

Parameters

$inputmixedoptional

The input data for the ability. Default null.Default: null

Return

mixed|WP_Error

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

Uses · 4

• __()Retrieves the translation of $text.
• esc_html()Escaping for HTML blocks.
• WP_Error::__construct()Initializes the error.
• WP_Ability::invoke_callback()Invokes a callable, ensuring the input is passed through only if the input schema is defined.

Used by · 1

• WP_Ability::execute()Executes the ability after input validation and running a permission check.

Source

View on Trac ↗View on GitHub ↗

561	protected function do_execute( $input = null ) {562		if ( ! is_callable( $this->execute_callback ) ) {563			return new WP_Error(564				'ability_invalid_execute_callback',565				/* translators: %s ability name. */566				sprintf( __( 'Ability "%s" does not have a valid execute callback.' ), esc_html( $this->name ) )567			);568		}569 570		return $this->invoke_callback( $this->execute_callback, $input );571	}

History

Introduced in 6.9.0. Unchanged from 6.9.7 through 7.1.0.

1. 6.9.7
2. 7.0.4
3. 7.1.0

Signature, return type and hooks compared across 3 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/abilities-api/class-wp-ability.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.