Gravity Wiz

Magically enhanced tutorials, snippets and plugins for Gravity Forms!

gpui_unique_id

  1. Description
  2. Usage
  3. Parameters
  4. Examples
    1. Prepend Unique IDs with a dynamic string
  5. Since

Description

Allows you to modify the generated Unique ID using a custom function.

This modifies a core aspect of this perk and may break your forms. Make sure that your custom function always returns a unique string by incorporating the $unique parameter in its output.

Usage

add_filter( 'gpui_unique_id', 'my_custom_function', 10, 3);

Parameters

The generated Unique ID.

The ID of the current form containing the Unique ID (UID) field.

The ID of the Unique ID form field.

Examples

Prepend Unique IDs with a dynamic string

This example shows you how to prepend all generated IDs with the output of a custom function (my_custom_function) before the value is stored in the database.

add_filter( 'gpui_unique_id', function( $unique, $form_id, $field_id ) {
    // Prepend UIDs with a dynamically generated string
    $my_pre = my_custom_function();
    return $my_pre . $unique;
}, 10, 3 );

Since

This filter is available since Gravity Forms Unique ID 1.3.13.