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.