La clase ExportManager, que combina la generación de PDF, CSV y Excel fue una mala idea. Estos formatos son demasiando diferentes como para unificarlos. En su lugar se deben crear clases independientes para cada uno.
Necesitamos una nueva clase ExportPDF que permita:
- Poder añadir extensiones para modelos concretos. Por ejemplo, un programador puede necesitar que cuando se imprima un producto, se imprima de cierta manera, para ello podría añadir una extensión en su plugin.
- Poder saltar de página con
newPage(). - Poder guardar el resultado en un archivo.
- Poder añadir fragmentos o secciones nuevas cuando se imprime un modelo.
- Poder añadir imágenes con
addImage(). - Poder añadir tecto con
addText(). - Poder establecer el idioma con
setLang(). - Poder establecer la orientación con
setOrientation(). - Poder establecer el tamaño con
setSize(). - Poder establecer la empresa con
setComany(). - Poder establecer cualquier otro dato genérico con
setData($key, $value).
Nueva versión
La nueva clase iría en la carpeta Core/Lib, dado su uso habitual. La interfaz o contrato a implementar por las clases iría en la carpeta Core/Contract.
// devuelve el contenido del pdf de una factura
return ExportPDF::create()
->addModel($factura)
->output();
// genera y guarda en pdf una factura
ExportPDF::create()
->addModel($factura)
->save('factura_1230');
// devuelve un pdf con dos tablas de datos que tenemos en dos arrays, un texto y una imagen
return ExportPDF::create()
->addTable($data1)
->addTable($data2)
->newPage()
->addText('bla, bla, bla..')
->addImage($imagePath)
->output();
// genera la factura en inglés
ExportPDF::create()
->setLang('en_EN')
->addModel($factura)
->save('factura_1230');Sin envío de emails
Creo que fue un error mezclar el envío de emails con la exportación, de la forma en que lo hicimos, es decir, poniendo email como una opción de exportación. El envío de emails debería ser un botón independiente en los formularios y no una opción de exportación.
Sin embargo, si que necesitamos una herramienta potente para el envío de emails que cubra nuestras necesidades. Más detalles.
Personalizar la exportación de un modelo
Del mismo modo que hacemos con la clase Calculator y con los AjaxForms, deberíamos poder añadir mods al ExportPDF, para poder reemplazar algunas llamadas o ejecutar código tras ciertas llamadas.
ExportPDF::addMod(new MyCustomExportPDFMod());
ExportPDF::create()
->addModel($fproduct)
->save('producto_1230');Personalizaciones posibles:
- Plantillas distintas para cada tipo de documento.
- Plantillas distintas para cada serie.
- Plantillas distintas para cada empresa.
- Plantillas distintas para algunos clientes o grupos de clientes.
- Personalizar la cabecera.
- Personalizar el pié de página.
- Personalizar la impresión de modelos concretos.
- Adjuntar una página personalizada junto a cada presupuesto.
- Añadir una sección tras la cabecera de la factura.
- Añadir una sección tras los datos del cliente de la factura.
- Añadir una sección tras las líneas de la factura.
- Añadir una sección tras los totales de la factura.
- Añadir una marca de agua.
Poder desactivar cabecera o pié de página
Necesitamos poder desactivar, en algunos casos, la cabecera o el pié de página.
ExportPDF::create()
->disableHeader()
->disableFooter()
->addText('bla, bla, bla..')
->addTable($data1)
->output();Nuevo diseño de factura
Pendiente Dificultad: Media
Esta tarea fue aprobada el 11-11-2023 y está pendiente para comenzar el desarrollo el 21-11-2024.
3 Comentarios
|
08-11-2023 13:02:28 daniel89fg_739 Poder establecer un diseño de plantilla diferente para la empresa, tipo de documento, proveedor o cliente. |
|
08-11-2023 14:17:09 estrategicos_11919 Poder establecer un diseño distinto para cada Serie de Facturacion, a veces una empresa tiene diferentes marcas.(SERIES). Veo que esta dentro de las personalizaciones posibles.No se si es una locura pero yo propongo: establecer un parámetro genérico como el de ->addText() para poder incluir datos que vengan de un plugin o personalizacion, de forma que si personalizamos el footer de una factura o extendemos un cliente con un dato específico podamos establecer la impresion de ese dato como si de una variable general se tratara. (Mierda nos pisariamos unos a otros?) |
|
|
29-02-2024 12:01:03 daniel89fg_739 Podría ser interesante dejar añadir una cabecera o pie de página diferente para cada página. Por ejemplo la página 1 no tiene cabecera ni footer, pero el resto de páginas si, e incluso que cada página pueda ser diferente, o viceversa. |