gpui_unique_id
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
Examples
Reset Genereated ID when it reaches a number
This example shows you how to reset a sequentially generated ID when it reaches a specific number.
<?php
/**
* Gravity Perks // Unique ID // Reset Sequence at Specific Threshold
* https://gravitywiz.com/documentation/gravity-forms-unique-id/
*
* Reset the sequence of a Sequential Unique ID field when the sequence reaches a specified number.
*/
add_filter( 'gpui_unique_id', function( $unique, $form_id, $field_id ) {
// Update "123" to your form ID and "4" to the ID of your Unique ID field.
if ( $form_id == 123 && $field_id == 4 ) {
// Update "1" to the number the sequence should be reset to when the threshold is reached.
$starting_number = 1;
// Update "99" to the threshold at which the sequence should be reset.
$reset_number = 99;
if ( $unique == $reset_number ) {
gp_unique_id()->set_sequential_starting_number( $form_id, $field_id, $starting_number - 1 );
}
}
return $unique;
}, 10, 3 );
Since
This filter is available since Gravity Forms Unique ID 1.3.13.
All Connections
All Perks
- GF Address Autocomplete
- GF Advanced Calculations
- GF Advanced Phone Field
- GF Advanced Save & Continue
- GF Advanced Select
- GF Auto List Field
- GF Auto Login
- GF Better User Activation
- GF Blocklist
- GF Bookings
- GF Conditional Logic Dates
- GF Conditional Pricing
- GF Copy Cat
- GF Date Time Calculator
- GF Disable Entry Creation
- GF Easy Passthrough
- GF eCommerce Fields
- GF Email Users
- GF Email Validator
- GF Entry Blocks
- GF Expand Textareas
- GF File Renamer
- GF File Upload Pro
- GF Inventory
- GF Limit Checkboxes
- GF Limit Dates
- GF Limit Submissions
- GF Live Preview
- GF Media Library
- GF Multi-Page Navigation
- GF Nested Forms
- GF Notification Scheduler
- GF Page Transitions
- GF Pay Per Word
- GF Populate Anything
- GF Post Content Merge Tags
- GF Preview Submission
- GF Price Range
- GF QR Code
- GF Randomizer
- GF Read Only
- GF Reload Form
- GF Submit to Access
- GF Terms Of Service
- GF Unique ID
- GF Word Count