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".
Next chapter: Chapter 4. Design Configuration
This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.