Organizace souborů týkajících se administrátorských datových tabulek
Když vytvoříte datovou tabulku z CRUD Generatoru, vygeneruje se několik souborů:
- /admin/class/crud/Table.php
- Hlavní PHP třída
- /admin/templates/table.html
- HTML TWIG šablona
- /admin/crud-data/table-filter-data.
- Filtry používané k filtrování vašich záznamů, pokud existují
- /admin/crud-data/table-select-data.
- Konfigurace rozbalovacích seznamů, pokud existují
kde table je tabulka, kterou chcete přizpůsobit.
Tyto dva JSON soubory jsou používány interním enginem PHPCG k sestavení filtrů vašeho datového seznamu nebo dat pro výběr.
Považujte je za soukromé soubory CORE a nemodifikujte je.
Soubory, které nás zde zajímají, jsou PHP třída a TWIG HTML šablona.
Hlavní PHP třída
Hlavní PHP třída provádí SQL dotaz do vaší databáze a načítá záznamy z vaší tabulky.
Načte také záznamy z relačních tabulek, pokud mají být zobrazeny ve vaší datové tabulce.
Pole a hodnoty jsou zaznamenány jako atributy objektu ve smyčce, která prochází vašimi záznamy:
if (!empty($this->records_count)) {
while ($row = $db->fetch()) {
$this->pk[] = $row->$primary_key;
$this->my_field[]= $row->my_field;
// ...
}
}
Každá $row-> je hodnota, která bude zobrazena v datové tabulce.
Můžete aplikovat libovolnou funkci, pokud je chcete změnit, například:
$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 šablona
Ta TWIG HTML šablona načítá hodnoty z hlavní PHP třídy a sestavuje HTML datovou tabulku.
Snadno můžete upravit jakoukoli část šablony, zejména prvky tabulky <th></th> a <td></td> .
Hodnoty s HTML kódem
Často se stává, že je uložen HTML obsah, který je například upravován pomocí RTE (TinyMce).
TWIG šablona bude ve výchozím stavu zobrazovat HTML značky, zatímco vy chcete zobrazit HTML obsah.
K tomu upravíme TWIG šablonu a použijeme TWIG filtr "raw":
<td>{{ object.last_name[ loop.index0 ]|raw }}</td>
Příklad přizpůsobení s odkazováním na veřejný web
V Generátoru aktivujte tlačítko Open URL při vytváření vašeho READ seznamu.
Tím se přidá ikona odkazu ke každému záznamu vašeho seznamu v administrátorském panelu.
Odkaz směřuje na kořen domény, chceme tento odkaz změnit tak, aby vedl na příslušné stránky každého záznamu na veřejném webu. Zde je návod, jak toho dosáhnout.
Vezměme si jako příklad tabulku actor , řekněme, že každý záznam musí otevřít stránku https://www.my-website.com/actor-x.php, kde x je index.
- Otevřete admin/templates/actor.html ve vašem editoru kódu.
- Najděte odkaz open url v šabloně, který by měl vypadat takto:
<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>
- Tento odkaz vás prozatím povede na domovskou stránku. Aby směřoval na stránku herce, musíte upravit URL (href) a přidat index aktuálního záznamu:
<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>
Zde používáme primární klíč: {{ object.pk[loop.index0] }}.
Pochází z objektu Actor v souboru admin/class/crud/Actor.php, který byl předán do šablony TWIG.
Jak zachovat své změny, pokud znovu vygenerujete své datové tabulky?
Po provedení změn v administračních souborech generovaných nástrojem PHPGC, pokud znovu vygenerujete svůj READ List, budou tyto změny přepsány.
Automatická záloha administračních souborů
Abyste předešli ztrátě dat:
Když generujete soubory administrace, stávající soubory se uloží do záložní složky generátoru: /generator/backup-files/
Nástroj pro porovnání souborů
Ta Nástroj pro porovnání generátoru vám umožňuje:
- porovnat uložené verze s nově vygenerovanými verzemi
- sloučit obě dostupné verze výběrem částí kódu, které chcete zachovat, v levém/pravém panelu.