Organização dos arquivos relativos às tabelas de dados admin
Quando você cria uma Tabela de Dados a partir do CRUD Generator, vários arquivos são gerados:
- /admin/class/crud/Table.php
- A classe PHP principal
- /admin/templates/table.html
- O template TWIG HTML
- /admin/crud-data/table-filter-data.
- Os filtros usados para filtrar seus registros, se houver
- /admin/crud-data/table-select-data.
- Configuração dos dropdowns de seleção, se houver
onde table é a tabela que você deseja personalizar.
Os dois arquivos JSON são usados pelo motor interno do PHPCG para construir os filtros da sua lista de dados ou os dados de seleção.
Considere-os como arquivos privados do CORE e não os modifique.
Os arquivos que nos interessam aqui são a Classe PHP e o Template TWIG HTML.
A Classe PHP Principal
A Classe PHP Principal executa a consulta SQL no seu banco de dados e recupera os registros da sua tabela.
Ela também recuperará os registros das tabelas relacionais se eles forem exibidos na sua tabela de dados.
Os campos e valores são gravados como atributos do objeto, em um loop que percorre seus registros:
if (!empty($this->records_count)) {
while ($row = $db->fetch()) {
$this->pk[] = $row->$primary_key;
$this->my_field[]= $row->my_field;
// ...
}
}
Cada $row-> é o valor que será exibido na Tabela de Dados.
Você pode aplicar qualquer função se quiser modificá-los, por exemplo:
$this->my_field[]= strtolower($row->my_field); // to lowercase
if (!empty($row->my_field)) {
$this->my_field[]= 'Yes';
} else {
$this->my_field[]= 'No';
}
O Template TWIG HTML
O Template TWIG HTML recupera os valores da Classe PHP Principal e constrói a tabela de dados HTML.
Você pode editar facilmente qualquer parte do template, especialmente os elementos da tabela <th></th> e <td></td> .
Valores com código HTML
É comum que conteúdo HTML seja armazenado, que será editado, por exemplo, com um RTE (TinyMce).
O template TWIG exibirá por padrão as tags HTML, quando você deseja exibir o conteúdo HTML.
Para isso, modificaremos o template TWIG e usaremos o filtro TWIG "raw":
<td>{{ object.last_name[ loop.index0 ]|raw }}</td>
Exemplo de personalização com link para o site público
No Generator, ative a opção Botão Open URL quando você construir sua lista READ.
Isso adicionará um ícone de link a cada registro da sua lista no painel admin.
O link aponta para a raiz do domínio; queremos alterar esse link para que leve às respectivas páginas de cada um dos registros no site público. Veja como fazer isso.
Vamos pegar a tabela actor como exemplo; digamos que cada registro deve abrir uma página https://www.my-website.com/actor-x.php, onde x é o índice.
- Abra admin/templates/actor.html no seu editor de código.
- Encontre o link open url no template, que deve se parecer com isto:
<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>
- Este link levará você à página inicial por enquanto. Para fazê-lo apontar para a página do ator, você precisa modificar a URL (href) e adicionar o índice do registro atual:
<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>
Aqui usamos a chave primária: {{ object.pk[loop.index0] }}.
Ele vem do Actor objeto em admin/class/crud/Actor.php, que foi passado para o template TWIG.
Como manter suas alterações se você reconstruir suas Data Tables?
Depois de fazer alterações nos arquivos de administração gerados pelo PHPGC, se você regenerar sua READ List, essas alterações serão sobrescritas.
Backup automático dos arquivos Admin
Para evitar perda de dados:
Quando você gera os arquivos do painel de administração, os arquivos existentes são salvos na pasta de backup do gerador: /generator/backup-files/
Ferramenta de comparação de arquivos
O ferramenta de comparação do generator permite que você:
- compare as versões salvas com as novas versões geradas
- mescle as duas versões disponíveis selecionando nos dois painéis esquerdo/direito as partes do código que deseja manter.