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.

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.

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

Añadir columnas a la cabecera

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'];
}

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)
    {
        // TODO: Implement apply() method.
    }

    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

Añadir columnas al pié de página

Modificar los cálculos