Module Ultimateqrcode ES - Revision history

https://wiki.dolibarr.org/index.php?action=history&feed=atom&title=Module_Ultimateqrcode_ES Module Ultimateqrcode ES - Revision history 2026-11-12T05:30:56Z Revision history for this page on the wiki MediaWiki 1.39.17 https://wiki.dolibarr.org/index.php?title=Module_Ultimateqrcode_ES&diff=67547&oldid=prev Grandoc at 19:42, 29 September 2026 2026-09-29T19:42:50Z

<p></p> <a href="https://wiki.dolibarr.org/index.php?title=Module_Ultimateqrcode_ES&diff=67547&oldid=66749">Show changes</a>

Grandoc https://wiki.dolibarr.org/index.php?title=Module_Ultimateqrcode_ES&diff=66749&oldid=prev Grandoc: Created page with " <!-- Do NOT edit this section Links below are automatically managed by PolyglotBot You can edit links on the English source page : Mod..." 2026-07-25T13:27:21Z

<p>Created page with " <br /> <br /> [[en:Module_Ultimateqrcode_EN]]<br /> [[fr:Module_Ultimateqrcode_FR]]<br /> [[de:Module_Ultimateqrcode_DE]]<br /> [[it:Module_Ultimateqrcode_IT]]<br /> <br /> <br /> [[Category:Módulos complementarios]]<br /> [[Category:Ultimateqrcode]]<br /> {{TemplateDocDev}}<br /> {{TemplateDocUtil}}<br /> =Información=<br /> {{TemplateModuleInfo<br /> |modulename=Ultimateqrcode<br /> |editor=Atoo.Net<br /> |web=https://www.atoo-net.com<br /> |webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}<br /> |status=stable<br /> |prerequisites=<br /> |minversion=17.0.0<br /> |note=Compatible con Dolibarr v24<br /> }}<br /> <br /> = Instalación =<br /> <br /> # Descargue el módulo y colóquelo en el directorio <code>htdocs/custom/ultimateqrcode/</code><br /> # En Dolibarr: '''Inicio → Configuración → Módulos/Aplicaciones'''<br /> # Busque el módulo '''UltimateQRcode''' en la sección ''Atoo-Net'' y actívelo<br /> # Los permisos deben configurarse por grupo de usuarios (ver [[#Derechos_y_permisos|Derechos y permisos]])<br /> <br /> ----<br /> <br /> = Configuración del módulo =<br /> <br /> 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.<br /> <br /> La página de configuración consta de tres pestañas.<br /> <br /> == Pestaña «Códigos QR» (generador libre) ==<br /> <br /> [[File:Ultimateqrcode-admin-qrcodes-fr.png|center|900px|Generador libre de código QR]]<br /> <br /> Esta pestaña ofrece un '''generador de código QR bajo demanda''':<br /> <br /> {| class="wikitable"<br /> ! Campo !! Descripción<br /> |-<br /> | '''Data''' || El contenido a codificar: URL, dirección de correo electrónico, texto libre, vCard, etc.<br /> |-<br /> | '''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)<br /> |-<br /> | '''Size''' || Tamaño de punto (de 1 a 10 píxeles por módulo del código QR)<br /> |-<br /> | Botón '''GENERATE''' || Genera y muestra el código QR de inmediato<br /> |}<br /> <br /> Haga clic en '''Like this''' dentro del texto de ayuda para ver un ejemplo de generación.<br /> <br /> == Pestaña «QR con logotipo» ==<br /> <br /> [[File:Ultimateqrcode-admin-qrwithlogo-fr.png|center|900px|Generador de QR con logotipo incrustado]]<br /> <br /> Esta pestaña permite crear un '''código QR con un logotipo insertado en el centro''':<br /> <br /> {| class="wikitable"<br /> ! Campo !! Descripción<br /> |-<br /> | '''Data''' || URL o contenido a codificar (por defecto: https://www.atoo-net.com/)<br /> |-<br /> | '''Tamaño''' || De 1 a 10 — controla la resolución de la imagen generada<br /> |-<br /> | '''Seleccionar archivo''' || Logotipo PNG que se incrustará en el centro del código QR<br /> |-<br /> | Botón '''GENERATE''' || Genera el código QR con el logotipo y lo guarda<br /> |-<br /> | '''Seleccionar código QR a mostrar''' || Selección entre los códigos QR ya generados para visualizarlos<br /> |-<br /> | Botón '''MOSTRAR''' || Muestra el código QR seleccionado<br /> |-<br /> | Icono '''Papelera''' || Elimina el archivo QR seleccionado (con confirmación)<br /> |}<br /> <br /> 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.<br /> <br /> : '''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.<br /> <br /> == Pestaña «Acerca de» ==<br /> <br /> Muestra información sobre la versión del módulo, el autor y el enlace a la documentación.<br /> <br /> ----<br /> <br /> = Uso en las fichas =<br /> <br /> El módulo añade una pestaña '''Código QR''' en las fichas de los siguientes objetos:<br /> <br /> {| class="wikitable"<br /> ! Objeto !! Pestaña(s) añadida(s)<br /> |-<br /> | Cliente/Proveedor || Código QR + QR-Url (pestañas separadas)<br /> |-<br /> | Contacto || Código QR<br /> |-<br /> | Producto / Servicio || Código QR<br /> |-<br /> | Lote / Número de serie || Código QR<br /> |-<br /> | Almacén || Código QR<br /> |-<br /> | Presupuesto || Código QR<br /> |-<br /> | Pedido de cliente || Código QR<br /> |-<br /> | Pedido de proveedor || Código QR<br /> |-<br /> | Factura de cliente || Código QR<br /> |-<br /> | Factura de proveedor || Código QR<br /> |-<br /> | Contrato || Código QR<br /> |-<br /> | Intervención || Código QR<br /> |-<br /> | Proyecto || Código QR<br /> |-<br /> | Miembro (asociación) || Código QR<br /> |-<br /> | Grupo de usuarios || Código QR<br /> |-<br /> | Usuario || Código QR<br /> |-<br /> |}<br /> <br /> == Estructura común de la pestaña Código QR ==<br /> <br /> '''[Novedad v24]''' Cada pestaña de código QR ahora está organizada en '''cinco zonas''':<br /> <br /> === Zona 1 — Barra de ajustes ===<br /> <br /> [[File:Ultimateqrcode-v24-settings-panel-fr.png|center|900px|Panel de ajustes: tamaño, calidad ECC y selección de logotipo]]<br /> <br /> En la parte superior de cada pestaña de código QR, una barra de ajustes permite configurar:<br /> <br /> {| class="wikitable"<br /> ! Ajuste !! Descripción<br /> |-<br /> | '''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.<br /> |-<br /> | '''Calidad (ECC)''' || Nivel de corrección de errores: Bajo (L ≈ 7%), Medio (M ≈ 15%), Cuartil (Q ≈ 25%), Alto (H ≈ 30%).<br /> |-<br /> | '''Logotipo''' || Logotipo PNG que se incrustará en el centro del código QR, seleccionable entre los logotipos subidos.<br /> |}<br /> <br /> : '''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.<br /> <br /> 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).<br /> <br /> === Zona 2 — Tabla de selección de logotipo ===<br /> <br /> La tabla enumera los logotipos disponibles en el directorio <code>documents/mycompany/logos/</code>:<br /> <br /> {| class="wikitable"<br /> ! Columna !! Descripción<br /> |-<br /> | '''Radio''' || Botón de opción para seleccionar el logotipo (o «''Sin logotipo''»)<br /> |-<br /> | '''Logotipo''' || Nombre del archivo PNG con icono de vista previa<br /> |-<br /> | '''Tamaño''' || Tamaño del archivo en bytes<br /> |-<br /> | '''Fecha''' || Fecha de la última subida<br /> |-<br /> | '''Vista previa''' || Icono de lupa para previsualizar el logotipo<br /> |-<br /> | '''Acciones''' || Iconos para renombrar y eliminar<br /> |}<br /> <br /> Un formulario de subida al final de la página permite añadir nuevos logotipos PNG.<br /> <br /> : '''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.<br /> <br /> === Zona 3 — Código QR de datos configurables ===<br /> <br /> [[File:Ultimateqrcode-thirdparty-qrcode-top-fr.png|center|900px|Pestaña de código QR de un cliente/proveedor — selección de campos]]<br /> <br /> El usuario selecciona mediante casillas de verificación los '''campos que se incluirán en el código QR''':<br /> <br /> * La columna izquierda contiene la casilla de verificación<br /> * La columna central muestra la etiqueta del campo y su valor actual (en gris si no está marcado)<br /> * La columna derecha muestra el '''código QR generado''' (con o sin logotipo, según la selección)<br /> <br /> Los campos disponibles dependen del objeto:<br /> <br /> {| class="wikitable"<br /> ! Objeto !! Campos disponibles<br /> |-<br /> | Cliente/Proveedor || Empresa, Dirección, Código postal, Ciudad, País, Teléfono, Correo electrónico, URL + campos adicionales<br /> |-<br /> | Producto || Ref., Descripción, Detalle, Precio sin impuestos, Precio con impuestos, Código de barras, Peso, Volumen, URL + campos adicionales<br /> |-<br /> | Almacén || Etiqueta, Nombre corto de la ubicación, Descripción, Dirección, Código postal, Ciudad, País, URL + campos adicionales<br /> |-<br /> | Usuario || Login, Nombre, Apellidos, Teléfono, Móvil, Correo electrónico, Dirección, Código postal, Ciudad, País, URL + campos adicionales<br /> |-<br /> | Contacto || Tratamiento, Nombre, Apellidos, Empresa, Cargo, Teléfono, Móvil, Correo electrónico, Dirección, etc.<br /> |-<br /> | Factura || Ref., Ref. cliente, Empresa, Correo electrónico, Teléfono, Fecha de factura, Vencimiento, Total sin impuestos, Total con impuestos, Nota pública, URL<br /> |-<br /> | (otros) || Campos específicos del objeto<br /> |}<br /> <br /> : '''Nota:''' Los '''campos adicionales''' (atributos complementarios) definidos en Dolibarr se añaden automáticamente a la lista de campos disponibles.<br /> <br /> El código QR mostrado es '''clicable''': un clic abre la ventana de [[#Impresión_de_etiquetas|impresión de etiquetas]].<br /> <br /> === Zona 4 — Código QR de la URL de la ficha ===<br /> <br /> [[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]]<br /> <br /> La zona inferior muestra:<br /> <br /> * La etiqueta '''URL de la ficha [Objeto]'''<br /> * El enlace clicable a la ficha de Dolibarr<br /> * Un segundo '''código QR que codifica la URL directa''' hacia la ficha (también clicable para la impresión de etiquetas)<br /> * Los botones '''GUARDAR''' y '''CANCELAR'''<br /> <br /> === Zona 5 — Código QR vCard (Contacto, Usuario, Cliente/Proveedor, Miembro) ===<br /> <br /> [[File:Ultimateqrcode-v24-contact-vcard-fr.png|center|900px|Código QR vCard en una ficha de contacto]]<br /> <br /> Las fichas de '''Contacto''', '''Usuario''', '''Cliente/Proveedor''' (empresa) y '''Miembro''' disponen de un '''código QR vCard''' adicional al final de la página.<br /> <br /> 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.<br /> <br /> === Vista previa en tiempo real ===<br /> <br /> '''[Novedad v24]''' Los códigos QR se actualizan '''en tiempo real''' cuando el usuario modifica:<br /> * el tamaño del código QR<br /> * el nivel de calidad ECC<br /> * el logotipo seleccionado<br /> * los campos marcados (QR de datos)<br /> <br /> '''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.<br /> <br /> === Selección automática de campos por defecto ===<br /> <br /> 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.<br /> <br /> === Guardado de la configuración ===<br /> <br /> 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).<br /> <br /> ----<br /> <br /> = Pestaña Código QR — Ejemplos por objeto =<br /> <br /> == Factura de cliente ==<br /> <br /> '''[Novedad v24]'''<br /> <br /> [[File:Ultimateqrcode-v24-invoice-qr-complete-fr.png|center|900px|Pestaña de código QR de una factura con logotipo incrustado]]<br /> <br /> 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).<br /> <br /> == Producto ==<br /> <br /> [[File:Ultimateqrcode-product-qrcode-fr.png|center|900px|Pestaña de código QR de un producto]]<br /> <br /> 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.<br /> <br /> == Almacén ==<br /> <br /> [[File:Ultimateqrcode-stock-qrcode-fr.png|center|900px|Pestaña de código QR de un almacén]]<br /> <br /> Ú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.<br /> <br /> == Usuario ==<br /> <br /> [[File:Ultimateqrcode-user-qrcode-fr.png|center|900px|Pestaña de código QR de un usuario]]<br /> <br /> 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.<br /> <br /> : '''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.<br /> <br /> ----<br /> <br /> = Pestaña QR-Url (solo Clientes/Proveedores) =<br /> <br /> [[File:Ultimateqrcode-thirdparty-qrurl-fr.png|center|900px|Pestaña QR-Url de un cliente/proveedor con logotipo]]<br /> <br /> 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.<br /> <br /> Funcionalidades:<br /> <br /> {| class="wikitable"<br /> ! Elemento !! Función<br /> |-<br /> | '''Tamaño''' (1-10) || Resolución del código QR generado<br /> |-<br /> | '''Seleccionar archivo''' + '''SUBIR LOGOTIPO''' || Subir un logotipo PNG para incrustarlo en el centro<br /> |-<br /> | '''Seleccionar código QR a mostrar''' || Selección entre los códigos QR ya generados para este cliente/proveedor<br /> |-<br /> | Botón '''MOSTRAR''' || Muestra el código QR seleccionado<br /> |-<br /> | Sección '''Logotipos subidos''' || Lista de logotipos disponibles con opciones de descarga y eliminación<br /> |}<br /> <br /> El código QR mostrado codifica la URL de la ficha del cliente/proveedor, con el logotipo elegido en el centro de la imagen.<br /> <br /> ----<br /> <br /> = Impresión de etiquetas =<br /> <br /> [[File:Ultimateqrcode-label-print-fr.png|center|700px|Ventana de impresión de etiqueta 120×57mm]]<br /> <br /> 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).<br /> <br /> La etiqueta incluye:<br /> * '''A la izquierda''': el código QR de datos configurables<br /> * '''En el centro''': la información textual principal (referencia, descripción, nombre, etc. según el objeto)<br /> * '''A la derecha''': el código QR de la URL de la ficha<br /> <br /> La ventana lanza automáticamente el cuadro de diálogo de impresión del navegador.<br /> <br /> : '''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.<br /> <br /> ----<br /> <br /> = Derechos y permisos =<br /> <br /> [[File:Ultimateqrcode-permissions-fr.png|center|700px|Permisos del módulo UltimateQRcode]]<br /> <br /> El módulo define dos niveles de permisos, asignables por grupo de usuarios desde '''Configuración → Usuarios y grupos''':<br /> <br /> {| class="wikitable"<br /> ! Permiso !! Descripción !! Efecto<br /> |-<br /> | '''Read qrcode outcomes''' || Leer los códigos QR || Permite ver las pestañas de código QR y los códigos QR generados<br /> |-<br /> | '''Create/Modify qrcode outcomes''' || Crear/Modificar || Permite marcar o desmarcar los campos y guardar la configuración<br /> |}<br /> <br /> : '''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.<br /> <br /> ----<br /> <br /> = Novedades y compatibilidad con v24 =<br /> <br /> '''[Novedad v24]''' La versión 24 del módulo UltimateQRcode aporta las siguientes mejoras:<br /> <br /> == Nuevas funcionalidades ==<br /> <br /> {| class="wikitable"<br /> ! Funcionalidad !! Descripción<br /> |-<br /> | '''Ajustes por página''' || Tamaño, calidad ECC y logotipo configurables directamente en cada página de código QR de la ficha<br /> |-<br /> | '''Logotipo incrustado''' || Posibilidad de incrustar un logotipo PNG en el centro de cada código QR, en todas las páginas<br /> |-<br /> | '''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)<br /> |-<br /> | '''Código QR vCard''' || Código QR vCard para contactos, usuarios, clientes/proveedores y miembros, para añadirlos directamente a la agenda telefónica<br /> |-<br /> | '''Gestión de logotipos''' || Subida, vista previa, cambio de nombre y eliminación de logotipos directamente desde la interfaz de cada ficha<br /> |}<br /> <br /> == Compatibilidad con Dolibarr v24 ==<br /> <br /> {| class="wikitable"<br /> ! Corrección !! Detalle<br /> |-<br /> | '''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+.<br /> |-<br /> | '''Moneda''' || Sustitución de <code>$conf->currency</code> (obsoleto) por <code>getDolCurrency()</code>.<br /> |-<br /> | '''Constantes''' || Sustitución de la asignación directa <code>$conf->global->XXX = value</code> (obsoleta) por <code>dolibarr_set_const()</code>.<br /> |}<br /> <br /> == Correcciones de errores ==<br /> <br /> {| class="wikitable"<br /> ! Error !! Corrección<br /> |-<br /> | 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.<br /> |-<br /> | 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.<br /> |-<br /> | 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.<br /> |}<br /> <br /> == Traducciones ==<br /> <br /> 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.<br /> <br /> ----<br /> <br /> = FAQ =<br /> <br /> ; '''El código QR está vacío o muestra «Sin datos»'''<br /> : 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.<br /> <br /> ; '''La etiqueta no se imprime en el tamaño correcto'''<br /> : 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.<br /> <br /> ; '''Los campos adicionales no aparecen'''<br /> : Los atributos complementarios deben estar definidos en '''Configuración → Atributos complementarios''' para el objeto en cuestión.<br /> <br /> ; '''El código QR con logotipo no es legible'''<br /> : 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.<br /> <br /> ; '''El código QR se muestra sin logotipo aunque he seleccionado uno'''<br /> : 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.<br /> <br /> ; '''Los códigos QR no se actualizan al cambiar los ajustes'''<br /> : 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.<br /> <br /> ; '''La pestaña de código QR no aparece en algunas fichas'''<br /> : Compruebe que el módulo esté activado y que el usuario disponga del permiso '''Read qrcode outcomes'''.<br /> <br /> ----<br /> <br /> = Véase también =<br /> <br /> * [[Module_Ultimateqrcode_EN|English]]<br /> * [[Module_Ultimateqrcode_FR|Français]]<br /> * [[Module_Ultimateqrcode_DE|Deutsch]]<br /> * [[Module_Ultimateqrcode_IT|Italiano]]<br /> * [https://www.dolistore.com Dolistore]<br /> * [https://www.atoo-net.com Atoo-Net]</div>

Grandoc