En algunos informes, cada registro del dataset necesita varias filas visuales apiladas en lugar de una sola. Por ejemplo, una comparativa de periodos donde cada artículo muestra tres líneas (actual / anterior / diferencia), o una ficha con nombre y código apilados. El atributo...

Algunos elementos de un informe solo tienen sentido en un formato concreto. El número de página, por ejemplo, no tiene utilidad en el visor HTML porque la página web no se divide en páginas físicas. A la inversa, una nota de filtros activos puede ser relevante en pantalla pero...

La etiqueta <config> define la configuración global del informe: el tamaño y orientación de página, la fuente de texto y el grupo por defecto. Es opcional; si se omite, el motor aplica valores por defecto. <config> <page type="A4"...

ExtendedReport es un plugin para FacturaScripts que proporciona el motor necesario para crear informes a medida dentro de otros plugins. Permite generar documentos en PDF, exportarlos en CSV y visualizarlos en pantalla como HTML, todo ello a partir de dos piezas que el...

El widget label es el más utilizado. Muestra cualquier dato de texto: un literal fijo, el valor de un campo del modelo, o un texto traducido al idioma del usuario. <widget type="label" value="..." /> <widget type="label"...

El atributo area de la etiqueta <column> permite marcar determinadas columnas para que el visor HTML las trate de forma especial, sacándolas de la tabla principal y mostrándolas en bloques semánticos propios. En PDF y CSV estos atributos se ignoran por completo: la...

La ruptura de subgrupo permite organizar los datos del informe en bloques, mostrando una cabecera al inicio de cada bloque, sus líneas de detalle y un subtotal al cerrar el bloque. Esto es lo que normalmente se llama un informe con ruptura de secuencia o informe agrupado. 🧩...

El widget default muestra datos de contexto que no provienen de la fila del dataset, sino del entorno de ejecución: datos de la empresa, del usuario logueado, la fecha y hora actuales, el número de página, y cualquier objeto adicional que pases al construir la plantilla....

Un widget es el contenido que se dibuja dentro de una <column>. El atributo type determina qué clase se instancia: el motor concatena Widget + el type con la primera letra en mayúscula. Por ejemplo, type="label" instancia WidgetLabel, type="number"...

La etiqueta <column> define una celda posicionada dentro de una banda. Contiene exactamente un <widget> que determina qué se dibuja en ese espacio. <column posx="20" posy="25" width="200" height="15"> <widget...

Esta guía muestra el camino más corto para crear un informe PDF funcional con ExtendedReport. El ejemplo imprime un listado simple con id, nombre e importe, con un total al pie. Paso 1 — Crear el modelo de datos Crea la clase que obtendrá las filas del informe. Debe extender...

El widget number muestra valores numéricos formateados: separadores de miles y decimales según la configuración global de FacturaScripts, opción de símbolo de divisa, iconos a izquierda y derecha, y color diferente para los valores negativos. Hereda de label, por lo que admite...

El modelo de datos es la pieza PHP que obtiene y prepara las filas que el informe va a representar. ExtendedReport define la clase base abstracta ModelReport, que debes extender en tu plugin para cada informe que crees. 📁 Dónde colocar el modelo Los modelos de informe se...

El widget calculated acumula valores a lo largo del detalle y muestra el resultado en el pie del grupo. Hereda de number, por lo que admite todos sus atributos de formato (decimales, divisa, color para negativos, etc.). <widget type="calculated"...

El diseño del informe se define en un archivo XML que describe qué se muestra, cómo se posiciona y con qué formato. Es el equivalente a los XMLView del core, pero orientado a impresión y a la generación de PDF, CSV y HTML. 📁 Dónde se guarda Los archivos XML de informe se...

Para generar un PDF con ExtendedReport dispones de dos clases: PDFTemplate para control total y PDFReport como atajo para el caso habitual en un controlador. 🖨️ PDFTemplate — control total PDFTemplate es la clase base del motor PDF. Te da control completo sobre cada paso. use...

El widget line dibuja una línea horizontal separadora o, si se le da altura suficiente, un rectángulo (con o sin relleno). Se usa habitualmente para separar visualmente la cabecera del detalle, o el detalle del pie. <widget type="line" /> ⚙️ Atributos...

ExtendedReport incluye dos widgets para insertar imágenes en el informe: image: inserta una imagen cuya ruta se indica directamente.imageproduct: variante de image que localiza automáticamente la imagen de un producto a partir de su referencia. 🖼️ Widget image Inserta una...

Un grupo (<group>) es el contenedor que agrupa las tres bandas de una sección del informe: cabecera, detalle y pie. El atributo name del grupo lo identifica y sirve para emparejarlo con su dataset en el controlador. Un informe puede tener varios grupos, que se renderizan...

CSVTemplate genera un archivo de texto separado por ; con los valores del detalle del informe, reutilizando el mismo diseño XML del PDF. No hay que crear un exportador aparte. ⚙️ Qué exporta y qué no El CSV solo exporta las columnas de la banda detail que tengan un fieldname...

HtmlTemplate renderiza el mismo informe como una tabla HTML responsive en el navegador, usando Bootstrap. Reutiliza el mismo XML y el mismo modelo de datos que el PDF, pero interpreta el diseño de forma semántica en lugar de por coordenadas. 🔄 Cómo interpreta el XML El motor...

Todas las plantillas de render (PDFTemplate, CSVTemplate, HtmlTemplate) aceptan un array de datos adicionales en su constructor. Estos datos son objetos o valores de contexto que no provienen del dataset principal (no son filas del informe), sino del entorno de la llamada:...

Este documento describe la estructura interna del plugin: las clases principales, sus responsabilidades y cómo se relacionan entre sí. Es una referencia para desarrolladores que quieran extender el motor o entender el flujo de render en detalle. 🗂️ Mapa de clases...

El motor de ExtendedReport resuelve el tipo de widget dinámicamente: dado type="mitipo" en el XML, busca la clase WidgetMitipo en el namespace de WidgetReport. Esto significa que añadir un nuevo tipo de widget solo requiere crear una clase PHP; no hay que tocar el...

El método setRenderCfgValue() permite ajustar el comportamiento del motor de render sin tocar el XML ni el modelo. Se llama sobre la instancia de la plantilla después de loadTemplate() y antes de render(). $template->setRenderCfgValue('clave', $valor); ⚙️ Opciones...