Skip to content

Latest commit

 

History

History
85 lines (63 loc) · 2.52 KB

1-general-configuration.md

File metadata and controls

85 lines (63 loc) · 2.52 KB
Raw

Chapter 1. General Configuration

EasyAdmin proposes a hybrid approach to customize the backends:

  • Use YAML-based configuration when it's simple to do so;
  • Use PHP methods and Twig templates for more advanced customization.

This chapter explains all the general YAML-based configuration options. The rest of chapters explain how to do extreme backend customizations using PHP methods and Twig templates.

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:

# app/config/routing.yml
easy_admin_bundle:
    resource: "@EasyAdminBundle/Controller/"
    type:     annotation
    prefix:   /_secret_backend  # <-- change this value

# ...

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:

# app/config/config.yml
easy_admin:
    site_name: 'ACME Megacorp.'
    # ...

The contents of this option are not escaped before displaying them, so you can use HTML tags if needed:

# app/config/config.yml
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:

# app/config/config.yml
easy_admin:
    site_name: '<img src="http://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 Menu Configuration chapter 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".

Chapter 2. Design Configuration →