Formularios de edición de facturas, albaranes, etc

Los formularios de edición de facturas, albaranes, pedidos y presupuestos son respectivamente PurchaseController o SalesController, en función de si son de compras o ventas:

  • Los formularios de compras heredan de la clase PurchaseController.
  • Los formularios de venta heredan de la clase SalesController.

Los metodos de las clases se implementarán del mismo modo ya sean documentos de venta o compra, en este ejemplo elegiremos documento de venta.

Añadir columnas a la cabecera o pie

Debemos crear una clase que extienda de una de estas dos clases, ya sea para documentos de venta o de compras:

  • FacturaScripts\Core\Base\Contract\SalesModInterface
  • FacturaScripts\Core\Base\Contract\PurchasesModInterface

Por convención se llamará SalesHeaderHTMLMod o PurchasesHeaderHTMLMod y se ubicará en el directorio Mod.

Para añadir una columna a la cabecera, registraremos un nuevo campo e implementaremos el html de ese input:

public function newFields(): array
{
    return ['pruebaNewFields'];
}

public function renderField(Translator $i18n, SalesDocument $model, string $field): ?string
{
    if ($field == 'pruebaNewFields') {
        return static::pruebaNewFields($i18n, $model);
    }

    return null;
}

private static function pruebaNewFields(Translator $i18n, SalesDocument $model): string
{
    $html = '<div class="col-sm"><div class="form-group">';
    $html .= 'pruebaNewFields<input class="form-control" type="text" name="pruebaNewFields" placeholder="opcional" value="">';
    $html .= '</div></div>';

    return $html;
}

Para añadir una columna al modal "Detalle", registraremos un nuevo campo e implementaremos el html de ese input:

public function newModalFields(): array
{
    return ['pruebaNewModalFields'];
}

public function renderField(Translator $i18n, SalesDocument $model, string $field): ?string
{
    if ($field == 'pruebaNewModalFields') {
        return static::pruebaNewModalFields($i18n, $model);
    }

    return null;
}

private static function pruebaNewModalFields(Translator $i18n, SalesDocument $model): string
{
    $html = '<div class="col-sm"><div class="form-group">';
    $html .= 'pruebaNewModalFields<input class="form-control border-danger" type="text" name="pruebaNewModalFields" placeholder="opcional" value="">';
    $html .= '</div></div>';

    return $html;
}

Para añadir 'botones' o 'input select' a la cabecera, igualmente debemos registrar el botón como nuevo campo e implementar el html:

public function newBtnFields(): array
{
    return ['pruebaNewBtnFields'];
}

public function renderField(Translator $i18n, SalesDocument $model, string $field): ?string
{
    if ($field == 'pruebaNewBtnFields') {
        return static::pruebaNewBtnFields($i18n, $model);
    }

    return null;
}

private static function pruebaNewBtnFields(Translator $i18n, SalesDocument $model): string
{
    $html = '<div class="col-sm-auto"><div class="form-group">';
    $html .= '<button type="button" class="btn btn-danger">pruebaNewBtnFields</button>';
    $html .= '</div></div>';

    return $html;
}

En los metodos newFields(), newModalFields(), newBtnFields() se podrá retornar varios campos a renderizar, por ejemplo:

public function newFields(): array
{
    return ['campo1', 'campo2'];
}

En los métodos apply() y applyBefore(), obtendriamos los datos de los nuevamos campos que hemos añadido para poder guardarlos en nuestro modelo.

public function apply(SalesDocument &$model, array $formData, User $user)
{
    $model->pruebaNewFields = $formData['pruebaNewFields'];
    $model->pruebaNewModalFields = $formData['pruebaNewModalFields'];
}

El código completo de esta clase de ejemplo sería el siguiente:

class SalesHeaderHTMLMod implements SalesModInterface
{

    public function apply(SalesDocument &$model, array $formData, User $user)
    {
        $model->pruebaNewFields = $formData['pruebaNewFields'];
                $model->pruebaNewModalFields = $formData['pruebaNewModalFields'];
    }

    public function applyBefore(SalesDocument &$model, array $formData, User $user)
    {
        // TODO: Implement applyBefore() method.
    }

    public function assets(): void
    {
        // TODO: Implement assets() method.
    }

    public function newFields(): array
    {
        return ['pruebaNewFields'];
    }

    public function newModalFields(): array
    {
        return ['pruebaNewModalFields'];
    }

    public function newBtnFields(): array
    {
        return ['pruebaNewBtnFields'];
    }

    public function renderField(Translator $i18n, SalesDocument $model, string $field): ?string
    {
        if ($field == 'pruebaNewFields') {
            return static::pruebaNewFields($i18n, $model);
        }

        if ($field == 'pruebaNewModalFields') {
            return static::pruebaNewModalFields($i18n, $model);
        }

        if ($field == 'pruebaNewBtnFields') {
            return static::pruebaNewBtnFields($i18n, $model);
        }

        return null;
    }

    private static function pruebaNewFields(Translator $i18n, SalesDocument $model): string
    {
        $html = '<div class="col-sm"><div class="form-group">';
        $html .= 'pruebaNewFields<input class="form-control border-danger" type="text" name="pruebaNewFields" placeholder="opcional" value="">';
        $html .= '</div></div>';

        return $html;
    }

    private static function pruebaNewModalFields(Translator $i18n, SalesDocument $model): string
    {
        $html = '<div class="col-sm"><div class="form-group">';
        $html .= 'pruebaNewModalFields<input class="form-control border-danger" type="text" name="pruebaNewModalFields" placeholder="opcional" value="">';
        $html .= '</div></div>';

        return $html;
    }

    private static function pruebaNewBtnFields(Translator $i18n, SalesDocument $model): string
    {
        $html = '<div class="col-sm-auto"><div class="form-group">';
        $html .= '<button type="button" class="btn btn-danger">pruebaNewBtnFields</button>';
        $html .= '</div></div>';

        return $html;
    }
}

Añadir columnas a las líneas

Debemos crear una clase que extienda de una de estas dos clases, ya sea para documentos de venta o de compras:

  • FacturaScripts\Core\Base\Contract\SalesLineModInterface
  • FacturaScripts\Core\Base\Contract\PurchasesLineModInterface

Por convención se llamará SalesLineHTMLMod o PurchasesLineHTMLMod y se ubicará en el directorio Mod.

Para añadir una columna a la línea, registraremos un nuevo campo e implementaremos el html de ese input:

public function newFields(): array
{
    return ['pruebaNewFields'];
}

public function newTitles(): array
{
    return ['pruebaNewFields'];
}

public function renderField(Translator $i18n, string $idlinea, SalesDocumentLine $line, SalesDocument $model, string $field): ?string
{
    if ($field == 'pruebaNewFields') {
        return static::pruebaNewFields($i18n, $idlinea, $line, $model);
    }

    return null;
}

public function renderTitle(Translator $i18n, SalesDocument $model, string $field): ?string
{
    if ($field == 'pruebaNewFields') {
        return static::pruebaNewFieldsTitle($i18n);
    }

    return null;
}

private static function pruebaNewFields(Translator $i18n, string $idlinea, SalesDocumentLine $line, SalesDocument $model): string
{
    $html = '<div class="col-sm col-lg-1 order-2">';
        $html .= '<div class="d-lg-none mt-3 small">Prueba</div>';
    $html .= '<input class="form-control" type="text" name="pruebaNewFields_' . $idlinea . '" value="' . $line->pruebaNewFields . '">';
    $html .= '</div>';

    return $html;
}

private function pruebaNewFieldsTitle(Translator $i18n): string
{
        return '<div class="col-lg-1 order-2">Prueba</div>';
}

Nota: Podemos decidir en que orden aparece la columna con la clase order-1, order-2, order-3, hasta llegar a order-12. Debemos colocar tanto al renderiar la columna como en el título de la columna.

Para añadir una columna al modal de la línea "...", registraremos un nuevo campo e implementaremos el html de ese input:

public function newModalFields(): array
{
    return ['pruebaNewModalFields'];
}

public function renderField(Translator $i18n, SalesDocument $model, string $field): ?string
{
    if ($field == 'pruebaNewModalFields') {
        return static::pruebaNewModalFields($i18n, $idlinea, $line, $model);
    }

    return null;
}

private static function pruebaNewModalFields(Translator $i18n, string $idlinea, SalesDocumentLine $line, SalesDocument $model): string
{
    $html = '<div class="col-6"><div class="mb-2">';
    $html .= 'pruebaNewModalFields<input class="form-control border-danger" type="text" name="pruebaNewModalFields_' . $idlinea . '" value="' . $line->pruebaNewModalFields . '">';
    $html .= '</div></div>';

    return $html;
}

Con la función map() podemos conseguir que se actualicen los datos de una columna en especial al editar la línea, sin perder el foco del cursor de la misma línea.

public function map(array $lines, SalesDocument $model): array
{
    $map = [];
    $num = 0;
    foreach ($lines as $line) {
        $num++;
        $idlinea = $line->idlinea ?? 'n' . $num;
        $map['pruebaNewFields_' . $idlinea] = 'aquí hacemos nuestro cálculo';
    }
    return $map;
}

En los métodos apply() y applyToLine(), obtendriamos los datos de los nuevamos campos que hemos añadido para poder guardarlos en nuestro modelo.

public function applyToLine(array $formData, SalesDocumentLine &$line, string $id)
{
    $line->alto = $formData['pruebaNewFields_' . $id];
    $line->alto = $formData['pruebaNewModalFields_' . $id];
}

El código completo de esta clase de ejemplo sería el siguiente:

class SalesLineMod implements SalesLineModInterface
{

    public function apply(SalesDocument &$model, array &$lines, array $formData)
        {
        }

        public function applyToLine(array $formData, SalesDocumentLine &$line, string $id)
        {
            $line->alto = $formData['pruebaNewFields_' . $id];
            $line->alto = $formData['pruebaNewModalFields_' . $id];
        }

        public function assets(): void
        {
            // TODO: Implement assets() method.
        }

        public function getFastLine(SalesDocument $model, array $formData): ?SalesDocumentLine
        {
            return null;
        }

        public function map(array $lines, SalesDocument $model): array
        {
            $map = [];
            $num = 0;
            foreach ($lines as $line) {
                $num++;
                $idlinea = $line->idlinea ?? 'n' . $num;
                $map['pruebaNewFields_' . $idlinea] = 'aquí hacemos nuestro cálculo';
            }
        return $map;
    }

    public function newFields(): array
        {
            return ['pruebaNewFields'];
        }

    public function newModalFields(): array
        {
            return ['pruebaNewModalFields'];
        }

    public function renderField(Translator $i18n, SalesDocument $model, string $field): ?string
        {
            if ($field == 'pruebaNewFields') {
            return static::pruebaNewFields($i18n, $model);
        }

        if ($field == 'pruebaNewModalFields') {
            return static::pruebaNewModalFields($i18n, $model);
        }

        return null;
    }

    public function renderTitle(Translator $i18n, SalesDocument $model, string $field): ?string
    {
        if ($field == 'pruebaNewFields') {
            return static::pruebaNewFieldsTitle($i18n);
        }

        return null;
    }

    private static function pruebaNewFields(Translator $i18n, string $idlinea, SalesDocumentLine $line, SalesDocument $model): string
    {
        $html = '<div class="col-sm col-lg-1 order-2">';
        $html .= '<div class="d-lg-none mt-3 small">Prueba</div>';
        $html .= '<input class="form-control" type="text" name="pruebaNewFields_' . $idlinea . '" value="' . $line->pruebaNewFields . '">';
        $html .= '</div>';
        return $html;
    }

    private function pruebaNewFieldsTitle(Translator $i18n): string
    {
        return '<div class="col-lg-1 order-2">Prueba</div>';
    }

    private static function pruebaNewModalFields(Translator $i18n, string $idlinea, SalesDocumentLine $line, SalesDocument $model): string
    {
        $html = '<div class="col-6"><div class="mb-2">';
        $html .= 'pruebaNewModalFields<input class="form-control border-danger" type="text" name="pruebaNewModalFields_' . $idlinea . '" value="' . $line->pruebaNewModalFields . '">';
        $html .= '</div></div>';
        return $html;
    }
}

Modificar los cálculos

Debemos crear una clase que extienda de CalculatorModInterface, ya sea para compras o ventas.

  • FacturaScripts\Core\Base\Contract\CalculatorModInterface

Por convención se llamará CalculatorMod y se ubicará en el directorio Mod.

Podemos editar o recalcular datos al momento de calcular los totales del documento, ya sea para compras y ventas, o solo para uno de ellos.

Recalcular el total del documento

public function calculate(BusinessDocument &$doc, array &$lines): bool
{
    $doc->total = 'aquí tu cáclulo';
    return true;
}

Recalcular líneas

public function calculateLine(BusinessDocument $doc, BusinessDocumentLine &$line): bool
{
    $line->total = 'aquí tu cáclulo';
    return true;
}

Inicializar registros

public function clear(BusinessDocument &$doc, array &$lines): bool
{
    $doc->total = 0.0;

    foreach ($lines as $line) {
        $line->total = 0.0;
    }

    return true;
}

Archivo Init

Todos los archivos añadidos al Mod de los docuementos, ya sean de compra o venta, se deben añadir al archivo init para cargalos en la ejecución.

use FacturaScripts\Core\Base\AjaxForms\PurchasesHeaderHTML;
use FacturaScripts\Core\Base\AjaxForms\PurchasesLineHTML;
use FacturaScripts\Core\Base\AjaxForms\PurchasesFooterHTML;
use FacturaScripts\Core\Base\AjaxForms\SalesHeaderHTML;
use FacturaScripts\Core\Base\AjaxForms\SalesLineHTML;
use FacturaScripts\Core\Base\AjaxForms\SalesFooterHTML;
use FacturaScripts\Core\Base\Calculator;

public function init()
{
    PurchasesHeaderHTML::addMod(new Mod\PurchasesHeaderMod());
    PurchasesLineHTML::addMod(new Mod\PurchasesLineMod());
    PurchasesFooterHTML::addMod(new Mod\PurchasesFooterMod());
    SalesHeaderHTML::addMod(new Mod\SalesHeaderMod());
    SalesLineHTML::addMod(new Mod\SalesLineMod());
    SalesFooterHTML::addMod(new Mod\SalesFooterMod());
    Calculator::addMod(new Mod\CalculatorMod());
}

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

Iniciar sesión
PRO
neorazorx_1
neorazorx_1

España, 11 años, nivel 100

Los controladores

Patrocinadores

FacturaScripts avanza más rápido gracias al apoyo financiero de los patrocinadores, que contribuyen a que podamos dedicar más tiempo al desarrollo, testeo y documentación. Usted también puede poner su granito de arena y convertirse en patrocinador ;-)

ORO
elurk_3992
ORO
manel_11440
ORO
soporte.fs_10883
ORO
aliksi_1525
ORO
roberto_1699
ORO
decontado_22161
PLATA
rexmaris_12857
PLATA
acaselles_13670
PLATA
atimicroson_10546
PLATA
oguimera_10015
PLATA
jlgonzalezdiaz_12316
PLATA
v.delgado_14821
PLATA
luis_12743
PLATA
vicente.villar.elizondo_22278
PLATA
raljopa_851
PLATA
creabolsas_22110
PLATA
danyarranz_14804
BRONCE
silentgrowonline_19393
BRONCE
abanpinde.sl_22536
PRO
neorazorx_1
PRO
jmoreno_2610
PRO
mariano_6807
PRO
smartcuines_1378
Patrocinar

Amplíe sus conocimientos con los cursos oficiales

Curso básico de PHP

¡Aprende a programar en PHP de manera fácil y divertida con nuestro curso básico! En este curso, te enseñaremos los conceptos fundamentales de la programación en PHP, incluyendo la sintaxis básica, el manejo de variables, estructuras de control de flujo y mucho más. Al terminar estarás listo para comenzar con el curso de creación de plugins para FacturaScripts.

28 9,99 €
Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts: 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 o que ya han completado el curso de PHP. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

355 9,99 €
Sesiones de programación

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts 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? 22 lecciones con 22 vídeos explicativos (más de 11 horas de vídeos) y el código fuente de los ejemplos.

129 19,99 €
Cookies
Usamos cookies en nuestro sitio web para brindarte la experiencia más relevante recordando tus preferencias y visitas repetidas. Al hacer clic en "Aceptar", aceptas el uso de TODAS las cookies necesarias.
Copyright (c) 2013-2024 FacturaScripts
0.31611s

Soporte