Series Eight

Uuid (Statamic V2)

Series Eight

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 serieseight/statamic-uuid

Publish the fieldtype assets:

php artisan vendor:publish --provider="SeriesEight\Uuid\UuidServiceProvider"

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.
readonly false Set the input to readonly, stopping the user from editing the field.
prefix '' Add a prefix to the ID

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

Output

sections:
  -
    uuid: 026fd166-8638-4c21-9e38-730b4ab3d4ea
    type: section
    fields:
      -
        uuid: b07389fe-8760-4f81-8c35-50779bd43b61
        type: value
  -
    uuid: 4a7ce0b0-0483-42d9-a7b0-ce0201dd9c84
    type: section
    fields:
      -
        uuid: b07389fe-8760-4f81-8c35-50779bd43b61
        type: value
      -
        uuid: 5a7534a8-27bf-4ac6-8549-d3b429a61ff3
        type: value