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
| Name | Type | Description |
|---|---|---|
| $raw_definitions | array[] | 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.