Organizzazione dei file relativi alle tabelle admin
Quando crei una Data Table dal CRUD Generator vengono generati diversi file:
- /admin/class/crud/Table.php
- La classe PHP principale
- /admin/templates/table.html
- Il template TWIG HTML
- /admin/crud-data/table-filter-data.
- I filtri utilizzati per filtrare i tuoi record, se presenti
- /admin/crud-data/table-select-data.
- Configurazione dei menu a tendina di selezione, se presenti
dove table è la tabella che desideri personalizzare.
I due file JSON sono utilizzati dal motore interno di PHPCG per costruire i filtri della tua datalist o i dati di selezione.
Considerali come file CORE privati e non modificarli.
I file che ci interessano qui sono la Classe PHP e il Template TWIG HTML.
La Classe PHP Principale
La Classe PHP Principale esegue la query SQL sul tuo database e recupera i record dalla tua tabella.
Recupererà anche i record dalle tabelle relazionali se devono essere visualizzati nella tua data table.
I campi e i valori vengono registrati come attributi dell'oggetto, in un ciclo che scorre i tuoi record:
if (!empty($this->records_count)) {
while ($row = $db->fetch()) {
$this->pk[] = $row->$primary_key;
$this->my_field[]= $row->my_field;
// ...
}
}
Ogni $row-> è il valore che verrà visualizzato nella Data table.
Puoi applicare qualsiasi funzione se desideri modificarli, ad esempio:
$this->my_field[]= strtolower($row->my_field); // to lowercase
if (!empty($row->my_field)) {
$this->my_field[]= 'Yes';
} else {
$this->my_field[]= 'No';
}
Il Template TWIG HTML
Il Template TWIG HTML recupera i valori dalla Classe PHP Principale e costruisce la data table HTML.
Puoi facilmente modificare qualsiasi parte del template, in particolare gli elementi <th></th> e <td></td> della tabella.
Valori con codice HTML
Spesso capita che venga memorizzato contenuto HTML, che verrà modificato ad esempio con un RTE (TinyMce).
Il template TWIG visualizzerà per impostazione predefinita i tag HTML, mentre tu desideri visualizzare il contenuto HTML.
Per farlo, modificheremo il template TWIG e utilizzeremo il filtro TWIG "raw":
<td>{{ object.last_name[ loop.index0 ]|raw }}</td>
Esempio di personalizzazione con collegamento al sito web pubblico
Nel Generator, attiva il pulsante Open URL quando costruisci il tuo elenco READ.
Questo aggiungerà un'icona di collegamento a ogni record del tuo elenco nel pannello di amministrazione.
Il collegamento punta alla radice del dominio, vogliamo modificare questo collegamento in modo che porti alle rispettive pagine di ciascuna registrazione sul sito web pubblico. Ecco come ottenere questo risultato.
Prendiamo la tabella actor come esempio, diciamo che ogni record deve aprire una pagina https://www.my-website.com/actor-x.php, dove x è l'indice.
- Apri admin/templates/actor.html nel tuo editor di codice.
- Trova il collegamento open url nel template, che dovrebbe apparire così:
<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>
- Questo collegamento per il momento ti porterà alla home page. Per farlo puntare alla pagina dell'attore, devi modificare l'URL (href) e aggiungere l'indice del record corrente:
<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>
Qui utilizziamo la chiave primaria: {{ object.pk[loop.index0] }}.
Proviene dall'oggetto Actor in admin/class/crud/Actor.php, che è stato passato al template TWIG.
Come conservare le modifiche se rigenerate le tue Data Tables?
Dopo aver apportato modifiche ai file di amministrazione generati da PHPCG, se rigeneri la tua READ List, queste modifiche verranno sovrascritte.
Backup automatico dei file Admin
Per evitare la perdita di dati:
Quando generi i file del pannello di amministrazione, i file esistenti vengono salvati nella cartella di backup del generatore: /generator/backup-files/
Strumento di confronto file
Il lo strumento di confronto del generatore ti permette di:
- confrontare le versioni salvate con le nuove versioni generate
- unire le due versioni disponibili selezionando nei due pannelli sinistro/destro le parti di codice che desideri mantenere.