Uuid Icon

Uuid

Uuid Main Screenshot

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.