Chapter 3. Basic Configuration
Chapter 3. Basic Configuration¶
This chapter explains all the basic and general configuration options available for your backends. It's common to change some of these options as soon as the backend is created.
Changing the URL Used to Access the Backend¶
By default, the backend is accessible at the
/admin URL of your Symfony
application. This value is defined in the
prefix option when loading the
routes of the bundle. Change its value to meet your own requirements:
1 2 3 4 5
# config/routes/easy_admin.yaml easy_admin_bundle: resource: '@EasyAdminBundle/Controller/AdminController.php' prefix: /_secret_backend # <-- change this value type: annotation
Depending on your existing routing configuration, Symfony may ignore this
configuration. Run the
debug:router command to troubleshoot any problem
with the application routes.
Changing the Name of the Backend¶
By default, the backend displays
Easy Admin as its name. Use the
site_name option to change this value:
1 2 3 4
# config/packages/easy_admin.yaml easy_admin: site_name: 'ACME Megacorp.' # ...
The contents of this option are not escaped in the template, so you can use HTML tags if needed:
1 2 3 4
# config/packages/easy_admin.yaml easy_admin: site_name: 'ACME <em style="font-size: 80%;">Megacorp.</em>' # ...
This flexibility allows to use an
<img> HTML tag to display an image-based
logo instead of a text-based logo:
1 2 3 4
# config/packages/easy_admin.yaml easy_admin: site_name: '<img src="https://symfony.com/logos/symfony_white_01.png" />' # ...
Changing the Homepage of the Backend¶
By default, the homepage of the backend shows the items of the first configured entity. Read the Chapter 8. Menu Configuration to learn how to change this homepage.
Restricting the Access to the Backend¶
EasyAdmin relies on the underlying Symfony security mechanism to restrict the access to your backend. Read the Symfony Security documentation to learn how to protect the backend URLs.
When accessing a protected backend, EasyAdmin displays the name of user who is logged in the application. Otherwise it displays "Anonymous User".
Configuring the Logged In User Information¶
The information of the logged in user is displayed by default in all pages. The
user name is the string conversion of the
app.user object of the Twig
template and the avatar is a generic user icon. If you want to hide any of this
information, use these config options:
1 2 3 4 5 6
# config/packages/easy_admin.yaml easy_admin: user: display_name: true display_avatar: false # ...
You can also change how the user name and avatar are obtained with these other
options. Their values are any valid PropertyAccess component expression,
which is applied to the
app.user object of the Twig template:
1 2 3 4 5 6 7
# config/packages/easy_admin.yaml easy_admin: user: # this will look for getFullName(), isFullName(), ..., and 'fullName' property name_property_path: 'fullName' avatar_property_path: 'gravatar' # ...
Next chapter: Chapter 4. Design Configuration
This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.