EasyAdmin est installé, mais /admin affiche encore la page d’accueil par défaut. Avant de construire notre premier CRUD, on va afficher notre propre dashboard, en gardant le layout d’EasyAdmin pour conserver le menu latéral.
Les trois options de index()
Ouvre src/Controller/Admin/DashboardController.php. La méthode index() générée propose trois options :
- Rediriger vers une page existante du back-office
- Rediriger selon une condition, par exemple en fonction de l’utilisateur connecté
- Afficher ton propre template, pour construire un vrai dashboard avec des widgets
On choisit l’option 3 : c’est simple, et on garde la main sur tout.
Afficher notre template
Décommente la ligne render() et fais-la pointer vers un template dans un dossier admin/ :
public function index(): Response
{
// Option 3. Render a custom template
return $this->render('admin/dashboard.html.twig');
}
Créer le template
Crée le dossier templates/admin/ et le fichier dashboard.html.twig. Le template étend la page de contenu d’EasyAdmin et remplit le bloc content :
{% extends '@EasyAdmin/page/content.html.twig' %}
{% block content %}
<h1>Dashboard</h1>
{% endblock %}
Étendre @EasyAdmin/page/content.html.twig, c’est la clé : on récupère tout le layout d’EasyAdmin (en-tête, menu latéral, styles) et on n’écrit que le contenu.
Résultat
Rafraîchis /admin : notre dashboard s’affiche, avec le menu latéral et son élément Dashboard. L’icône à côté vient de l’élément de menu qu’on a vu au chapitre précédent :
yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');
Pour aller plus loin : un vrai tableau de bord
Un dashboard qui dit juste « Dashboard », c’est un peu vide. Comme index() est un controller Symfony classique, on peut y injecter des repositories et passer des chiffres au template :
use App\Repository\AuthorRepository;
use App\Repository\BookRepository;
public function __construct(
private readonly BookRepository $bookRepository,
private readonly AuthorRepository $authorRepository,
) {}
public function index(): Response
{
return $this->render('admin/dashboard.html.twig', [
'nbBooks' => $this->bookRepository->count([]),
'nbAuthors' => $this->authorRepository->count([]),
]);
}
{% extends '@EasyAdmin/page/content.html.twig' %}
{% block content %}
<h1>Mini Bibliothèque</h1>
<p>{{ nbBooks }} livres · {{ nbAuthors }} auteurs</p>
{% endblock %}
count([]) compte toutes les lignes de la table, sans filtre.
Récap
index()décide de ce qu’affiche/admin$this->render('admin/dashboard.html.twig')affiche notre propre page- Étendre
@EasyAdmin/page/content.html.twigconserve le layout d’EasyAdmin
Exercice · Le nombre de catégories
Ajoute au dashboard le nombre de catégories, sur le même modèle que les livres et les auteurs.
Voir la solution
Injecte CategoryRepository dans le constructeur, puis :
'nbCategories' => $this->categoryRepository->count([]),
Et dans le template :
<p>{{ nbBooks }} livres · {{ nbAuthors }} auteurs · {{ nbCategories }} catégories</p>
La suite
On va créer notre premier CRUD, pour les catégories, et personnaliser ses libellés.
Ceci est le chapitre 6 du cours Mini Bibliothèque. Suis la série pour construire de zéro une application complète de bibliothèque numérique avec Symfony 8 et EasyAdmin.