EasyAdmin Slug Field
This field is used to dynamically generate the slug of another text field. The
slug of a text is a simplified version which is safe to include in URLs and file
names. For example, the slug of Lorem Ipsum Dolor Sit Amet
is usually
something like lorem-ipsum-dolor-sit-amet
.
In form pages (edit and new) it looks like this:
![Default style of EasyAdmin slug field](/doc/bundles/EasyAdminBundle/4.x/field-slug.png)
Basic Information
- PHP Class:
EasyCorp
\Bundle \EasyAdminBundle \Field \SlugField - Doctrine DBAL Type used to store this value:
string
orascii_string
- Symfony Form Type used to render the field:
SlugType
, a custom form type created by EasyAdmin based on Symfony's TextType Rendered as:
1
<input type="text" value="...">
Options
setTargetFieldName
This field uses JavaScript to generate the slug dynamically based on the contents of another field. This option defines the name of the entity property that is associated to that field:
1
yield SlugField::new('...')->setTargetFieldName('title');
You can pass multiple field names to generate the slug concatenating the slugs of all those fields (they are concatenated in the same order as you defined the fields):
1 2
// the slugs are concatenated in the same order (e.g. '2023-news-lorem-ipsum')
yield SlugField::new('...')->setTargetFieldName(['year', 'type', 'title']);
setUnlockConfirmationMessage
By default, both the slug and the other field are in sync and the slug text changes when the other field contents change. However, users can click on the lock icon of this field to stop syncing the contents, which is needed to customize the slug text.
Use this option if you want to customize the message displayed when stopping the sync of contents:
1 2 3
yield SlugField::new('...')->setUnlockConfirmationMessage(
'It is highly recommended to use the automatic slugs, but you can customize them'
);