One of its kind; unlike anything else
This fieldtype auto-generates UUIDs for empty fields. This can be useful if you need unique, persistent IDs for each row in a Replicator, for example.
Installation
Install the addon via composer:
composer require aryehraber/statamic-uuid
Publish the fieldtype assets:
php please vendor:publish --tag=uuid
Usage
Inside your blueprint, simply use type: uuid and a UUID will be generated for that field if it's blank. Already occupied fields (including previously generated UUIDs) will not be overwritten.
Settings
| Name | Default | Description |
|---|---|---|
hidden |
false |
Hide the field from the CP while still generating a UUID. |
read_only |
false |
Set the input to read-only, stopping the user from editing the field. |
id_prefix |
'' |
Add a prefix to the ID. |
id_type |
uuid |
Set the underlying ID generator, options: uuid & nanoid. |
alphabet |
null |
Set a custom alphabet when using nanoid. |
size |
null |
Set the max character limit when using nanoid. |
Example:
Blueprint
fields:
-
handle: sections
field:
type: replicator
sets:
section:
fields:
-
handle: uuid
field:
type: uuid
-
handle: fields
field:
type: replicator
sets:
value:
fields:
-
handle: uuid
field:
type: uuid
id_type: nanoid
alphabet: ABCD1234
size: 5
Output
sections:
-
uuid: 026fd166-8638-4c21-9e38-730b4ab3d4ea
type: section
fields:
-
uuid: A4C11
type: value
-
uuid: 4a7ce0b0-0483-42d9-a7b0-ce0201dd9c84
type: section
fields:
-
uuid: B1CB3
type: value
-
uuid: 41CD1
type: value
Credits
Originally built at Series Eight, now maintained by Aryeh Raber.