Personalización de las tablas de datos de administración de Bootstrap
Guía de personalización de listas de registros

Las tablas de datos de administración de Bootstrap pueden personalizarse mediante su clase PHP principal y su plantilla TWIG disponibles en la admin carpeta.


Organización de los archivos relacionados con las tablas de datos de administración

Cuando creas una tabla de datos desde el Generador CRUD, se generan varios archivos:

/admin/class/crud/Table.php
La clase PHP principal
/admin/templates/table.html
La plantilla TWIG HTML
/admin/crud-data/table-filter-data.json
Los filtros utilizados para filtrar tus registros, si los hay
/admin/crud-data/table-select-data.json
Configuración de los menús desplegables de selección, si los hay

donde table es la tabla que deseas personalizar.

Los dos archivos JSON son utilizados por el motor interno de PHPCG para construir los filtros de tu lista de datos o los datos de selección.
Considéralos archivos privados del CORE y no los modifiques.

Los archivos que nos interesan aquí son la Clase PHP y la Plantilla TWIG HTML.

La clase PHP principal

La clase PHP principal realiza la consulta SQL a tu base de datos y recupera los registros de tu tabla.

También recuperará los registros de las tablas relacionales si deben mostrarse en tu tabla de datos.

Los campos y valores se registran como atributos del objeto, en un bucle que recorre tus registros:

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

Cada $row-> es el valor que se mostrará en la tabla de datos.

Puedes aplicar cualquier función si deseas modificarlos, por ejemplo:

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

La plantilla TWIG HTML

La Plantilla TWIG HTML recupera los valores de la clase PHP principal y construye la tabla de datos HTML.

Puedes editar fácilmente cualquier parte de la plantilla, especialmente los elementos <th></th> y <td></td> de la tabla.

Valores con código HTML

A menudo sucede que se almacena contenido HTML, que se editará por ejemplo con un RTE (TinyMce).

La plantilla TWIG mostrará por defecto las etiquetas HTML, mientras que deseas mostrar el contenido HTML.

Para lograrlo, modificaremos la plantilla TWIG y utilizaremos el filtro TWIG "raw":

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

Ejemplo de personalización con enlace al sitio web público

En el Generador, activa la opción Botón Abrir URL cuando construyas tu lista READ.
Esto añadirá un icono de enlace a cada registro de tu lista en el panel de administración.

El enlace apunta a la raíz del dominio; queremos cambiar este enlace para que lleve a las páginas respectivas de cada uno de los registros en el sitio web público. Aquí te mostramos cómo lograrlo.

Tomemos la tabla actor como ejemplo; digamos que cada registro debe abrir una página https://www.my-website.com/actor-x.php, donde x es el índice.

  1. Abre admin/templates/actor.html en tu editor de código.
  2. Busca el enlace open url en la plantilla, que debería verse así:
    <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. Este enlace te llevará a la página de inicio por el momento. Para que apunte a la página del actor, debes modificar la URL (href) y añadir el índice del registro actual:
    <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>

    Aquí usamos la clave primaria: {{ object.pk[loop.index0] }}.

    Proviene del Actor objeto en admin/class/crud/Actor.php, que ha sido pasado a la plantilla TWIG.

¿Cómo conservar sus cambios si reconstruye sus Tablas de Datos?

Después de realizar cambios en los archivos de administración generados por PHPGC, si regenera su Lista READ, estos cambios serán sobrescritos.

Copia de seguridad automática de los archivos Admin

Para evitar la pérdida de datos:

Cuando genera los archivos del panel de administración, los archivos existentes se guardan en la carpeta de copia de seguridad del generador: /generator/backup-files/

Herramienta de comparación de archivos

La la herramienta de comparación del generador le permite:

  • comparar las versiones guardadas con las nuevas versiones generadas
  • fusionar las dos versiones disponibles seleccionando en los dos paneles izquierdo/derecho las partes del código que desea conservar.

Requisitos previos

Para personalizar las Tablas de Datos Bootstrap Admin con PHPCG debe previamente:

Página principal del tutorial PHP CRUD