Skip to main content

Filter: gform_ability_definition

Filters a single ability definition after normalization.

A filter can change properties such as label, description, or schema. The name, permission_callback, ability_class, and execute_callback stay immutable, so a filter cannot weaken the capability gate or replace the callback.

Parameters​

NameTypeDescription
$definitionarrayThe normalized ability definition.
$namestringThe ability name (e.g. 'gravityforms/system-info').

Example​

add_filter( 'gform_ability_definition', function( $definition, $name ) {
    if ( $name === 'gravityforms/forms-delete' ) {
        $definition['label'] = __( 'Trash Form', 'gravityforms' );
    }
    return $definition;
}, 10, 2 );

Since​

  • 3.1.0

Source​

Defined in includes/abilities/class-gf-abilities-registry.php at line 201

Returns​

The filtered ability definition.