Ir al contenido
JoeCMS Descargar 3.1.5
Manual · 09

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ónGestiona
vgallerylos contenidos (nodos, campos, relaciones)
vgallery-nextla nueva área de contenidos (VGALLERY_NEXT_PIANO.md)
section, block, staticsecciones, bloques de layout, páginas estáticas
resourcesrecursos y medios
tags, placetaxonomías y lugares
internationalel diccionario multilingüe (ff_international)
themes, jstemas y scripts
routingreglas de enrutamiento
seometadatos SEO
emailplantillas y configuración de email
notifynotificaciones
publishing, draftpublicación y borradores
extrascampos extra
users, groupscuentas y grupos
updateractualizaciones, 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.

PropiedadPara qué sirve
full_ajaxinteracción sin recargar
use_searchbarra de búsqueda construida a partir de los addSearchField
order_defaultordenació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_iddó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
eventoson_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

  1. mkdir conf/gallery/manage/<seccion>/
  2. index.php — la ffGrid (copiar de una sección cercana: tags para el caso sencillo, users para el caso con sincronización)
  3. modify.php — la ffRecord
  4. añadir la entrada al menú del backend (library/gallery/process/admin_menu.php y la configuración del módulo restricted)
  5. si hace falta un permiso dedicado: una constante AREA_<SECCION>_SHOW_* leída con Auth::env()
  6. 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 genera themes/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 dialogClass debe limpiarse de los tokens puramente visuales: el wrapper del diálogo heredaba la clase hidden del 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 = true en conf/gallery/config.php); se reactiva definiéndola false en el config.remote.php del proyecto. El contenido llega del bus de servicios, entrada admin (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)