Module Ultimateqrcode ES: Difference between revisions

Jump to navigation Jump to search

Module Ultimateqrcode ES (view source)

Revision as of 19:42, 29 September 2026

2,594 bytes added ,  1 month ago
no edit summary
VisualWikitext
(Created page with "<!-- BEGIN interlang links --> <!-- Do NOT edit this section Links below are automatically managed by PolyglotBot You can edit links on the English source page : Mod...")
Tag: 2017 source edit
 
No edit summary
Tag: 2017 source edit
 
Line 3: Line 3:
     Links below are automatically managed by PolyglotBot
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
[[fr:Module_Ultimateqrcode_FR]]
[[en:Module_Ultimateqrcode_EN]]
[[en:Module_Ultimateqrcode_EN]]
[[fr:Module_Ultimateqrcode_FR]]
[[de:Module_Ultimateqrcode_DE]]
[[de:Module_Ultimateqrcode_DE]]
[[it:Module_Ultimateqrcode_IT]]
[[it:Module_Ultimateqrcode_IT]]
Line 20: Line 20:
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=PHP 8.2 como mínimo, extensión PHP GD
|minversion=17.0.0
|minversion=25.0.0
|note=Compatible con Dolibarr v24
|note=Compatible con Dolibarr v25 y PHP 8.5
}}
}}
UltimateQRcode añade '''códigos QR''' a las fichas de Dolibarr (terceros, contactos, productos, documentos comerciales, proyectos…). Cada código QR codifica los campos que usted elige, puede llevar un logotipo en el centro y se imprime en una etiqueta de 120 × 57 mm. Las fichas de personas ofrecen además un '''código QR vCard''' que un smartphone escanea para añadir el contacto a su agenda.
----
= Requisitos =
{| class="wikitable"
! Elemento !! Versión
|-
| '''Dolibarr''' || 25.0.0 o superior
|-
| '''PHP''' || 8.2 como mínimo (probado hasta PHP 8.5)
|-
| '''Extensión PHP''' || GD (generación de las imágenes PNG)
|-
| '''Módulos Dolibarr''' || Ningún módulo obligatorio. Las pestañas solo aparecen en los objetos cuyo módulo está activado (Facturas, Stocks, Proyectos…)
|}
Las bibliotecas ''chillerlan/php-qrcode'' y ''michelf/php-markdown'' se entregan con el módulo: no hace falta ninguna instalación con Composer.
----


= Instalación =
= Instalación =


# Descargue el módulo y colóquelo en el directorio <code>htdocs/custom/ultimateqrcode/</code>
# Descargar el archivo <code>module_ultimateqrcode-25.0.x.zip</code> desde el [https://www.dolistore.com DoliStore]
# En Dolibarr: '''Inicio → Configuración → Módulos/Aplicaciones'''
# En Dolibarr: '''Inicio → Configuración → Módulos/Aplicaciones''', pestaña '''Desplegar/instalar un módulo externo''', enviar el archivo. En su defecto, descomprimir el archivo en <code>htdocs/custom/</code>: debe obtener <code>htdocs/custom/ultimateqrcode/</code>
# Busque el módulo '''UltimateQRcode''' en la sección ''Atoo-Net'' y actívelo
# Buscar el módulo '''UltimateQRcode''' en la lista y activarlo
# Los permisos deben configurarse por grupo de usuarios (ver [[#Derechos_y_permisos|Derechos y permisos]])
# Asignar los permisos a los usuarios o grupos (véase [[#Permisos|Permisos]])
 
: '''Actualización desde una versión anterior:''' sustituir la carpeta <code>ultimateqrcode</code> y después '''desactivar y reactivar''' el módulo para que Dolibarr recargue las pestañas y los permisos.


----
----
Line 36: Line 60:
= Configuración del módulo =
= Configuración del módulo =


Se accede a la configuración desde '''Inicio → Configuración → Módulos/Aplicaciones → UltimateQRcode''' (icono de llave inglesa) o directamente desde el menú de administración.
Acceda a la configuración desde '''Inicio → Configuración → Módulos/Aplicaciones → UltimateQRcode''' (icono de engranaje).


La página de configuración consta de tres pestañas.
La página de configuración tiene cuatro pestañas: '''Códigos QR''', '''QR con logotipo''', '''Guía del usuario''' y '''Acerca de'''.


== Pestaña «Códigos QR» (generador libre) ==
== Pestaña «Códigos QR» (generador libre) ==


[[File:Ultimateqrcode-admin-qrcodes-fr.png|center|900px|Generador libre de código QR]]
[[File:Ultimateqrcode-v25-admin-qrcodes-es.png|center|900px|Generador libre de códigos QR]]


Esta pestaña ofrece un '''generador de código QR bajo demanda''':
Esta pestaña es un '''generador de códigos QR a demanda''': el código QR creado aquí no está vinculado a ninguna ficha de Dolibarr y puede codificar cualquier contenido.


{| class="wikitable"
{| class="wikitable"
! Campo !! Descripción
! Campo !! Descripción
|-
|-
| '''Data''' || El contenido a codificar: URL, dirección de correo electrónico, texto libre, vCard, etc.
| '''Introduzca aquí los datos a codificar en el código QR''' || El contenido a codificar: URL, dirección de correo electrónico, número de teléfono, texto libre…
|-
|-
| '''ECC''' || Nivel de corrección de errores:<br/>• '''L''' (≈7% — el más pequeño): tamaño mínimo<br/>• '''M''' (≈15%): uso habitual<br/>• '''Q''' (≈25%): buena resistencia<br/>• '''H''' (≈30% — el mejor): muy resistente (recomendado con logotipo)
| '''Calidad''' || Nivel de corrección de errores:<br/>• '''Baja''' (L, ≈ 7 %): código QR más compacto<br/>• '''Media''' (M, ≈ 15 %): uso habitual<br/>• '''Intermedia''' (Q, ≈ 25 %): buena resistencia<br/>• '''Alta''' (H, ≈ 30 %): muy resistente a la suciedad y a los arañazos
|-
|-
| '''Size''' || Tamaño de punto (de 1 a 10 píxeles por módulo del código QR)
| '''Tamaño''' || De 1 a 10 píxeles por módulo del código QR
|-
|-
| Botón '''GENERATE''' || Genera y muestra el código QR de inmediato
| Botón '''GENERAR''' || Genera y muestra el código QR
|-
| Botón '''IMPRIMIR ETIQUETA''' || Abre el código QR en una etiqueta de 120 × 57 mm (véase [[#Impresión de etiquetas|Impresión de etiquetas]])
|}
|}
Haga clic en '''Like this''' dentro del texto de ayuda para ver un ejemplo de generación.


== Pestaña «QR con logotipo» ==
== Pestaña «QR con logotipo» ==


[[File:Ultimateqrcode-admin-qrwithlogo-fr.png|center|900px|Generador de QR con logotipo incrustado]]
[[File:Ultimateqrcode-v25-admin-qrwithlogo-es.png|center|900px|Generador de códigos QR con logotipo]]


Esta pestaña permite crear un '''código QR con un logotipo insertado en el centro''':
Esta pestaña crea un '''código QR libre con un logotipo en el centro'''. Los códigos QR generados se conservan en la carpeta temporal del módulo y pueden volver a mostrarse, imprimirse o eliminarse.


{| class="wikitable"
{| class="wikitable"
! Campo !! Descripción
! Elemento !! Descripción
|-
| '''Introduzca aquí los datos a codificar en el código QR''' || URL o contenido a codificar
|-
|-
| '''Data''' || URL o contenido a codificar (por defecto: https://www.atoo-net.com/)
| '''Tamaño''' || De 2 a 10, controla la resolución de la imagen
|-
|-
| '''Tamaño''' || De 1 a 10 — controla la resolución de la imagen generada
| '''Tabla de logotipos''' || Logotipos disponibles en <code>documents/mycompany/logos/</code>, con tamaño, fecha, vista previa (lupa), cambio de nombre y eliminación. El botón de opción elige el logotipo a integrar
|-
|-
| '''Seleccionar archivo''' || Logotipo PNG que se incrustará en el centro del código QR
| Botón '''GENERAR''' || Crea el código QR con el logotipo elegido
|-
|-
| Botón '''GENERATE''' || Genera el código QR con el logotipo y lo guarda
| '''ENVIAR ARCHIVO''' || Añade un nuevo logotipo (se recomienda PNG)
|-
|-
| '''Seleccionar código QR a mostrar''' || Selección entre los códigos QR ya generados para visualizarlos
| '''Seleccione un código QR para mostrar''' + '''MOSTRAR''' || Vuelve a mostrar un código QR ya generado
|-
|-
| Botón '''MOSTRAR''' || Muestra el código QR seleccionado
| Icono '''papelera''' || Elimina el código QR seleccionado, previa confirmación
|-
|-
| Icono '''Papelera''' || Elimina el archivo QR seleccionado (con confirmación)
| Botón '''IMPRIMIR ETIQUETA''' || Imprime el código QR mostrado en una etiqueta de 120 × 57 mm
|}
|}


La sección '''Logotipos subidos''' enumera todos los archivos PNG almacenados con su tamaño y fecha de subida. Cada línea incluye un botón de eliminación.
: '''Nota:''' la corrección de errores se '''fuerza a calidad Alta''', porque el logotipo oculta una parte de la matriz.
 
== Pestaña «Guía del usuario» ==
 
[[File:Ultimateqrcode-v25-admin-guide-es.png|center|900px|Guía del usuario integrada]]


: '''Nota:''' El nivel ECC recomendado para un código QR con logotipo es '''H''' (30%), ya que el logotipo cubre una parte del código; la corrección de errores compensa esta pérdida.
La guía del usuario completa se puede consultar directamente en Dolibarr, en el idioma del usuario (francés, inglés, alemán, español o italiano).


== Pestaña «Acerca de» ==
== Pestaña «Acerca de» ==


Muestra información sobre la versión del módulo, el autor y el enlace a la documentación.
Muestra la versión del módulo, el autor, la licencia y los enlaces a la documentación.


----
----
Line 96: Line 126:
= Uso en las fichas =
= Uso en las fichas =


El módulo añade una pestaña '''Código QR''' en las fichas de los siguientes objetos:
El módulo añade una pestaña '''Código QR''' a las fichas de los 16 objetos siguientes:


{| class="wikitable"
{| class="wikitable"
! Objeto !! Pestaña(s) añadida(s)
! Objeto !! Pestaña añadida !! Código QR vCard
|-
| Cliente/Proveedor || Código QR + QR-Url (pestañas separadas)
|-
|-
| Contacto || Código QR
| Tercero || Código QR || Sí
|-
|-
| Producto / Servicio || Código QR
| Contacto / Dirección || Código QR || Sí
|-
|-
| Lote / Número de serie || Código QR
| Usuario || Código QR || Sí
|-
|-
| Almacén || Código QR
| Miembro || Código QR || Sí
|-
|-
| Presupuesto || Código QR
| Grupo de usuarios || Código QR ||
|-
|-
| Pedido de cliente || Código QR
| Producto / Servicio || Código QR ||
|-
|-
| Pedido de proveedor || Código QR
| Lote / Número de serie || Código QR ||
|-
|-
| Factura de cliente || Código QR
| Almacén || Código QR ||
|-
|-
| Factura de proveedor || Código QR
| Presupuesto || Código QR ||
|-
|-
| Contrato || Código QR
| Pedido de cliente || Código QR ||
|-
|-
| Intervención || Código QR
| Pedido a proveedor || Código QR ||
|-
|-
| Proyecto || Código QR
| Factura a cliente || Código QR ||
|-
|-
| Miembro (asociación) || Código QR
| Factura de proveedor || Código QR ||
|-
|-
| Grupo de usuarios || Código QR
| Contrato || Código QR ||
|-
|-
| Usuario || Código QR
| Intervención || Código QR ||
|-
|-
| Proyecto || Código QR ||
|}
|}


== Estructura común de la pestaña Código QR ==
== Estructura común de la pestaña Código QR ==


'''[Novedad v24]''' Cada pestaña de código QR ahora está organizada en '''cinco zonas''':
Cada pestaña Código QR se organiza en '''cinco zonas'''.


=== Zona 1 — Barra de ajustes ===
=== Zona 1 — Barra de ajustes ===


[[File:Ultimateqrcode-v24-settings-panel-fr.png|center|900px|Panel de ajustes: tamaño, calidad ECC y selección de logotipo]]
En la parte superior de la pestaña, una barra de ajustes permite elegir:
 
En la parte superior de cada pestaña de código QR, una barra de ajustes permite configurar:


{| class="wikitable"
{| class="wikitable"
! Ajuste !! Descripción
! Ajuste !! Descripción
|-
|-
| '''Tamaño''' || Resolución del código QR (de 2 a 10 píxeles por módulo). Cuanto mayor sea el valor, más grande y legible será el código QR.
| '''Tamaño''' || Resolución del código QR, de 2 a 10 píxeles por módulo
|-
|-
| '''Calidad (ECC)''' || Nivel de corrección de errores: Bajo (L ≈ 7%), Medio (M ≈ 15%), Cuartil (Q ≈ 25%), Alto (H ≈ 30%).
| '''Calidad''' || Corrección de errores: Baja (L), Media (M), Intermedia (Q) o Alta (H)
|-
|-
| '''Logotipo''' || Logotipo PNG que se incrustará en el centro del código QR, seleccionable entre los logotipos subidos.
| '''Logotipo''' || Logotipo integrado en el centro del código QR, elegido en la tabla de la zona 2
|}
|}


: '''Nota:''' Cuando se selecciona un logotipo, la calidad ECC se fuerza automáticamente a '''Alto (H)''' para garantizar la legibilidad a pesar del logotipo. Se muestra el aviso ''(Forzado a Alto con logotipo)'' junto al selector.
: '''Nota:''' en cuanto se selecciona un logotipo, la calidad se '''fuerza a Alta (H)''' y aparece la mención ''(Forzado a Alta con logotipo)'' junto al selector.


Estos ajustes se guardan de forma '''independiente por tipo de objeto''' (factura, presupuesto, pedido, etc.) y se aplican a los dos códigos QR mostrados (datos y URL).
Estos ajustes se guardan '''por tipo de objeto''' (facturas, presupuestos, pedidos…) y se aplican a todos los códigos QR de la pestaña.


=== Zona 2 — Tabla de selección de logotipo ===
=== Zona 2 — Tabla de selección del logotipo ===


La tabla enumera los logotipos disponibles en el directorio <code>documents/mycompany/logos/</code>:
La tabla lista los logotipos de la carpeta <code>documents/mycompany/logos/</code>:


{| class="wikitable"
{| class="wikitable"
! Columna !! Descripción
! Columna !! Descripción
|-
|-
| '''Radio''' || Botón de opción para seleccionar el logotipo (o «''Sin logotipo''»)
| '''Botón de opción''' || Selecciona el logotipo, o «''Sin logotipo''»
|-
|-
| '''Logotipo''' || Nombre del archivo PNG con icono de vista previa
| '''Logotipo''' || Nombre del archivo
|-
|-
| '''Tamaño''' || Tamaño del archivo en bytes
| '''Tamaño''' || Tamaño del archivo en bytes
|-
|-
| '''Fecha''' || Fecha de la última subida
| '''Fecha''' || Fecha de envío del archivo
|-
|-
| '''Vista previa''' || Icono de lupa para previsualizar el logotipo
| '''Vista previa''' || Lupa para mostrar el logotipo
|-
|-
| '''Acciones''' || Iconos para renombrar y eliminar
| '''Acciones''' || Cambiar el nombre y eliminar
|}
|}


Un formulario de subida al final de la página permite añadir nuevos logotipos PNG.
Un formulario al final de la página permite enviar nuevos logotipos.


: '''Seguridad:''' Si el logotipo es demasiado grande en relación con la capacidad del código QR, el módulo cambia automáticamente al modo sin logotipo para evitar un error. Se registra un mensaje en los registros de Dolibarr.
: '''Seguridad:''' si el logotipo es demasiado grande para la capacidad del código QR, el módulo genera el código QR sin logotipo en lugar de provocar un error, y registra el incidente en el registro de Dolibarr.


=== Zona 3 — Código QR de datos configurables ===
=== Zona 3 — Código QR de los datos ===


[[File:Ultimateqrcode-thirdparty-qrcode-top-fr.png|center|900px|Pestaña de código QR de un cliente/proveedor — selección de campos]]
[[File:Ultimateqrcode-v25-thirdparty-qrcode-es.png|center|900px|Pestaña Código QR de un tercero: campos, código QR de los datos, código QR de la URL y código QR vCard]]


El usuario selecciona mediante casillas de verificación los '''campos que se incluirán en el código QR''':
Usted elige los '''campos a codificar''' marcándolos:


* La columna izquierda contiene la casilla de verificación
* la casilla incluye o excluye el campo;
* La columna central muestra la etiqueta del campo y su valor actual (en gris si no está marcado)
* la columna central muestra la etiqueta y el valor actual del campo (atenuado si no está marcado);
* La columna derecha muestra el '''código QR generado''' (con o sin logotipo, según la selección)
* el código QR generado aparece junto a la tabla, con o sin logotipo, acompañado del botón '''IMPRIMIR ETIQUETA'''.


Los campos disponibles dependen del objeto:
Campos disponibles según el objeto:


{| class="wikitable"
{| class="wikitable"
! Objeto !! Campos disponibles
! Objeto !! Campos disponibles
|-
|-
| Cliente/Proveedor || Empresa, Dirección, Código postal, Ciudad, País, Teléfono, Correo electrónico, URL + campos adicionales
| Tercero || Empresa, Dirección, Código postal, Población, País, Teléfono, Email, URL
|-
| Contacto || Nombre, Apellidos, Teléfono, Móvil, Email, Dirección, Código postal, Población, País, URL
|-
| Usuario || Login, Nombre, Apellidos, Teléfono, Móvil, Email, Dirección, Código postal, Población, País, URL
|-
| Miembro || Nombre, Apellidos, Teléfono, Teléfono personal, Email, Dirección, Código postal, Población, País, URL
|-
| Grupo de usuarios || Nombre del grupo, Descripción, URL
|-
| Producto / Servicio || Ref., Etiqueta, Descripción, Precio sin IVA, Precio con IVA, Código de barras, Peso, Volumen, URL
|-
| Lote / Número de serie || Lote/Serie, Fecha de caducidad, Fecha límite de venta, URL
|-
| Almacén || Etiqueta, Nombre corto de la ubicación, Descripción, Dirección, Código postal, Población, País, URL
|-
| Presupuesto || Ref., Ref. cliente, Empresa, Email, Teléfono, Fecha, Fecha de fin de validez, Total sin IVA, Total con IVA, Nota pública, URL
|-
| Pedido de cliente || Ref., Ref. cliente, Empresa, Email, Teléfono, Fecha, Total sin IVA, Total con IVA, Nota pública, URL
|-
|-
| Producto || Ref., Descripción, Detalle, Precio sin impuestos, Precio con impuestos, Código de barras, Peso, Volumen, URL + campos adicionales
| Pedido a proveedor || Ref., Ref. proveedor, Empresa, Email, Teléfono, Fecha, Total sin IVA, Total con IVA, Nota pública, URL
|-
|-
| Almacén || Etiqueta, Nombre corto de la ubicación, Descripción, Dirección, Código postal, Ciudad, País, URL + campos adicionales
| Factura a cliente || Ref., Ref. cliente, Empresa, Email, Teléfono, Fecha de facturación, Fecha límite de pago, Total sin IVA, Total con IVA, Nota pública, URL
|-
|-
| Usuario || Login, Nombre, Apellidos, Teléfono, Móvil, Correo electrónico, Dirección, Código postal, Ciudad, País, URL + campos adicionales
| Factura de proveedor || Ref., Ref. proveedor, Empresa, Email, Teléfono, Fecha de facturación, Fecha límite de pago, Total sin IVA, Total con IVA, Nota pública, URL
|-
|-
| Contacto || Tratamiento, Nombre, Apellidos, Empresa, Cargo, Teléfono, Móvil, Correo electrónico, Dirección, etc.
| Contrato || Ref., Ref. cliente, Ref. proveedor, Empresa, Email, Teléfono, Fecha del contrato, Nota pública, URL
|-
|-
| Factura || Ref., Ref. cliente, Empresa, Correo electrónico, Teléfono, Fecha de factura, Vencimiento, Total sin impuestos, Total con impuestos, Nota pública, URL
| Intervención || Ref., Empresa, Email, Teléfono, Fecha, Descripción, URL
|-
|-
| (otros) || Campos específicos del objeto
| Proyecto || Ref., Etiqueta del proyecto, Empresa, Email, Teléfono, Fecha de inicio, Fecha de fin, Nota pública, URL
|}
|}


: '''Nota:''' Los '''campos adicionales''' (atributos complementarios) definidos en Dolibarr se añaden automáticamente a la lista de campos disponibles.
: '''Nota:''' los '''campos adicionales''' rellenados en la ficha se añaden automáticamente a la lista, en la forma ''Campo adicional : etiqueta''. Los creados por otros módulos se ignoran.
 
El código QR mostrado es '''clicable''': un clic abre la ventana de [[#Impresión_de_etiquetas|impresión de etiquetas]].


=== Zona 4 — Código QR de la URL de la ficha ===
=== Zona 4 — Código QR de la URL de la ficha ===


[[File:Ultimateqrcode-thirdparty-qrcode-bottom-fr.png|center|900px|Pestaña de código QR — zona inferior con QR de URL y botones Guardar/Cancelar]]
A la derecha (o debajo de la tabla según el ancho de la pantalla), la pestaña muestra:


La zona inferior muestra:
* la etiqueta '''URL de la ficha''' seguida de un enlace a la ficha;
* un segundo '''código QR que codifica la URL directa''' de la ficha, también imprimible en etiqueta;
* al final de la página, los botones '''GRABAR''' y '''ANULAR'''.


* La etiqueta '''URL de la ficha [Objeto]'''
=== Zona 5 — Código QR vCard (Tercero, Contacto, Usuario, Miembro) ===
* El enlace clicable a la ficha de Dolibarr
* Un segundo '''código QR que codifica la URL directa''' hacia la ficha (también clicable para la impresión de etiquetas)
* Los botones '''GUARDAR''' y '''CANCELAR'''


=== Zona 5 — Código QR vCard (Contacto, Usuario, Cliente/Proveedor, Miembro) ===
[[File:Ultimateqrcode-v25-contact-vcard-es.png|center|900px|Código QR vCard en una ficha de contacto]]


[[File:Ultimateqrcode-v24-contact-vcard-fr.png|center|900px|Código QR vCard en una ficha de contacto]]
Las fichas '''Tercero''', '''Contacto''', '''Usuario''' y '''Miembro''' muestran además un '''código QR vCard'''. Escaneado con un smartphone, propone añadir el contacto directamente a la agenda. El contenido vCard 3.0 codificado se muestra en claro junto al código QR.


Las fichas de '''Contacto''', '''Usuario''', '''Cliente/Proveedor''' (empresa) y '''Miembro''' disponen de un '''código QR vCard''' adicional al final de la página.
=== Vista previa dinámica ===


Al escanear este código QR con un smartphone se permite añadir directamente el contacto a la agenda telefónica. El contenido vCard codificado se muestra en texto plano debajo del código QR.
Los códigos QR se actualizan '''en tiempo real''' cuando cambia:
* el tamaño;
* la calidad;
* el logotipo;
* los campos marcados.


=== Vista previa en tiempo real ===
'''No es necesario recargar la página.''' La vista previa usa una petición AJAX enviada 300 ms después del último cambio. Funciona en las 16 pestañas Código QR.


'''[Novedad v24]''' Los códigos QR se actualizan '''en tiempo real''' cuando el usuario modifica:
=== Selección automática de los campos por defecto ===
* el tamaño del código QR
* el nivel de calidad ECC
* el logotipo seleccionado
* los campos marcados (QR de datos)


'''No es necesario recargar la página.''' La vista previa utiliza una solicitud AJAX con un retardo de 300 ms para evitar llamadas excesivas. Esta función está disponible en las '''16 páginas de código QR''' del módulo.
En la primera visualización, mientras no se haya guardado ninguna configuración, el módulo marca los campos rellenados en la ficha. Así el código QR es pertinente desde la primera apertura.


=== Selección automática de campos por defecto ===
=== Guardar la configuración ===


En la primera visualización (sin configuración guardada), el módulo selecciona automáticamente los campos cuyo valor no está vacío. Esto garantiza un código QR pertinente desde la primera apertura.
Marque o desmarque los campos y haga clic en '''GRABAR'''. La selección se aplica a '''todos los objetos del mismo tipo''' (una configuración por tipo de objeto).
 
=== Guardado de la configuración ===
 
Marque o desmarque los campos deseados y haga clic en '''GUARDAR'''. La selección se guarda y se aplica a '''todos los objetos del mismo tipo''' (una configuración global por tipo de objeto).


----
----
Line 258: Line 296:
= Pestaña Código QR — Ejemplos por objeto =
= Pestaña Código QR — Ejemplos por objeto =


== Factura de cliente ==
== Factura a cliente ==


'''[Novedad v24]'''
[[File:Ultimateqrcode-v25-invoice-qrcode-es.png|center|900px|Pestaña Código QR de una factura con logotipo integrado]]


[[File:Ultimateqrcode-v24-invoice-qr-complete-fr.png|center|900px|Pestaña de código QR de una factura con logotipo incrustado]]
Ejemplo en una factura a cliente: '''Ref.''', '''Empresa''', '''Email''', '''Teléfono''', '''Fecha de facturación''', '''Fecha límite de pago''', '''Total sin IVA''', '''Total con IVA''' y '''URL''' están marcados. El logotipo ''expert_dolibarr.png'' está integrado en el centro de ambos códigos QR y la calidad está forzada a Alta (H).
 
Ejemplo de configuración para una factura de cliente: '''Ref.''', '''Empresa''', '''Correo electrónico''', '''Teléfono''', '''Fecha de factura''', '''Vencimiento''', '''Total sin impuestos''' y '''Total con impuestos''' marcados. El logotipo ''expert_dolibarr.png'' está seleccionado e incrustado en el centro del código QR. La calidad ECC se fuerza automáticamente a Alto (H).


== Producto ==
== Producto ==


[[File:Ultimateqrcode-product-qrcode-fr.png|center|900px|Pestaña de código QR de un producto]]
[[File:Ultimateqrcode-v25-product-qrcode-es.png|center|900px|Pestaña Código QR de un producto]]


Ejemplo de configuración para un producto: '''Ref.''' y '''Descripción''' marcados, junto con los campos adicionales '''Ecotax''' y '''ControlHistoryLink'''. El código QR codifica estos cuatro valores concatenados.
En un producto, el código QR puede codificar la referencia, la etiqueta, los precios, el código de barras, el peso y el volumen: práctico para el etiquetado en tienda o en almacén.


== Almacén ==
== Almacén ==


[[File:Ultimateqrcode-stock-qrcode-fr.png|center|900px|Pestaña de código QR de un almacén]]
[[File:Ultimateqrcode-v25-stock-qrcode-es.png|center|900px|Pestaña Código QR de un almacén]]


Útil para el etiquetado físico de las ubicaciones de almacenamiento. El campo '''Nombre corto de la ubicación''' permite precisar la zona de almacenamiento.
Útil para identificar físicamente las ubicaciones de almacenamiento. El campo '''Nombre corto de la ubicación''' precisa la zona (pasillo, estantería…).


== Usuario ==
== Usuario ==


[[File:Ultimateqrcode-user-qrcode-fr.png|center|900px|Pestaña de código QR de un usuario]]
El código QR del usuario codifica los datos de contacto profesionales (login, nombre, apellidos, teléfonos, email, dirección…), y el código QR vCard los añade a una agenda. Práctico para acreditaciones o tarjetas de visita internas.


El código QR del usuario codifica información de contacto (login, nombre, apellidos, teléfono, móvil, correo electrónico, país...). Práctico para tarjetas de identificación o tarjetas de visita internas.
: '''Nota:''' la pestaña Código QR de un usuario solo es visible para el propio usuario o para quienes tienen permiso para leer las fichas de usuarios.
 
: '''Nota:''' La pestaña de código QR del usuario solo es visible para el propio usuario o para los usuarios con permiso de lectura sobre las fichas de usuario.


----
----


= Pestaña QR-Url (solo Clientes/Proveedores) =
= Imagen de código QR reutilizable (QR con logotipo) =


[[File:Ultimateqrcode-thirdparty-qrurl-fr.png|center|900px|Pestaña QR-Url de un cliente/proveedor con logotipo]]
Para obtener una '''imagen de código QR con logotipo''' reutilizable en otro lugar (sitio web, folleto, firma de correo), use la pestaña de configuración '''QR con logotipo''':


Las fichas de Cliente/Proveedor disponen de una '''segunda pestaña QR''' llamada '''QR-Url''', especializada en la generación de códigos QR '''con logotipo incrustado''' que codifican la URL de la ficha.
# introduzca la URL de la ficha o cualquier otro contenido en la zona de entrada;
# elija el tamaño y el logotipo y haga clic en '''GENERAR''';
# vuelva a mostrar el código QR en cualquier momento con '''Seleccione un código QR para mostrar''', imprímalo o elimínelo.


Funcionalidades:
: '''Nota:''' la antigua pestaña «QR-Url» de los terceros, que el módulo ya no declaraba, se ha retirado. El código QR de la URL de la ficha sigue disponible en la zona 4 de cada pestaña Código QR.
 
{| class="wikitable"
! Elemento !! Función
|-
| '''Tamaño''' (1-10) || Resolución del código QR generado
|-
| '''Seleccionar archivo''' + '''SUBIR LOGOTIPO''' || Subir un logotipo PNG para incrustarlo en el centro
|-
| '''Seleccionar código QR a mostrar''' || Selección entre los códigos QR ya generados para este cliente/proveedor
|-
| Botón '''MOSTRAR''' || Muestra el código QR seleccionado
|-
| Sección '''Logotipos subidos''' || Lista de logotipos disponibles con opciones de descarga y eliminación
|}
 
El código QR mostrado codifica la URL de la ficha del cliente/proveedor, con el logotipo elegido en el centro de la imagen.


----
----
Line 316: Line 336:
= Impresión de etiquetas =
= Impresión de etiquetas =


[[File:Ultimateqrcode-label-print-fr.png|center|700px|Ventana de impresión de etiqueta 120×57mm]]
[[File:Ultimateqrcode-v25-label-print-es.png|center|466px|Etiqueta de 120 × 57 mm]]
 
El botón '''IMPRIMIR ETIQUETA''', o un clic en un código QR, abre una '''ventana de impresión''' en formato '''120 × 57 mm''', adaptado a las impresoras de etiquetas habituales.


Al hacer clic en un código QR de cualquier pestaña, se abre una '''ventana emergente de impresión''', optimizada para etiquetas de formato '''120 × 57 mm''' (compatible con las impresoras de etiquetas habituales).
La etiqueta de una ficha contiene:
* '''a la izquierda''': el código QR de los datos;
* '''en el centro''': la información clave de la ficha (referencia, tercero, total…, según el objeto);
* '''a la derecha''': el código QR de la URL de la ficha.


La etiqueta incluye:
Los generadores de las pestañas '''Códigos QR''' y '''QR con logotipo''' imprimen del mismo modo el código QR que acaban de crear.
* '''A la izquierda''': el código QR de datos configurables
* '''En el centro''': la información textual principal (referencia, descripción, nombre, etc. según el objeto)
* '''A la derecha''': el código QR de la URL de la ficha


La ventana lanza automáticamente el cuadro de diálogo de impresión del navegador.
La ventana abre automáticamente el cuadro de diálogo de impresión del navegador.


: '''Nota:''' Para una impresión óptima en etiquetas adhesivas, configure la impresora en formato 120×57mm y desactive los márgenes en las opciones de impresión del navegador.
: '''Nota:''' para una impresión óptima en etiquetas adhesivas, configure la impresora en formato 120 × 57 mm y suprima los márgenes en las opciones de impresión del navegador.


----
----


= Derechos y permisos =
= Permisos =


[[File:Ultimateqrcode-permissions-fr.png|center|700px|Permisos del módulo UltimateQRcode]]
[[File:Ultimateqrcode-v25-permissions-es.png|center|900px|Permisos del módulo UltimateQRcode]]


El módulo define dos niveles de permisos, asignables por grupo de usuarios desde '''Configuración → Usuarios y grupos''':
El módulo define dos permisos, que se asignan por usuario o por grupo en '''Usuarios y grupos''':


{| class="wikitable"
{| class="wikitable"
! Permiso !! Descripción !! Efecto
! Permiso !! Efecto
|-
|-
| '''Read qrcode outcomes''' || Leer los códigos QR || Permite ver las pestañas de código QR y los códigos QR generados
| '''Leer los códigos QR''' || Muestra las pestañas Código QR y los códigos QR generados
|-
|-
| '''Create/Modify qrcode outcomes''' || Crear/Modificar || Permite marcar o desmarcar los campos y guardar la configuración
| '''Crear / Modificar los códigos QR''' || Permite marcar o desmarcar campos y guardar la configuración
|}
|}


: '''Nota:''' Sin el permiso '''Read''', las pestañas de código QR no son visibles. Sin el permiso '''Write''', el usuario puede ver los códigos QR pero no modificar la selección de campos.
: '''Nota:''' sin el permiso de lectura, las pestañas Código QR no son visibles. Sin el permiso de modificación, el usuario ve los códigos QR pero no puede cambiar la selección de campos. El envío, el cambio de nombre y la eliminación de logotipos están reservados a los administradores.


----
----


= Novedades y compatibilidad con v24 =
= Novedades y compatibilidad v25 =


'''[Novedad v24]''' La versión 24 del módulo UltimateQRcode aporta las siguientes mejoras:
La versión 25.0.0 adapta UltimateQRcode a Dolibarr 25.


== Nuevas funcionalidades ==
{| class="wikitable"
! Cambio !! Detalle
|-
| '''Versiones mínimas''' || Dolibarr 25.0.0 y PHP 8.2
|-
| '''PHP 8.4 y 8.5''' || El módulo no emite ninguna advertencia de obsolescencia: propiedades del descriptor alineadas con el núcleo, página «Acerca de» sin advertencia
|-
| '''Pestañas de pago''' || Se han eliminado las pestañas «Código QR» de los pagos de clientes y proveedores, que apuntaban a páginas inexistentes (error 404)
|-
| '''Pestaña QR-Url''' || Se ha suprimido la página huérfana de la antigua pestaña QR-Url de los terceros; la documentación remite a la pestaña '''QR con logotipo'''
|-
| '''Permisos traducidos''' || Los dos permisos se muestran ahora en el idioma del usuario («Leer los códigos QR», «Crear / Modificar los códigos QR»)
|-
| '''Visualización vCard''' || El contenido vCard y las direcciones de varias líneas se muestran correctamente, sin «\n» visible ni desbordamiento de la página
|-
| '''Campos adicionales''' || La etiqueta «Campo adicional» está traducida (antes aparecía «ExtraField»)
|-
| '''Etiquetas ES''' || «Código QR vCard» corregido en español
|-
| '''Guía del usuario''' || Nueva pestaña de configuración con la guía completa en los 5 idiomas
|-
| '''Integración continua''' || Cada archivo PHP del módulo se comprueba con <code>php -l</code> en PHP 8.4 y 8.5
|}
 
== Historial v24 ==
 
=== Nuevas funcionalidades v24 ===


{| class="wikitable"
{| class="wikitable"
! Funcionalidad !! Descripción
! Funcionalidad !! Descripción
|-
|-
| '''Ajustes por página''' || Tamaño, calidad ECC y logotipo configurables directamente en cada página de código QR de la ficha
| '''Ajustes por ficha''' || Tamaño, calidad y logotipo configurables directamente en cada pestaña Código QR
|-
|-
| '''Logotipo incrustado''' || Posibilidad de incrustar un logotipo PNG en el centro de cada código QR, en todas las páginas
| '''Logotipo integrado''' || Logotipo PNG en el centro de cada código QR, en todas las páginas
|-
|-
| '''Vista previa en tiempo real''' || Actualización en tiempo real de los códigos QR al cambiar el tamaño, la ECC, el logotipo o los campos marcados (AJAX, sin recarga)
| '''Vista previa dinámica''' || Actualización de los códigos QR en tiempo real al cambiar tamaño, calidad, logotipo o campos marcados
|-
|-
| '''Código QR vCard''' || Código QR vCard para contactos, usuarios, clientes/proveedores y miembros, para añadirlos directamente a la agenda telefónica
| '''Código QR vCard''' || Para terceros, contactos, usuarios y miembros
|-
|-
| '''Gestión de logotipos''' || Subida, vista previa, cambio de nombre y eliminación de logotipos directamente desde la interfaz de cada ficha
| '''Gestión de logotipos''' || Envío, vista previa, cambio de nombre y eliminación de logotipos desde cada ficha
|}
|}


== Compatibilidad con Dolibarr v24 ==
=== Compatibilidad con Dolibarr v24 ===


{| class="wikitable"
{| class="wikitable"
! Corrección !! Detalle
! Corrección !! Detalle
|-
|-
| '''Icono del módulo''' || Adición de la extensión <code>.png</code> en la propiedad <code>$this->picto</code> del descriptor del módulo, conforme a la advertencia de Dolibarr v23+.
| '''Picto del módulo''' || Extensión <code>.png</code> añadida a la propiedad <code>$this->picto</code> del descriptor
|-
|-
| '''Moneda''' || Sustitución de <code>$conf->currency</code> (obsoleto) por <code>getDolCurrency()</code>.
| '''Moneda''' || <code>getDolCurrency()</code> en lugar de <code>$conf->currency</code> (obsoleto)
|-
|-
| '''Constantes''' || Sustitución de la asignación directa <code>$conf->global->XXX = value</code> (obsoleta) por <code>dolibarr_set_const()</code>.
| '''Constantes''' || <code>dolibarr_set_const()</code> en lugar de escribir directamente en <code>$conf->global</code>
|}
|}


== Correcciones de errores ==
=== Correcciones v24 ===


{| class="wikitable"
{| class="wikitable"
! Error !! Corrección
! Error !! Corrección
|-
|-
| Pestaña de factura no encontrada || Corrección de la distinción entre mayúsculas y minúsculas de la clave de pestaña en el descriptor del módulo.
| Pestaña de factura no encontrada || Mayúsculas y minúsculas de la clave de pestaña corregidas en el descriptor
|-
|-
| Parámetro de administración obsoleto || Eliminación del parámetro «Tamaño de visualización de los códigos QR (en píxeles)», que quedó redundante con el ajuste de tamaño por página.
| Parámetro de configuración obsoleto || Eliminado «Tamaño de visualización de los códigos QR (en píxeles)», sustituido por el ajuste de tamaño de cada ficha
|-
|-
| Desbordamiento del logotipo || Adición de un mecanismo try/catch para gestionar el desbordamiento de capacidad cuando el logotipo es demasiado grande: cambio automático al modo sin logotipo.
| Logotipo demasiado grande || Paso automático a «sin logotipo» en lugar de un error
|}
|}


== Traducciones ==
=== Traducciones v24 ===


Adición de las claves de traducción faltantes en los '''5 archivos de idioma''' (FR, EN, DE, ES, IT) para las nuevas funcionalidades: selección de calidad ECC, gestión de logotipos y todos los tipos de objeto.
Claves de traducción que faltaban añadidas en los 5 idiomas (FR, EN, DE, ES, IT): calidad, gestión del logotipo y todos los tipos de objeto.


----
----


= FAQ =
= Preguntas frecuentes =


; '''El código QR está vacío o muestra «Sin datos»'''
; '''El código QR está vacío o muestra «Sin datos»'''
: No hay ningún campo marcado, o todos los campos marcados tienen un valor vacío en la ficha. Marque al menos un campo con un valor y haga clic en GUARDAR.
: No hay ningún campo marcado, o los campos marcados están vacíos en la ficha. Marque al menos un campo rellenado y haga clic en GRABAR.


; '''La etiqueta no se imprime en el tamaño correcto'''
; '''La etiqueta no se imprime con el tamaño correcto'''
: Compruebe que el formato de papel de la impresora esté correctamente configurado en 120×57mm. Desactive los márgenes en las opciones de impresión del navegador.
: Compruebe que el formato de papel de la impresora está configurado en 120 × 57 mm y suprima los márgenes en las opciones de impresión del navegador.


; '''Los campos adicionales no aparecen'''
; '''Los campos adicionales no aparecen'''
: Los atributos complementarios deben estar definidos en '''Configuración → Atributos complementarios''' para el objeto en cuestión.
: Solo se proponen los campos adicionales '''rellenados''' en la ficha. Se definen en la configuración del módulo correspondiente (por ejemplo '''Terceros → Atributos adicionales''').


; '''El código QR con logotipo no es legible'''
; '''El código QR con logotipo no se puede leer'''
: El logotipo ocupa demasiado espacio. Utilice un logotipo más pequeño (idealmente cuadrado, de menos de 100×100 píxeles) o aumente el nivel ECC a '''H''' para mejorar la corrección de errores. Con el módulo v24, la calidad ECC se fuerza automáticamente a '''H''' cuando se selecciona un logotipo.
: El logotipo ocupa demasiada superficie. Use un logotipo más pequeño, idealmente cuadrado. La calidad ya está forzada a Alta (H) en cuanto se selecciona un logotipo.


; '''El código QR se muestra sin logotipo aunque he seleccionado uno'''
; '''El código QR aparece sin logotipo aunque he seleccionado uno'''
: El logotipo probablemente es demasiado grande en relación con el contenido codificado. El módulo cambia automáticamente al modo sin logotipo para evitar un error. Pruebe con un logotipo más pequeño o reduzca el número de campos marcados.
: El logotipo es demasiado grande para el contenido codificado: el módulo genera entonces el código QR sin logotipo. Pruebe con un logotipo más pequeño o marque menos campos.


; '''Los códigos QR no se actualizan al cambiar los ajustes'''
; '''Los códigos QR no se actualizan al cambiar los ajustes'''
: La vista previa en tiempo real requiere que JavaScript esté activado en el navegador. Compruebe que ningún bloqueador de scripts esté activo. Los códigos QR se actualizan automáticamente 300 ms después de cada cambio.
: La vista previa dinámica necesita JavaScript. Compruebe que no haya ningún bloqueador de scripts activo.
 
; '''La pestaña Código QR no aparece en algunas fichas'''
: Compruebe que el módulo está activado, que el módulo Dolibarr del objeto también lo está y que el usuario tiene el permiso '''Leer los códigos QR'''. Tras una actualización, desactive y vuelva a activar UltimateQRcode.


; '''La pestaña de código QR no aparece en algunas fichas'''
; '''¿Dónde está la pestaña QR-Url de los terceros?'''
: Compruebe que el módulo esté activado y que el usuario disponga del permiso '''Read qrcode outcomes'''.
: Se ha retirado. El código QR de la URL de la ficha está en la pestaña Código QR (zona 4), y la pestaña de configuración '''QR con logotipo''' crea imágenes reutilizables.


----
----
Line 426: Line 477:
= Véase también =
= Véase también =


* [[Module_Ultimateqrcode_FR|Français]]
* [[Module_Ultimateqrcode_EN|English]]
* [[Module_Ultimateqrcode_EN|English]]
* [[Module_Ultimateqrcode_FR|Français]]
* [[Module_Ultimateqrcode_DE|Deutsch]]
* [[Module_Ultimateqrcode_DE|Deutsch]]
* [[Module_Ultimateqrcode_IT|Italiano]]
* [[Module_Ultimateqrcode_IT|Italiano]]
* [https://www.dolistore.com Dolistore]
* [https://www.dolistore.com/search.php?search_query=ultimateqrcode UltimateQRcode en el DoliStore]
* [https://www.atoo-net.com Atoo-Net]
* [https://www.atoo-net.com Atoo-Net]
Retrieved from "https://wiki.dolibarr.org/index.php/Special:MobileDiff/67547"

Navigation menu