From 7790062503931803d5c97ee5241b4016af0d1e16 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Esteban=20S=C3=A1nchez?= Date: Thu, 16 Jul 2026 13:41:51 +0200 Subject: [PATCH 1/2] =?UTF-8?q?Mejora=20de=20documentaci=C3=B3n=20en=20Tic?= =?UTF-8?q?ket=20y=20TicketPrinter?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Se han actualizado los comentarios de las propiedades en las clases Ticket y TicketPrinter para proporcionar descripciones más claras sobre su propósito y uso. Esto incluye la adición de detalles sobre el tipo de datos y la funcionalidad de cada propiedad. Archivos modificados: - Ticket.php - TicketPrinter.php --- Model/Ticket.php | 22 +++++++-------- Model/TicketPrinter.php | 60 ++++++++++++++++++++--------------------- 2 files changed, 41 insertions(+), 41 deletions(-) diff --git a/Model/Ticket.php b/Model/Ticket.php index ad1ed8f..77799a4 100644 --- a/Model/Ticket.php +++ b/Model/Ticket.php @@ -17,37 +17,37 @@ class Ticket extends ModelClass { use ModelTrait; - /** @var float */ + /** Versión de la app que ha generado el ticket. @var float */ public $appversion; - /** @var bool */ + /** Indica si el cuerpo del ticket viene codificado en base64. @var bool */ public $base64; - /** @var string */ + /** Contenido del ticket a imprimir. @var string */ public $body; - /** @var string */ + /** Código del agente que ha generado el ticket. @var string */ public $codagente; - /** @var string */ + /** Fecha y hora de creación del ticket. @var string */ public $creationdate; - /** @var int */ + /** Identificador del ticket. @var int */ public $id; - /** @var int */ + /** Identificador de la impresora asociada al ticket. @var int */ public $idprinter; - /** @var string */ + /** Nick del usuario que ha generado el ticket. @var string */ public $nick; - /** @var int */ + /** Segundos transcurridos hasta que el ticket se ha impreso. @var int */ public $printdelay; - /** @var bool */ + /** Indica si el ticket ya se ha impreso. @var bool */ public $printed; - /** @var string */ + /** Título del ticket. @var string */ public $title; public function clear(): void diff --git a/Model/TicketPrinter.php b/Model/TicketPrinter.php index 10726ba..7e76b1f 100644 --- a/Model/TicketPrinter.php +++ b/Model/TicketPrinter.php @@ -22,94 +22,94 @@ class TicketPrinter extends ModelClass const MAX_INACTIVITY = 600; - /** @var string */ + /** Clave de la API key asociada a la impresora. @var string */ public $apikey; - /** @var string */ + /** Fecha de creación de la impresora. @var string */ public $creationdate; - /** @var int */ + /** Tamaño de fuente del cuerpo del ticket. @var int */ public $font_size; - /** @var string */ + /** Texto del pie del ticket. @var string */ public $footer; - /** @var int */ + /** Tamaño de fuente del pie del ticket. @var int */ public $footer_font_size; - /** @var string */ + /** Texto de la cabecera del ticket. @var string */ public $head; - /** @var int */ + /** Tamaño de fuente de la cabecera del ticket. @var int */ public $head_font_size; - /** @var int */ + /** Identificador de la impresora. @var int */ public $id; - /** @var int */ + /** Identificador de la API key asociada a la impresora. @var int */ public $idapikey; - /** @var string */ + /** Fecha y hora de la última actividad de la impresora. @var string */ public $lastactivity; - /** @var int */ + /** Longitud de línea (número de caracteres) del ticket. @var int */ public $linelen; - /** @var string */ + /** Nombre de la impresora. @var string */ public $name; - /** @var string */ + /** Nick del usuario propietario de la impresora. @var string */ public $nick; - /** @var bool */ + /** Indica si se imprime el nombre corto de la empresa. @var bool */ public $print_comp_shortname; - /** @var bool */ + /** Indica si se imprime el teléfono de la empresa. @var bool */ public $print_comp_tlf; - /** @var bool */ + /** Indica si se imprimen los datos fiscales del cliente. @var bool */ public $print_client_fiscal_data; - /** @var bool */ + /** Indica si se imprimen los recibos de la factura. @var bool */ public $print_invoice_receipts; - /** @var bool */ + /** Indica si se imprime la descripción de las líneas. @var bool */ public $print_lines_description; - /** @var bool */ + /** Indica si se imprime el descuento de las líneas. @var bool */ public $print_lines_discount; - /** @var bool */ + /** Indica si se imprime el neto de las líneas. @var bool */ public $print_lines_net; - /** @var bool */ + /** Indica si se imprime el precio de las líneas. @var bool */ public $print_lines_price; - /** @var bool */ + /** Indica si se imprime el precio con impuestos de las líneas. @var bool */ public $print_lines_price_tax; - /** @var bool */ + /** Indica si se imprime el precio unitario de las líneas. @var bool */ public $print_lines_price_unitary; - /** @var bool */ + /** Indica si se imprime la cantidad de las líneas. @var bool */ public $print_lines_quantity; - /** @var bool */ + /** Indica si se imprime la referencia de las líneas. @var bool */ public $print_lines_reference; - /** @var bool */ + /** Indica si se imprime el total de las líneas. @var bool */ public $print_lines_total; - /** @var bool */ + /** Indica si se imprimen las formas de pago. @var bool */ public $print_payment_methods; - /** @var bool */ + /** Indica si se imprime el logo almacenado de la empresa. @var bool */ public $print_stored_logo; - /** @var bool */ + /** Indica si se imprime la dirección de envío. @var bool */ public $print_shipping_address; - /** @var int */ + /** Tamaño de fuente del título del ticket. @var int */ public $title_font_size; public function clear(): void From 89dc55e4f69e18bda22ed3bed5d2b16ce24abc0c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Esteban=20S=C3=A1nchez?= Date: Mon, 20 Jul 2026 12:23:44 +0200 Subject: [PATCH 2/2] Refactoriza comentarios de propiedades en Ticket.php y TicketPrinter.php MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Mejora la claridad de los comentarios de las propiedades en las clases Ticket y TicketPrinter. - Se ha reordenado la documentación para seguir un formato más consistente. Este cambio no afecta la funcionalidad del código, pero mejora la legibilidad y el mantenimiento del mismo. --- Model/Ticket.php | 22 +++++++-------- Model/TicketPrinter.php | 60 ++++++++++++++++++++--------------------- 2 files changed, 41 insertions(+), 41 deletions(-) diff --git a/Model/Ticket.php b/Model/Ticket.php index 77799a4..a8c4355 100644 --- a/Model/Ticket.php +++ b/Model/Ticket.php @@ -17,37 +17,37 @@ class Ticket extends ModelClass { use ModelTrait; - /** Versión de la app que ha generado el ticket. @var float */ + /** @var float Versión de la app que ha generado el ticket. */ public $appversion; - /** Indica si el cuerpo del ticket viene codificado en base64. @var bool */ + /** @var bool Indica si el cuerpo del ticket viene codificado en base64. */ public $base64; - /** Contenido del ticket a imprimir. @var string */ + /** @var string Contenido del ticket a imprimir. */ public $body; - /** Código del agente que ha generado el ticket. @var string */ + /** @var string Código del agente que ha generado el ticket. */ public $codagente; - /** Fecha y hora de creación del ticket. @var string */ + /** @var string Fecha y hora de creación del ticket. */ public $creationdate; - /** Identificador del ticket. @var int */ + /** @var int Identificador del ticket. */ public $id; - /** Identificador de la impresora asociada al ticket. @var int */ + /** @var int Identificador de la impresora asociada al ticket. */ public $idprinter; - /** Nick del usuario que ha generado el ticket. @var string */ + /** @var string Nick del usuario que ha generado el ticket. */ public $nick; - /** Segundos transcurridos hasta que el ticket se ha impreso. @var int */ + /** @var int Segundos transcurridos hasta que el ticket se ha impreso. */ public $printdelay; - /** Indica si el ticket ya se ha impreso. @var bool */ + /** @var bool Indica si el ticket ya se ha impreso. */ public $printed; - /** Título del ticket. @var string */ + /** @var string Título del ticket. */ public $title; public function clear(): void diff --git a/Model/TicketPrinter.php b/Model/TicketPrinter.php index 7e76b1f..ba0f568 100644 --- a/Model/TicketPrinter.php +++ b/Model/TicketPrinter.php @@ -22,94 +22,94 @@ class TicketPrinter extends ModelClass const MAX_INACTIVITY = 600; - /** Clave de la API key asociada a la impresora. @var string */ + /** @var string Clave de la API key asociada a la impresora. */ public $apikey; - /** Fecha de creación de la impresora. @var string */ + /** @var string Fecha de creación de la impresora. */ public $creationdate; - /** Tamaño de fuente del cuerpo del ticket. @var int */ + /** @var int Tamaño de fuente del cuerpo del ticket. */ public $font_size; - /** Texto del pie del ticket. @var string */ + /** @var string Texto del pie del ticket. */ public $footer; - /** Tamaño de fuente del pie del ticket. @var int */ + /** @var int Tamaño de fuente del pie del ticket. */ public $footer_font_size; - /** Texto de la cabecera del ticket. @var string */ + /** @var string Texto de la cabecera del ticket. */ public $head; - /** Tamaño de fuente de la cabecera del ticket. @var int */ + /** @var int Tamaño de fuente de la cabecera del ticket. */ public $head_font_size; - /** Identificador de la impresora. @var int */ + /** @var int Identificador de la impresora. */ public $id; - /** Identificador de la API key asociada a la impresora. @var int */ + /** @var int Identificador de la API key asociada a la impresora. */ public $idapikey; - /** Fecha y hora de la última actividad de la impresora. @var string */ + /** @var string Fecha y hora de la última actividad de la impresora. */ public $lastactivity; - /** Longitud de línea (número de caracteres) del ticket. @var int */ + /** @var int Longitud de línea (número de caracteres) del ticket. */ public $linelen; - /** Nombre de la impresora. @var string */ + /** @var string Nombre de la impresora. */ public $name; - /** Nick del usuario propietario de la impresora. @var string */ + /** @var string Nick del usuario propietario de la impresora. */ public $nick; - /** Indica si se imprime el nombre corto de la empresa. @var bool */ + /** @var bool Indica si se imprime el nombre corto de la empresa. */ public $print_comp_shortname; - /** Indica si se imprime el teléfono de la empresa. @var bool */ + /** @var bool Indica si se imprime el teléfono de la empresa. */ public $print_comp_tlf; - /** Indica si se imprimen los datos fiscales del cliente. @var bool */ + /** @var bool Indica si se imprimen los datos fiscales del cliente. */ public $print_client_fiscal_data; - /** Indica si se imprimen los recibos de la factura. @var bool */ + /** @var bool Indica si se imprimen los recibos de la factura. */ public $print_invoice_receipts; - /** Indica si se imprime la descripción de las líneas. @var bool */ + /** @var bool Indica si se imprime la descripción de las líneas. */ public $print_lines_description; - /** Indica si se imprime el descuento de las líneas. @var bool */ + /** @var bool Indica si se imprime el descuento de las líneas. */ public $print_lines_discount; - /** Indica si se imprime el neto de las líneas. @var bool */ + /** @var bool Indica si se imprime el neto de las líneas. */ public $print_lines_net; - /** Indica si se imprime el precio de las líneas. @var bool */ + /** @var bool Indica si se imprime el precio de las líneas. */ public $print_lines_price; - /** Indica si se imprime el precio con impuestos de las líneas. @var bool */ + /** @var bool Indica si se imprime el precio con impuestos de las líneas. */ public $print_lines_price_tax; - /** Indica si se imprime el precio unitario de las líneas. @var bool */ + /** @var bool Indica si se imprime el precio unitario de las líneas. */ public $print_lines_price_unitary; - /** Indica si se imprime la cantidad de las líneas. @var bool */ + /** @var bool Indica si se imprime la cantidad de las líneas. */ public $print_lines_quantity; - /** Indica si se imprime la referencia de las líneas. @var bool */ + /** @var bool Indica si se imprime la referencia de las líneas. */ public $print_lines_reference; - /** Indica si se imprime el total de las líneas. @var bool */ + /** @var bool Indica si se imprime el total de las líneas. */ public $print_lines_total; - /** Indica si se imprimen las formas de pago. @var bool */ + /** @var bool Indica si se imprimen las formas de pago. */ public $print_payment_methods; - /** Indica si se imprime el logo almacenado de la empresa. @var bool */ + /** @var bool Indica si se imprime el logo almacenado de la empresa. */ public $print_stored_logo; - /** Indica si se imprime la dirección de envío. @var bool */ + /** @var bool Indica si se imprime la dirección de envío. */ public $print_shipping_address; - /** Tamaño de fuente del título del ticket. @var int */ + /** @var int Tamaño de fuente del título del ticket. */ public $title_font_size; public function clear(): void