Overview
The most common use for the Users fieldtype is to set the "author" for entries, but it's not the only use. You could...
- List people who contributed to a project
- Link to related authors
- Manage an "Employee of the Weekend" section. Everyone wants to be the King or Queen of Inventory Saturday, right?
- Display team bios
- Pull in customer's testimonials through their user account.
Data Structure
The Users fieldtype is a relationship fieldtype – which mean the data will store a reference to the users IDs to main a dynamic link.
author: abc-123-cba-321
Templating
All relationship fields use augmentation to fetch the actual data objects, allowing you to interact with the related data automatically and dynamically.
The following example assumes max_items
has been set to 1
.
<div class="bg-white p-4 shadow flex items-center">{{ author }} <img class="w-10 h-10 rounded-full" src="{{ avatar }}" alt="Avatar of {{ name }}"> <div class="text-sm ml-4"> <p class="text-gray-900 leading-none">{{ name }}</p> <p class="text-gray-600">{{ email }}</p> </div>{{ /author }}</div>
<div class="bg-white p-4 shadow flex items-center"> <img class="w-10 h-10 rounded-full" src="{{ $author->avatar }}" alt="Avatar of {{ $author->name }}"> <div class="text-sm ml-4"> <p class="text-gray-900 leading-none">{{ $author->name }}</p> <p class="text-gray-600">{{ $author->email }}</p> </div></div>
<div class="bg-white p-4 shadow flex items-center"> <img class="w-10 h-10 rounded-full" src="/img/avatars/david.jpg" alt="Avatar of David Hasselhoff"> <div class="text-sm ml-4"> <p class="text-gray-900 leading-none">David Hasselhoff</p> </div></div>
Options
default
Setting to current
will default the field to the currently logged in user.
max_items
The maximum number of users than can be selected. Leave it empty for no limit (default). Setting to 1
will save the value as a string
instead of an array
and will switch to a select dropdown UI.
mode
Choose between select
, typeahead
, and the default
stack selector UI modes.
query_scopes
Allows you to specify a query scope which should be applied when retrieving selectable assets. You should specify the query scope's handle, which is usually the name of the class in snake case. For example: MyAwesomeScope
would be my_awesome_scope
.