Using Gravity Forms ‘gform_web_api_capability_put_forms_properties’ PHP filter

by

The gform_web_api_capability_put_forms_properties filter allows you to modify the capability required to update form properties via the web API.

Usage

add_filter('gform_web_api_capability_put_forms_properties', function($capability) {
    // your custom code here
    return $capability;
});

Parameters

  • $capability (string): The capability required, defaults to ‘gravityforms_edit_forms’.

More information

See Gravity Forms Docs: gform_web_api_capability_put_forms_properties

Examples

Change capability required to update form properties

This example changes the required capability to ‘manage_options’ for updating form properties.

add_filter('gform_web_api_capability_put_forms_properties', function($capability) {
    return 'manage_options';
});

Allow custom user role to update form properties

This example allows users with a custom user role ‘my_custom_role’ to update form properties.

add_filter('gform_web_api_capability_put_forms_properties', function($capability) {
    return 'my_custom_role';
});

Conditionally allow capability based on user ID

This example allows user with ID 1 to update form properties.

add_filter('gform_web_api_capability_put_forms_properties', function($capability) {
    $current_user = wp_get_current_user();
    if ($current_user->ID == 1) {
        return 'gravityforms_edit_forms';
    }
    return $capability;
});

Remove capability to update form properties

This example removes the capability to update form properties for all users.

add_filter('gform_web_api_capability_put_forms_properties', function($capability) {
    return 'no_capability_allowed';
});

Allow capability based on custom condition

This example allows users to update form properties if a custom condition is met.

add_filter('gform_web_api_capability_put_forms_properties', function($capability) {
    // Replace this condition with your custom condition
    $custom_condition = true;

    if ($custom_condition) {
        return 'gravityforms_edit_forms';
    }
    return $capability;
});