Personnalisation des tableaux de données Bootstrap Admin
Guide de personnalisation des listes d'enregistrements

Les tableaux de données Bootstrap Admin peuvent être personnalisés à l'aide de leur classe PHP principale et de leur template TWIG disponibles dans le admin dossier.


Organisation des fichiers relatifs aux tableaux de données admin

Lorsque vous créez un tableau de données à partir du CRUD Generator, plusieurs fichiers sont générés :

/admin/class/crud/Table.php
La classe PHP principale
/admin/templates/table.html
Le template TWIG HTML
/admin/crud-data/table-filter-data.
Les filtres utilisés pour filtrer vos enregistrements, le cas échéant
/admin/crud-data/table-select-data.
Configuration des listes déroulantes de sélection, le cas échéant

où table est le tableau que vous souhaitez personnaliser.

Les deux fichiers JSON sont utilisés par le moteur interne de PHPCG pour construire vos filtres de liste de données ou vos données de sélection.
Considérez-les comme des fichiers CORE privés et ne les modifiez pas.

Les fichiers qui nous intéressent ici sont la classe PHP et le template TWIG HTML.

La classe PHP principale

La classe PHP principale exécute la requête SQL vers votre base de données et récupère les enregistrements de votre tableau.

Elle récupérera également les enregistrements des tables relationnelles s'ils doivent être affichés dans votre tableau de données.

Les champs et les valeurs sont enregistrés en tant qu'attributs de l'objet, dans une boucle qui parcourt vos enregistrements :

if (!empty($this->records_count)) {
    while ($row = $db->fetch()) {
        $this->pk[] = $row->$primary_key;
        $this->my_field[]= $row->my_field;
        // ...
    }
}

Chaque $row-> est la valeur qui sera affichée dans le tableau de données.

Vous pouvez appliquer n'importe quelle fonction si vous souhaitez les modifier, par exemple :

$this->my_field[]= strtolower($row->my_field); // to lowercase
if (!empty($row->my_field)) {
    $this->my_field[]= 'Yes';
} else {
    $this->my_field[]= 'No';
}

Le template TWIG HTML

Le template TWIG HTML récupère les valeurs de la classe PHP principale et construit le tableau de données HTML.

Vous pouvez facilement modifier n'importe quelle partie du template, en particulier les éléments <th></th> et <td></td> du tableau.

Valeurs avec code HTML

Il arrive souvent que du contenu HTML soit stocké, qui sera édité par exemple avec un RTE (TinyMce).

Le template TWIG affichera par défaut les balises HTML, alors que vous souhaitez afficher le contenu HTML.

Pour ce faire, nous allons modifier le template TWIG et utiliser le filtre TWIG "raw":

<td>{{ object.last_name[ loop.index0 ]|raw }}</td>

Exemple de personnalisation avec un lien vers le site web public

Dans le Generator, activez l'option Open URL button lorsque vous construisez votre liste READ.
Cela ajoutera une icône de lien à chaque enregistrement de votre liste dans le panneau d'administration.

Le lien pointe vers la racine du domaine ; nous voulons modifier ce lien afin qu'il mène aux pages respectives de chacun des enregistrements sur le site web public. Voici comment procéder.

Prenons la table actor comme exemple ; disons que chaque enregistrement doit ouvrir une page https://www.my-website.com/actor-x.php, où x est l'index.

  1. Ouvrez admin/templates/actor.html dans votre éditeur de code.
  2. Trouvez le lien open url dans le template, qui devrait ressembler à ceci :
    <td>
        <a href="{{ constant('BASE_URL') }}" rel="noindex" data-delay="500" data-tooltip="{{ constant('OPEN_URL') }}" target="_blank"><span class="{{ constant('ICON_NEW_TAB') }} text-center"></span></a>
    </td>
  3. Ce lien vous mènera pour le moment à la page d'accueil. Pour qu'il pointe vers la page de l'acteur, vous devez modifier l'URL (href) et ajouter l'index de l'enregistrement en cours :
    <td>
        <a href="{{ constant('BASE_URL') }}/actor-{{ object.pk[loop.index0] }}.php" rel="noindex" data-delay="500" data-tooltip="{{ constant('OPEN_URL') }}" target="_blank"><span class="{{ constant('ICON_NEW_TAB') }} text-center"></span></a>
    </td>

    Ici, nous utilisons la clé primaire : {{ object.pk[loop.index0] }}.

    Elle provient de l' acteur objet dans admin/class/crud/Actor.php, qui a été transmis au modèle TWIG.

Comment conserver vos modifications si vous régénérez vos Data Tables ?

Après avoir apporté des modifications dans les fichiers d'administration générés par PHPGC, si vous régénérez votre liste READ, ces modifications seront écrasées.

Sauvegarde automatique des fichiers Admin

Pour éviter toute perte de données :

Lorsque vous générez les fichiers du panneau d'administration, les fichiers existants sont sauvegardés dans le dossier de sauvegarde du générateur : /generator/backup-files/

Outil de comparaison de fichiers

Le L'outil de comparaison du générateur vous permet de :

  • comparer les versions sauvegardées avec les nouvelles versions générées
  • fusionner les deux versions disponibles en sélectionnant dans les deux volets gauche/droite les parties du code que vous souhaitez conserver.

Prérequis

Pour personnaliser les Data Tables Bootstrap Admin avec PHPCG, vous devez au préalable :

Page principale du tutoriel PHP CRUD