Tilpasning af Bootstrap Admin-datatabeller
Guide til tilpasning af postlister

Bootstrap Admin-datatabellerne kan tilpasses ved hjælp af deres primære PHP-klasse og deres TWIG-skabelon, som findes i admin -mappen.


Organisation af filerne vedrørende admin-datatabellerne

Når du opretter en datatabel fra CRUD-generatoren, genereres flere filer:

/admin/class/crud/Table.php
Den primære PHP-klasse
/admin/templates/table.html
HTML TWIG-skabelonen
/admin/crud-data/table-filter-data.
Filtrene, der bruges til at filtrere dine poster, hvis der er nogen
/admin/crud-data/table-select-data.
Konfiguration af rullemenuer, hvis der er nogen

hvor table er den tabel, du vil tilpasse.

De to JSON-filer bruges af den interne PHPCG-motor til at opbygge dine datalistefiltre eller select-data.
Betragt dem som private CORE-filer, og modificer dem ikke.

De filer, vi er interesserede i her, er PHP-klassen og TWIG HTML-skabelonen.

Den primære PHP-klasse

Den primære PHP-klasse udfører SQL-forespørgslen til din database og henter posterne fra din tabel.

Den henter også posterne fra de relationelle tabeller, hvis de skal vises i din datatabel.

Felter og værdier gemmes som attributter for objektet i en løkke, der gennemgår dine poster:

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

Hver $row-> er den værdi, der vil blive vist i datatabellen.

Du kan anvende enhver funktion, hvis du vil ændre dem, for eksempel:

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

TWIG HTML-skabelonen

Den TWIG HTML-skabelonen henter værdierne fra den primære PHP-klasse og opbygger HTML-datatabellen.

Du kan nemt redigere enhver del af skabelonen, især tabellens <th></th> og <td></td> -elementer.

Værdier med HTML-kode

Det sker ofte, at HTML-indhold gemmes, som f.eks. redigeres med en RTE (TinyMce).

TWIG-skabelonen viser som standard HTML-tags, mens du vil vise HTML-indhold.

For at gøre dette vil vi ændre TWIG-skabelonen og bruge TWIG "raw"-filteret:

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

Eksempel på tilpasning med linkning til den offentlige hjemmeside

I generatoren skal du aktivere Open URL-knappen når du opbygger din READ-liste.
Dette tilføjer et link-ikon til hver post i din liste i adminpanelet.

Linket peger på domæneroden, vi vil ændre dette link, så det fører til de respektive sider for hver af optagelserne på den offentlige hjemmeside. Sådan opnår du dette.

Lad os tage actor -tabellen som eksempel, lad os sige, at hver post skal åbne en side https://www.my-website.com/actor-x.php, hvor x er indekset.

  1. Åbn admin/templates/actor.html i din kodeeditor.
  2. Find open url -linket i skabelonen, det burde se sådan ud:
    <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. Dette link fører dig i øjeblikket til forsiden. For at få det til at pege på skuespillerens side skal du ændre URL'en (href) og tilføje indekset for den aktuelle post:
    <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>

    Her bruger vi primærnøglen: {{ object.pk[loop.index0] }}.

    Den kommer fra Actor objektet i admin/class/crud/Actor.php, som er blevet sendt til TWIG-skabelonen.

Hvordan bevarer du dine ændringer, hvis du genopbygger dine datatabeller?

Efter at have foretaget ændringer i administrationsfilerne genereret af PHPGC, vil disse ændringer blive overskrevet, hvis du genopretter din READ-liste.

Automatisk sikkerhedskopiering af admin-filerne

For at undgå datatab:

Når du genererer admin-panelets filer, gemmes de eksisterende filer i generatorens backupmappe: /generator/backup-files/

Sammenligningsværktøj til filer

Den sammenligningsværktøjet giver dig mulighed for at:

  • sammenligne de gemte versioner med de nygenererede versioner
  • flette de to tilgængelige versioner ved at vælge de kodestykker, du vil beholde, i de to venstre/højre ruder.

Forudsætninger

For at tilpasse Bootstrap Admin-datatabellerne med PHPCG skal du først:

PHP CRUD-tutorialens hovedside