Générer des vues de liste de base de données en PHP CRUD
Guide de gestion des listes de données

Générez votre vue de liste d'administration Bootstrap en quelques clics avec PHPCG


Résumé

Génération des vues de liste du tableau de bord d'administration

Les "vues de liste" sont les listes d'enregistrements affichées sous forme tabulaire dans le tableau de bord d'administration.
Le CRUD Generator vous permet d'intégrer chaque table de votre base de données dans le tableau de bord 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 info-bulles nécessaires pour vous guider ; toutefois, nous détaillerons ici les fonctionnalités disponibles.

Le formulaire de création de vue de liste est organisé en cinq parties, vous permettant de personnaliser votre vue de liste selon vos besoins.
Vous pouvez valider en bas de page pour générer la vue de liste de l'administration.
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 effectuées dans la version précédente vers la version nouvellement générée.


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

Paramètres principaux

Ici, vous pouvez configurer les paramètres suivants :

URL d'ouverture bouton
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 activé, un bouton "Exporter" avec un menu déroulant sera disponible dans la vue de liste d'administration.
Les utilisateurs peuvent choisir d'exporter tous les enregistrements ou uniquement ceux affichés sur la page actuelle.
L'exportation au format Excel ou CSV est disponible, ainsi qu'une vue imprimable dans un nouvel onglet.
Autoriser la suppression groupée
Cette option permet de supprimer plusieurs enregistrements à la fois, en les sélectionnant individuellement avec 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 les enregistrements "en cascade" ou non.
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 quel champ sera sélectionné par défaut.
Trier 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'admin. Par exemple "Nom" pour un champ "last_name".
Les noms définis ici seront utilisés partout où ils doivent apparaître dans l'admin : dans la vue Liste, mais aussi dans les formulaires, ou lorsque ces champs sont utilisés par d'autres tables dans les 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 selon les valeurs sélectionnées.
Ils sont interdépendants : chaque filtre n'affiche dans sa liste déroulante que les enregistrements disponibles avec les autres filtres actifs.

Pour les filtres en mode "avancé", vous devez saisir les détails de la requête SQL. Une aide rapide est disponible directement 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 s'il faut l'afficher dans la liste ou non, ou activer le tri ou l'édition en direct.
L'option table imbriquée retire les champs des cellules du tableau de données principal, ce qui permet de se concentrer sur l'essentiel. Un bouton est ajouté au début de chaque ligne du tableau ; lorsqu'on clique 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 s'affichent en conséquence. Par exemple, si votre champ est une date/date-heure, il vous sera proposé de définir votre format d'affichage de date/heure préféré.

Si le type de votre champ est SET/ENUM, ou si vous activez l'édition en direct en mode "select", il vous sera proposé de choisir/modifier les valeurs du champ "select".
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 depuis 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 identifiant (ce qui est probablement une bonne idée !)

Relations externes

Les relations externes sont celles qui utilisent une table intermédiaire pour lier deux autres tables.
Par exemple actor => film_actor => film

Bien que dans ce type de relation les tables soient principalement liées par des identifiants numériques, PHP CRUD 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 identifiant (ce qui est nettement mieux !). Il vous suffit de choisir les champs à afficher dans le champ multiple "select".

Prérequis

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

Page principale du tutoriel PHP CRUD