Skip to main content

Filter: gform_abilities_definitions

Filters all ability definitions before per-definition processing.

Add-ons can add, remove, or reorder definitions. The capability and execute callback of a core ability stay immutable, so a filter cannot weaken a shipped ability.

Parameters

NameTypeDescription
$raw_definitionsarray[]Array of raw definition arrays, each with 'name' and 'args' keys.

Example

add_filter( 'gform_abilities_definitions', function( $definitions ) {
$definitions[] = [
'name' => 'gravityforms/myaddon/my-action',
'args' => [
'label' => __( 'My Action', 'gravityforms-myaddon' ),
'description' => __( 'Does something useful.', 'gravityforms-myaddon' ),
'summary' => __( 'Short, plain-language line shown as the settings tooltip.', 'gravityforms-myaddon' ),
'capability' => 'gravityforms_edit_forms',
'execute_callback' => [ $this, 'handle_my_action' ],
],
];
return $definitions;
} );

Since

  • 3.1.0

Source

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

Returns

Filtered array of raw definition arrays.