Backend y secciones
La pieza del framework que más tiempo ahorra: tablas y formularios generados desde la base de datos. Una sección de administración completa — listado, búsqueda, ordenación, paginación, formulario de edición, detalles relacionados — son dos archivos PHP declarativos.
1. Cómo se enruta
/restricted/<seccion>
└─ regla en conf/modules/auth/routing_table.xml (perfiles: admin, data-entry)
└─ conf/gallery/manage/<seccion>/index.php → listado (ffGrid)
conf/gallery/manage/<seccion>/modify.php → ficha (ffRecord)
La autenticación es una sola regla que protege todo lo que está debajo: los controladores no deben volver a comprobar el acceso, solo los permisos finos (ver 08 §4).
Las subsecciones son subcarpetas: manage/tags/categories/{index,modify}.php → /restricted/tags/categories.
2. Las secciones presentes
| Sección | Gestiona |
|---|---|
vgallery | los contenidos (nodos, campos, relaciones) |
vgallery-next | la nueva área de contenidos (VGALLERY_NEXT_PIANO.md) |
section, block, static | secciones, bloques de layout, páginas estáticas |
resources | recursos y medios |
tags, place | taxonomías y lugares |
international | el diccionario multilingüe (ff_international) |
themes, js | temas y scripts |
routing | reglas de enrutamiento |
seo | metadatos SEO |
email | plantillas y configuración de email |
notify | notificaciones |
publishing, draft | publicación y borradores |
extras | campos extra |
users, groups | cuentas y grupos |
updater | actualizaciones, modo de mantenimiento y migraciones de la BD (14 §5bis) |
3. ffGrid: el listado
$oGrid = ffGrid::factory($cm->oPage);
$oGrid->full_ajax = true; // paginación/ordenación sin recargar la página
$oGrid->id = "MieVoci";
$oGrid->source_SQL = "SELECT ID, nome, creato_il
FROM mia_tabella
WHERE 1 [AND] [WHERE] [HAVING] [ORDER]";
$oGrid->order_default = "nome";
$oGrid->use_search = true;
$oGrid->record_url = $cm->oPage->site_path . $cm->oPage->page_path . "/modify";
$oGrid->record_id = "MieVociModify";
$oGrid->resources[] = $oGrid->record_id;
$oField = ff_field(...); $oGrid->addSearchField($oField); // filtros
$oField = ff_field(...); $oGrid->addKeyField($oField); // clave (ID)
$oField = ff_field(...); $oGrid->addContent($oField); // columnas
$oGrid->addGridButton($oButton); // acciones masivas
$oGrid->addEvent("on_before_parse_row", "mie_voci_on_before_parse_row");
Los marcadores [AND] [WHERE] [HAVING] [ORDER] en la source_SQL no son decorativos: son los puntos donde la tabla inyecta filtros, búsqueda y ordenación. Sin ellos, búsqueda y ordenación no funcionan y nadie lo dice.
| Propiedad | Para qué sirve |
|---|---|
full_ajax | interacción sin recargar |
use_search | barra de búsqueda construida a partir de los addSearchField |
order_default | ordenación inicial: el id de un campo de la tabla, no un trozo de SQL. "level DESC" da "Cannot determine order field!"; la dirección va en el campo, $oField->order_dir = "DESC" (conf/gallery/manage/groups/index.php) |
record_url / record_id | dónde abre la ficha y con qué id (sirve para los popups) |
resources[] | declara los recursos (JS/CSS/widgets) que cargar |
widget_deps[] | dependencias de widgets del framework |
| eventos | on_before_parse_row, on_before_parse_data, … para decorar filas y celdas |
4. ffRecord: la ficha
$oRecord = ffRecord::factory($cm->oPage);
$oRecord->id = "MieVociModify";
$oRecord->resources[] = $oRecord->id;
$oRecord->src_table = "mia_tabella"; // el formulario conoce la tabla
$oRecord->insert_additional_fields["ID_lang"] = new ffData("1", "Number"); // valores implícitos
$oRecord->addEvent("on_done_action", "mie_voci_on_done_action"); // tras el guardado
$oField = ff_field(...); $oRecord->addKeyField($oField);
$oField = ff_field(...); $oRecord->addContent($oField);
$oRecord->addContent($oDetail, "relazione"); // detalle relacionado (master-detail)
ffRecord genera el formulario, valida, escribe y recarga por sí solo: en un caso sencillo no hay ni una línea de SQL de escritura. Los enganches de aplicación se hacen con los eventos (on_before_action, on_done_action, on_load_data, …), no reescribiendo el guardado.
Ejemplo real con sincronización en una segunda tabla: conf/gallery/manage/users/modify.php (alinea access_users y anagraph).
5. Añadir una sección nueva: receta
mkdir conf/gallery/manage/<seccion>/index.php— laffGrid(copiar de una sección cercana:tagspara el caso sencillo,userspara el caso con sincronización)modify.php— laffRecord- añadir la entrada al menú del backend (
library/gallery/process/admin_menu.phpy la configuración del módulorestricted) - si hace falta un permiso dedicado: una constante
AREA_<SECCION>_SHOW_*leída conAuth::env() - probar como usuario
data-entry, no solo como admin: es ahí donde se descubren los permisos que faltan
6. La interfaz: qué saber antes de tocarla
- El tema activo es "gallery" (Foundation). El skin de las intervenciones es
themes/admin/css/ff-skin.css. Los widgets HTML los generathemes/responsive/ff/. - El tema base de jQuery UI da 404 por un registro de BD con una ruta equivocada: diálogos, sliders y spinners están estilizados a mano. Es un motivo, no un capricho: volver a poner el tema base cambia el aspecto de todo el backend.
- Los popups son diálogos de jQuery UI con
modal:false: el fondo es.ff-modal, la caja es.ui-dialog.ff-modal-dialog. El contenido llega vía AJAX como fragmento con solo.ffRecord(ningún#frmMain).Consecuencia: los hooks JS y las reglas CSS deben ser delegados (
jQuery(document).on("click", ".tabs A", …)) y limitados a.ffRecord. Un handler inline nunca engancha el contenido de un diálogo. - La
dialogClassdebe limpiarse de los tokens puramente visuales: el wrapper del diálogo heredaba la clasehiddendel botón que lo abre, y el diálogo nacía invisible. - Admin toolbar (barra de edición en hover en el front-end): oculta por defecto (
ADMIN_TOOLBAR_HIDDEN = trueenconf/gallery/config.php); se reactiva definiéndolafalseen elconfig.remote.phpdel proyecto. El contenido llega del bus de servicios, entradaadmin(ver 03 §3). - Verificación de la interfaz sin login: un mock HTML que enlaza los CSS reales más el DOM del componente, y capturas con Chrome headless. Para los diálogos hace falta un ancho en px inline en
.ui-dialog-content.
El histórico de las intervenciones en el backend está en FIX_FUNZIONAMENTO.md (comportamiento) y MIGLIORIE_ESTETICHE.md (solo CSS/UI). Las intervenciones CSS se marcan con /* INTERVENTO CSS - GP AAAA-MM */.
7. El resto del backend
Además de manage/, conf/gallery/ contiene áreas funcionales heredadas del upstream:
| Carpeta | Área |
|---|---|
api/ | REST interna (04) |
backup/, import/, updater/, checker/ | mantenimiento, importación/exportación, actualización, verificaciones |
job/ | jobs de sistema (05 §3) |
install/ | instalador legacy: en un sitio instalado solo se abre desde /admin/configuration/install (tras el login); la /install pública responde 404 (ver 01 §2) |
mc/ | mail center |
modules/ | módulos funcionales (10) |
search/ | búsqueda |
services/ | servicios de terceros (10 §3) |
sitemap/ | sitemap legacy (JoeCMS usa modules/cms-common/models/Sitemap.php) |
sys/ | servicios de sistema y bus (03 §3) |