Necesitamos rediseñar el ExportManager para que cumpla las siguientes funciones:
- Poder añadir clases para modelos concretos. Por ejemplo, un programador puede necesitar que cuando se imprima un producto, se imprima de cierta manera, para ello podría crearse su clase de impresión de productos y decirle al ExportManager que use esta nueva clase cada vez que haya que imprimir un producto.
- 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
Para ofrecer compatibilidad podemos marcar la clase ExportManager como deprecated y crear otra (Exporter) para reemplazarla:
- La nueva clase iría directamente en la carpeta Core, dado su uso habitual.
- Las implementaciones para PDF, Excel y CSV irían en la carpeta Bridge.
- La interfaz o contrato a implementar por las clases iría en la carpeta Contract.
// devuelve el contenido del pdf de una factura
return Exporter::create('pdf')
->addModel($factura)
->output();
// genera y guarda en pdf una factura
Exporter::create('pdf')
->addModel($factura)
->save('factura_1230');
// devuelve un pdf con dos tablas de datos que tenemos en dos arrays, un texto y una imagen
return Exporter::create('pdf')
->addTable($data1)
->addTable($data2)
->newPage()
->addText('bla, bla, bla..')
->addImage($imagePath)
->output();
// genera la factura en inglés
Exporter::create('pdf')
->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 Exporter, para poder reemplazar algunas llamadas o ejecutar código tras ciertas llamadas.
Exporter::addMod(new MyCustomExporterMod());
Exporter::create('pdf')
->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.
Exporter::create('pdf')
->disableHeader()
->disableFooter()
->addText('bla, bla, bla..')
->addTable($data1)
->output();Nuevo diseño de factura
Asignado neorazorx_1
España, 10 años, nivel 100
Fecha de inicio: 11-11-2023, Puntos de soporte +25
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?) |