Bootstrap Admin-Datentabellen anpassen
Leitfaden zur Anpassung von Datensatzlisten

Die Bootstrap Admin-Datentabellen können über ihre Haupt-PHP-Klasse und ihre TWIG-Vorlage angepasst werden, die beide im admin Ordner verfügbar sind.


Struktur der Dateien der Admin-Datentabellen

Wenn Sie eine Datentabelle mit dem CRUD-Generator erstellen, werden mehrere Dateien generiert:

/admin/class/crud/Table.php
Die Haupt-PHP-Klasse
/admin/templates/table.html
Die HTML-TWIG-Vorlage
/admin/crud-data/table-filter-data.
Die Filter zum Filtern Ihrer Datensätze, falls vorhanden
/admin/crud-data/table-select-data.
Konfiguration der Auswahldropdowns, falls vorhanden

wobei table die Tabelle ist, die Sie anpassen möchten.

Die beiden JSON-Dateien werden von der internen PHPCG-Engine verwendet, um Ihre Datenlistenfilter oder Auswahldaten zu erstellen.
Behandeln Sie sie als private CORE-Dateien und ändern Sie sie nicht.

Die Dateien, die uns hier interessieren, sind die PHP-Klasse und die TWIG-HTML-Vorlage.

Die Haupt-PHP-Klasse

Die Haupt-PHP-Klasse führt die SQL-Abfrage an Ihre Datenbank aus und ruft die Datensätze aus Ihrer Tabelle ab.

Außerdem ruft sie die Datensätze aus den relationalen Tabellen ab, wenn diese in Ihrer Datentabelle angezeigt werden sollen.

Felder und Werte werden als Attribute des Objekts in einer Schleife gespeichert, die Ihre Datensätze durchläuft:

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

Jeder $row-> ist der Wert, der in der Datentabelle angezeigt wird.

Sie können beliebige Funktionen anwenden, um sie zu ändern, zum Beispiel:

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

Die TWIG-HTML-Vorlage

Die TWIG-HTML-Vorlage ruft die Werte aus der Haupt-PHP-Klasse ab und erstellt die HTML-Datentabelle.

Sie können jeden Vorlagenteil einfach bearbeiten, insbesondere die <th></th> und <td></td> Elemente der Tabelle.

Werte mit HTML-Code

Häufig kommt es vor, dass HTML-Inhalte gespeichert werden, die zum Beispiel mit einem RTE (TinyMce) bearbeitet werden.

Die TWIG-Vorlage zeigt standardmäßig HTML-Tagsan, während Sie HTML-Inhalte.

anzeigen möchten. Dazu ändern wir die TWIG-Vorlage und verwenden den TWIG-rawFilter:

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

Beispiel für eine Anpassung mit Verlinkung zur öffentlichen Website

Aktivieren Sie im Generator die Option URL-Button öffnen , wenn Sie Ihre READ-Liste erstellen.
Dadurch wird jedem Datensatz Ihrer Liste im Admin-Panel ein Link-Symbol hinzugefügt.

Der Link zeigt auf die Domain-Root; wir möchten diesen Link so ändern, dass er zu den jeweiligen Seiten jedes Datensatzes auf der öffentlichen Website führt. So erreichen Sie das:

Nehmen wir die Tabelle actor als Beispiel; sagen wir, jeder Datensatz soll eine Seite öffnen: https://www.my-website.com/actor-x.php, wobei x der Index ist.

  1. Öffnen Sie admin/templates/actor.html in Ihrem Code-Editor.
  2. Suchen Sie den open url Link in der Vorlage, der etwa so aussehen sollte:
    <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. Dieser Link führt Sie im Moment zur Startseite. Damit er auf die Seite des Schauspielers verweist, müssen Sie die URL (href) ändern und den Index des aktuellen Datensatzes hinzufügen:
    <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>

    Hier verwenden wir den Primärschlüssel: {{ object.pk[loop.index0] }}.

    Er stammt aus dem Actor Objekt in admin/class/crud/Actor.php, das an die TWIG-Vorlage übergeben wurde.

Wie behalten Sie Ihre Änderungen bei, wenn Sie Ihre Data Tables neu erstellen?

Nachdem Sie Änderungen in den von PHPGC generierten Administrationsdateien vorgenommen haben, werden diese Änderungen überschrieben, wenn Sie Ihre READ-Liste neu generieren.

Automatisches Backup der Admin-Dateien

Um Datenverlust zu vermeiden:

Wenn Sie die Admin-Panel-Dateien generieren, werden die vorhandenen Dateien im Backup-Ordner des Generators gespeichert: /generator/backup-files/

Dateivergleichstool

Die Generator-Vergleichstool ermöglicht Ihnen:

  • die gespeicherten Versionen mit den neu generierten Versionen zu vergleichen
  • die beiden verfügbaren Versionen zusammenzuführen, indem Sie in den beiden linken/rechten Bereichen die Codeabschnitte auswählen, die Sie behalten möchten.

Voraussetzungen

Um die Bootstrap-Admin-Data-Tables mit PHPCG anzupassen, müssen Sie zuvor:

Hauptseite des PHP-CRUD-Tutorials