Générer une vue de liste d'administration Bootstrap

Générez votre vue de liste Bootstrap Admin en quelques clics avec PHPCG


Résumé

Génération des vues en liste de l'Interface d\'administration

Les"vues de liste" sont les listes d'enregistrements affichées sous forme de tableau dans l'interface d'administration.
Le générateur CRUD vous permet d'intégrer chaque table de votre base de données dans l'Interface d'administration. Il détecte les différents types de champs et vous fournit les paramètres appropriés en fonction de ceux-ci.

La création d'une vue de liste est simple et le formulaire contient l'aide et les infobulles nécessaires pour vous guider, mais nous détaillerons ici les fonctionnalités disponibles.

Le formulaire de création d'une vue de liste est organisé en cinq parties, ce qui vous permet de personnaliser votre vue de liste en fonction de vos besoins.
Vous pouvez valider en bas de page pour générer la vue de la liste de l'administrateur.
Vous pouvez également régénérer vos listes à tout moment, ce qui rend votre panneau d'administration infiniment évolutif.
Si vous avez personnalisé le code généré par le CRUD, l'outil de comparaison/fusion vous permet de reporter les modifications apportées dans la version précédente sur la nouvelle version générée.


Voyons de plus près comment ce formulaire est organisé.

Paramètres principaux

Vous pouvez y configurer les paramètres suivants :

BoutonOuvrir l'URL
Cette option vous permet de lier chaque enregistrement à la page associée sur votre site web public.
Tout est expliqué en détail dans ce tutoriel.
Bouton "Exporter" (xls / csv)
Si cette option est activée, un bouton "Exporter" avec un menu déroulant sera disponible dans la vue Liste de l'administrateur.
Les utilisateurs peuvent choisir d'exporter tous les enregistrements ou seulement ceux qui sont affichés sur la page en cours.
L'exportation au format Excel ou CSV est disponible, ainsi qu'une vue imprimable dans un nouvel onglet.
Autoriser la suppression en bloc
Cette option vous permet de supprimer plusieurs enregistrements à la fois, en les sélectionnant individuellement à l'aide d'une case à cocher, puis en confirmant la sélection.
Si votre table a des relations avec d'autres tables, vous aurez la possibilité de supprimer ou non les enregistrements "en cascade".
Champ par défaut pour la recherche
La barre de recherche permet à l'utilisateur de choisir le champ de la base de données dans lequel effectuer la recherche au moyen d'un menu déroulant.
Cette option permet à l'utilisateur de choisir le champ qui sera sélectionné par défaut.
Commander par
Choisissez ici l'ordre d'affichage par défaut des enregistrements.

Noms des champs affichés dans l'administration

Définissez ici pour chaque champ les noms lisibles qui seront affichés dans l'administration. Par exemple "Nom de famille" pour un champ "nom_de_famille".
Les noms définis ici seront utilisés partout où ils doivent apparaître dans l'administration : dans la vue Liste, mais aussi dans les formulaires, ou lorsque ces champs sont utilisés par d'autres tables dans des relations.

Filtres (listes déroulantes pour filtrer les résultats)

Les filtres permettent à l'utilisateur de rechercher et de filtrer les enregistrements de la liste en fonction des valeurs sélectionnées.
Ils sont interdépendants : chaque filtre n'affiche dans sa liste déroulante que les enregistrements disponibles lorsque les autres filtres sont actifs.

Pour les filtres en mode "avancé", vous devez saisir les détails de la requête SQL. Une aide rapide est disponible sur la page du générateur ; des explications complètes sont disponibles dans le tutoriel sur les filtres.

Champs

Dans cette section, vous pouvez configurer chaque champ individuellement, par exemple l'afficher ou non dans la liste, activer le tri ou l'édition en direct.
L'option de tableau imbriqué supprime les champs des cellules du tableau de données principal, ce qui permet de se concentrer sur les informations essentielles. Un bouton est ajouté au début de chaque ligne du tableau ; lorsque vous cliquez dessus, les champs imbriqués s'affichent, fournissant les détails de l'enregistrement.

Les types de champs sont détectés et les paramètres appropriés sont affichés en fonction de ceux-ci. Par exemple, si votre champ est une date/heure, vous serez invité à définir le format d'affichage de la date et de l'heure que vous préférez.

Si votre type de champ est SET/ENUM, ou si vous activez l'édition en direct en mode "sélection", il vous sera proposé de choisir/modifier les valeurs du champ "sélection".
Ces valeurs peuvent être sélectionnées à partir d'un champ de la base de données ou saisies individuellement.

Si un champ est une clé dont la valeur provient d'une table relationnelle, vous pouvez choisir la ou les valeurs à afficher dans la table de destination.
Par exemple, si une table d'adresses comporte un champ country_id, vous pouvez afficher le nom du pays plutôt que son ID (ce qui est probablement une bonne idée !).

Relations extérieures

Les relations externes sont celles qui utilisent une table intermédiaire pour relier deux autres tables.
Par exemple acteur => film_acteur => film

Bien que dans ce type de relation les tables soient principalement liées par des identifiants numériques, PHP CRUD Generator vous permet d'afficher les champs de votre choix pour la table de destination.
Par exemple, vous pouvez afficher le titre des films et leur date de sortie plutôt que leur ID (ce qui est tout de même mieux !). Il vous suffit de choisir les champs à afficher dans le champ multiple "select".

Conditions préalables

Pour générer votre panneau d'administration Bootstrap avec PHPCG vous devez au préalable :

Page principale du tutoriel CRUD PHP