Crear una plantilla personalizada

Podemos crear una plantilla personalizada creando un plugin y colocando la nueva plantilla en la carpeta Lib/PlantillasPDF del nuevo plugin.

Requisitos

Las plantillas son código PHP y para realizar este tipo de personalización son necesarios unos mínimos conocimientos de PHP. También es recomendable, aunque no imprescindible, realizar el curso básico de programación.

Proceso

  • Creamos un nuevo plugin, por ejemplo MiPlantilla. No olvides el archivo facturascripts.ini
  • Creamos la carpeta Lib dentro de nuestro nuevo plugin.
  • Creamos a su vez la carpeta PlantillasPDF dentro de la carpeta Lib.
  • Creamos un archivo MiPlantilla.php dentro de la carpeta Lib/PlantillasPDF de nuestro nuevo plugin.

Abrimos este nuevo archivo y copiamos este contenido:

<?php
namespace FacturaScripts\Plugins\MiPlantilla\Lib\PlantillasPDF;

class MiPlantilla extends \FacturaScripts\Plugins\PlantillasPDF\Lib\PlantillasPDF\Template1
{
    /// $model es la factura
    public function addInvoiceHeader($model)
    {
        parent::addInvoiceHeader($model);
        $html = 'hola mundo 1';
        $this->writeHTML($html);
    }

    /// $model es la factura
    public function addInvoiceLines($model)
    {
        parent::addInvoiceLines($model);
        $html = 'hola mundo 2';
        $this->writeHTML($html);
    }

    /// $model es la factura
    protected function getInvoiceTotals($model): string
    {
        $html = getInvoiceTotals($model);
        $html .= 'hola mundo 3';
        return $html;
    }

    /// $model es la factura
    public function addInvoiceFooter($model)
    {
        parent::addInvoiceFooter($model);
        $html = 'hola mundo 4';
        $this->writeHTML($html);
    }
}

A continuación vamos al menú administrador > panel de control > plugins, y activamos nuestro nuevo plugin. Una vez activado podemos ir al menú administrador > plantillas PDF y ya podremos seleccionar nuestra nueva plantilla desde el selector de plantilla.

¿Qué podemos personalizar?

Podemos sobreescribir la función addInvoiceHeader() si queremos modificar la cabecera, la función addInvoiceLines() para las líneas o la función addInvoiceFooter() para la parte de abajo.

Problemas frecuentes

Le insistimos en que las modificaciones deben ir en nuevos plugins. Si hace las modificaciones directamente sobre los archivos de PlantillasPDF, estas modificaciones se perderán cuando actualice.


 

Necesita identificarse para continuar con esta acción. Haga clic en iniciar sesión o cree una cuenta.

Iniciar sesión

Índice

neorazorx_1
neorazorx_1
4676 Puntos 8 años
Fecha de creación 28-05-2020 00:00:00
Última actualización 29-05-2021
Contador de visitas 829
PlantillasPDF
PlantillasPDF

Permite configurar o personalizar los diseños PDF de facturas, albaranes, pedidos y presupuestos. Con este plugin podemos elegir entre cuatro plantillas prediseñadas. Y para cada una de estas plantillas podemos configurar: - Tamaño del papel: A3, A4, A5, legal o letter. - Orientación: vertical u...

Curso básico de usuario

Con este curso aprenderá a gestionar el día a día de su negocio con FacturaScripts 2021: hacer facturas, albaranes, pedidos y presupuestos. Gestionar clientes, proveedores y tarifas. Y a realizar la regularización de impuestos (trimestre de IVA). ¿A quién va dirigido? A cualquier usuario que ya tenga FacturaScripts instalado en su PC o hosting y quiera aprender rápidamente el manejo diario del programa. ¿Qué incluye? 18 lecciones con 17 vídeos explicativos.

212 4,99 €
Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts 2021: añadir nuevas páginas, tablas y columnas. Para entender este curso no se necesita mucha experiencia en programación, le enseñaremos los básico para modelar problemas sencillos. ¿A quién va dirigido? A cualquier persona con unos conocimientos muy básicos de programación. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

212 8,99 €
Sesiones de programación 2021

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts 2021 y sus plugins. Perfecto para expandir tus conocimientos de programación. ¿A quién va dirigido? A personas que ya hayan superado el curso básico de programación y busquen ampliar sus conocimientos. ¿Qué incluye? 9 lecciones con 9 vídeos explicativos (más de 5 horas de vídeos) y el código fuente de los ejemplos. Novedades mensuales: Este curso se amplía cada mes con nuevas lecciones.

33 14,99 €

Copyright (c) 2013-2021 FacturaScripts