Instalar un módulo Dolix
El procedimiento es el mismo para los 21 módulos. Se describe aquí una sola vez, y cada ficha remite a esta página en lugar de repetirlo a su manera. Cuente tres minutos.
Para actualizar el propio Dolibarr, y no un módulo, consulte las guías : Actualizar Dolibarr sin romper nada,Actualizar Dolibarr desde la línea de comandos (EN).
01
Requisitos
- Una instalación de Dolibarr en versión 19.0 o posterior (21.0 para Etiquetas en columna en las listas). La versión se muestra en InicioAcerca de, y al pie de cada página.
- PHP 7.4 o posterior, la versión mínima declarada por los 21 descriptores.
- La carpeta de módulos externos,
htdocs/custom/, presente y con permiso de escritura si usa la interfaz. - El módulo de Dolibarr del que depende el módulo instalado — Presupuestos o Terceros, según el caso. Cada ficha lo indica.
- Una cuenta de administrador, solo durante la activación.
02
Instalar desde la interfaz
Es el camino más corto, y el que hay que probar primero.
- Descargue el archivo zip del módulo desde el DoliStore a su ordenador.
- En Dolibarr, abra InicioConfiguraciónMódulos.
- Abra la pestaña «Instalar módulo externo», elija el zip y envíelo. Dolibarr lo descomprime él mismo en
htdocs/custom/. - El módulo aparece en la lista. Actívelo con el interruptor de su línea.
Si esta pestaña no aparece o si el envío falla, el envío de módulos se ha desactivado en esta instalación, o la carpeta custom no tiene permiso de escritura. Utilice entonces el método por archivo.
03
Instalar por archivo
Para un alojamiento compartido en el que el envío desde la interfaz está bloqueado, o para un servidor al que accede por SSH.
- Descomprima el zip en su ordenador.
- Envíe la carpeta obtenida a
htdocs/custom/, sin cambiarle el nombre. Debe obtener, por ejemplo,htdocs/custom/dolixmasse/core/modules/…, y nohtdocs/custom/dolixmasse/dolixmasse/…. - Compruebe que la cuenta del servidor web puede leer los archivos. Tras un envío por FTP, es la comprobación que resuelve la mayoría de los casos.
- Vuelva a cargar InicioConfiguraciónMódulos: el módulo figura en la lista. Actívelo.
04
Activar el módulo y conceder los permisos
La activación crea lo que el módulo necesita crear — su tabla de historial cuando tiene una, su atributo adicional cuando añade uno. No borra nada.
Los permisos se conceden después en InicioUsuarios y grupos, en la pestaña Permisos del usuario o del grupo correspondiente.
| Módulo | Permiso propio | Dónde aparece el módulo |
|---|---|---|
| Margen por día | Ninguno | Ninguna entrada de menú. El módulo aparece en la ficha y en la lista de presupuestos. |
| Cambio de dominio de correo electrónico | Sí | Menú Terceros«Cambiar un dominio de correo electrónico». |
| Modificación masiva | Sí | Menú Terceros«Modificación masiva». |
| Mover tareas entre proyectos | Sí | Menú Proyectos«Mover tareas». |
| Detección de duplicados | Sí | Menú Terceros«Duplicados». |
| Actualizar los precios de presupuestos y plantillas de factura | Sí | Una entrada: Financiera › Listado de plantillas › «Actualizar los precios de las plantillas». El botón también aparece en la ficha de un presupuesto en borrador y en la de una plantilla de factura. |
| Gastos de importación | Sí | Menú ProductosAlmacenes«Gastos de importación», y pestaña «Gastos de importación» en la ficha del pedido a proveedor. |
| Pendiente de facturar | Sí | Menú ComercialPedidos«Pendiente de facturar». Una pestaña «Pendiente de facturar» en cada pedido de cliente. |
| Listo para la actualización | Ninguno | Menú InicioHerramientas de administración«Listo para la actualización». |
| Menciones de IVA Europa | Ninguno | Ningún menú. En la ficha de la factura, una línea «Mención de IVA impresa» y el campo «Mención de IVA». Ajustes: ConfiguraciónMódulos«Menciones de IVA Europa». |
| Justificantes en los informes de gastos | Ninguno | Ninguna entrada de menú. El módulo actúa al generar el PDF del informe de gastos; sus ajustes están en ConfiguraciónMódulos. |
| Monedero TakePOS | Sí | Ninguna entrada de menú. Pestaña «Monedero» en la ficha del tercero y en la ficha del miembro; botón «Monedero» en la pantalla de pago de TakePOS. |
| Etiquetas Mondial Relay (Sendcloud) | Sí | Ninguna entrada de menú. Línea «Point Relais® Mondial Relay» y botones en la ficha del envío; acción masiva «Etiquetas Mondial Relay» en la lista de envíos. |
| Alertas de fecha límite de venta y de caducidad de los lotes | Sí | Menú Productos«Lotes a vigilar (fechas)». Panel «Lotes a vigilar (fecha límite de venta, fecha de caducidad)» en la página de inicio. |
| Aspecto TakePOS | Ninguno | Ninguna entrada de menú. La página de configuración se abre desde la lista de módulos; el aspecto se aplica por sí solo a la pantalla de caja de TakePOS. |
| Etiquetas en columna en las listas | Ninguno | Ninguna entrada de menú. La columna se añade a las listas nativas; los ajustes están en InicioConfiguraciónMódulos«Etiquetas en columna en las listas». |
| Renovación de afiliaciones en bloque | Sí | Menú Miembros«Renovación en bloque». Acción masiva «Renovar las afiliaciones (importe de cada miembro)» en el listado de miembros. Campo «Cuota personalizada» en la ficha del miembro. |
| Envases retornables | Sí | Menú Productos«Envases retornables»: vista de conjunto «Envases en los clientes» e informe «Considerados como vendidos». Pestaña «Envases retornables» en la ficha del tercero. |
| Venta en depósito | Sí | Menú Productos«Venta en depósito» (ventas por liquidar y liquidaciones). Pestaña «Depósito» en la ficha de tercero del depositante. |
| Albarán de entrega agrupado | Sí | Menú ProductosEnvíos«Albaranes de entrega agrupados». Acción masiva «Albarán de entrega agrupado (un solo PDF)» en el listado de envíos; línea «Albarán de entrega agrupado» en la ficha de una expedición agrupada. |
| Último precio cliente | Sí | Ninguna entrada de menú. Insignia bajo la línea de añadir de los presupuestos, pedidos y facturas a clientes en borrador; pestaña «Historique des prix» (Historial de precios) en la ficha del tercero; pestaña «Prix par client» (Precios por cliente) en la ficha del producto. |
05
Actualizar un módulo
- Obtenga la nueva versión en el DoliStore.
- Desactive el módulo en la lista de módulos. La desactivación no borra ningún dato: ni las tablas, ni los ajustes, ni los valores introducidos.
- Sustituya la carpeta del módulo en
htdocs/custom/por la nueva, o vuelva a enviar el zip desde la pestaña de instalación. - Vuelva a activar el módulo. Los ajustes y el historial se encuentran tal como estaban.
El historial de versiones de cada ficha se toma del archivo ChangeLog.md que se entrega con el módulo: no puede haber dos historias distintas.06
Desinstalar, y lo que queda en la base de datos
Desactivar un módulo hace desaparecer sus pantallas y sus columnas. Lo que ha escrito en la base de datos se queda — es deliberado, para que una desactivación por error no destruya nada. Esto es lo que abarca, módulo por módulo.
| Módulo | Lo que escribe en su base de datos |
|---|---|
| Margen por día | Ninguna tabla. La carpeta del módulo no contiene un directorio sql/. Al activarse, el módulo crea un campo adicional «Jornadas previstas» (código mpj_journees) en los presupuestos: el valor se guarda en la tabla de campos adicionales de los presupuestos, ya presente en Dolibarr. |
| Cambio de dominio de correo electrónico | Una tabla: llx_dolixdomaine_log. Registra el historial de las operaciones (fecha, usuario, dominio antiguo, dominio nuevo, número de terceros, contactos y miembros modificados, entidad). No se guarda en ella ningún dato de negocio. |
| Modificación masiva | Una tabla: llx_dolixmasse_log. Registra el historial de las operaciones (fecha, usuario, objeto, campo, filtro aplicado, nuevo valor, número de fichas modificadas, entidad). No se guarda en ella ningún dato de negocio. |
| Mover tareas entre proyectos | Una tabla: llx_dolixtaches_log. Registra el historial de movimientos (fecha, usuario, identificador de la tarea, su referencia y su etiqueta en el momento del movimiento, proyecto de origen, proyecto de destino, indicador de si se movieron los documentos, entidad). No se guarda en ella ningún dato de negocio. |
| Detección de duplicados | Una tabla: llx_dolixdoublons_log. Registra el historial de fusiones (fecha, usuario, tipo de objeto, ficha conservada, ficha fusionada, nombres de las dos fichas, entidad). |
| Actualizar los precios de presupuestos y plantillas de factura | Ninguna tabla, ningún atributo complementario. La carpeta del módulo no contiene ningún directorio sql/. El módulo solo guarda dos ajustes en las constantes de Dolibarr. |
| Gastos de importación | Cuatro tablas: llx_dolixapproche_dossier (expedientes de llegada: referencia, descripción, fecha de llegada, estado, nota), llx_dolixapproche_order (pedidos a proveedor vinculados a cada expediente), llx_dolixapproche_frais (gastos: descripción, tipo, importe sin IVA, clave de reparto, factura de proveedor vinculada) y llx_dolixapproche_journal (cada valor modificado, con el valor anterior y el nuevo, la cantidad, el stock y el importe, para poder anularlo). |
| Pendiente de facturar | Ninguna tabla. El módulo lee los pedidos, las facturas y los vínculos entre documentos; no escribe nada en la base de datos. Sus dos ajustes se guardan como constantes de Dolibarr: DOLIXRAF_INCLUDE_DRAFTS y DOLIXRAF_INCLUDE_SHIPMENTS. |
| Listo para la actualización | Ninguna tabla. El módulo no crea ninguna tabla, ningún ajuste ni ningún archivo: el informe se recalcula en cada solicitud y las descargas se generan al vuelo. |
| Menciones de IVA Europa | Ninguna tabla. Al activarse, el módulo añade a las facturas un campo adicional «Mención de IVA» (campo dolixtva_case, es decir, una columna de llx_facture_extrafields) y guarda sus ajustes como constantes. Si activa la corrección de la mención francesa, el texto corregido se guarda en las traducciones sustituidas de Dolibarr (tabla llx_overwrite_trans), como lo haría ConfiguraciónTraducción. |
| Justificantes en los informes de gastos | Ninguna tabla. La carpeta del módulo no contiene carpeta sql/. Al activarlo, el módulo guarda tres ajustes en las constantes de Dolibarr. Si se aparta un justificante, se guarda constancia en un pequeño archivo, documents/dolixjustif/quarantaine_ |
| Monedero TakePOS | Una tabla: llx_dolixpm_recharge. Guarda una línea por recarga (tercero, factura de depósito, importe, fecha, usuario, nota, entidad). El saldo no se almacena en ella: es la suma de los créditos disponibles de Dolibarr procedentes de esas facturas de depósito. |
| Etiquetas Mondial Relay (Sendcloud) | Una tabla: llx_dolixmr_envoi, una fila por envío (Point Relais elegido, envío Sendcloud, número de seguimiento, archivo de la etiqueta, estado, modo de prueba o real). Se añade un método de envío «Mondial Relay» al diccionario si no existe. Los ajustes son constantes de Dolibarr: DOLIXMR_SC_PUBLIC, DOLIXMR_SC_SECRET (cifrada), DOLIXMR_MODE_TEST y DOLIXMR_DOMICILE. |
| Alertas de fecha límite de venta y de caducidad de los lotes | Ninguna tabla. El módulo lee los lotes, sus fechas y su stock por almacén. Sus ajustes son constantes de Dolibarr: DOLIXDLC_DAYS, DOLIXDLC_SHIP_SELLBY, DOLIXDLC_SHIP_EATBY y DOLIXDLC_MAIL_TO. La activación del módulo añade además un panel en la página de inicio y una tarea programada, creada desactivada. |
| Aspecto TakePOS | Ninguna tabla. La carpeta del módulo no tiene carpeta sql/. Los ajustes son constantes de Dolibarr (DOLIXHAB_…): disposición, estilo, opciones, color encontrado en el logo. |
| Etiquetas en columna en las listas | Ninguna tabla. El módulo no tiene directorio sql/ y lee las etiquetas con la clase Categorie del núcleo. Sus nueve ajustes son constantes de Dolibarr, una por lista: DOLIXTAGS_LIST_ORDER, DOLIXTAGS_LIST_PROPAL, DOLIXTAGS_LIST_INVOICE, DOLIXTAGS_LIST_SUPPLIER_ORDER, DOLIXTAGS_LIST_SUPPLIER_INVOICE, DOLIXTAGS_LIST_THIRDPARTY, DOLIXTAGS_LIST_CONTACT, DOLIXTAGS_LIST_PRODUCT y DOLIXTAGS_LIST_PROJECT, puestas a 1 en la primera activación. |
| Renovación de afiliaciones en bloque | Ninguna tabla. La carpeta del módulo no contiene ningún directorio sql/. Al activarse, el módulo añade un campo complementario a los miembros, «Cuota personalizada» (código dolixcot_amount), y guarda un ajuste, DOLIXCOT_USE_LAST_AMOUNT. Las afiliaciones, asientos bancarios, facturas y pagos creados son objetos normales de Dolibarr. |
| Envases retornables | Una tabla: llx_dolixconsignes_mvt. Guarda una fila por movimiento de envase: cliente, producto envase, cantidad con signo (+ en el cliente, − devuelto o considerado vendido), valor de la fianza, tipo (factura, abono, saldo inicial, corrección, considerado vendido), fecha, factura y línea de origen, nota, usuario, entidad. Se añaden dos campos a los productos (dolixcons_consigne y dolixcons_delai), y el plazo de devolución por defecto se guarda como constante de Dolibarr: DOLIXCONS_DEFAULT_DELAY. |
| Venta en depósito | Dos tablas: llx_dolixdv_releve, una fila por liquidación (referencia, depositante, periodo, modo, totales, comisión, facturas creadas, autor, fecha), y llx_dolixdv_line, una fila por venta liquidada, con una clave única sobre la línea de factura para que una venta nunca se liquide dos veces. Tres campos adicionales: «Depositante (venta en depósito)» y «Comisión de venta en depósito (%)» en los productos, «Comisión de venta en depósito (%)» en los terceros. Tres ajustes guardados como constantes de Dolibarr: DOLIXDV_DEFAULT_COMMISSION, DOLIXDV_COMMISSION_BASE y DOLIXDV_MODE. |
| Albarán de entrega agrupado | Dos tablas: llx_dolixblg (un albarán agrupado: referencia, cliente, nota, usuario, fecha de creación, entidad) y llx_dolixblg_exp (las expediciones de cada albarán, en el orden de impresión). El PDF se guarda en documents/dolixblgroupe/, en una carpeta con el nombre de la referencia del albarán. Las tablas de las expediciones y de los pedidos solo se leen. |
| Último precio cliente | Ninguna tabla. El módulo lee las líneas de las facturas, pedidos y presupuestos a clientes; no escribe nada en esos documentos. Sus ajustes se guardan como constantes de Dolibarr: DOLIXDERNIERPRIX_SEARCH_INVOICES, DOLIXDERNIERPRIX_SEARCH_ORDERS, DOLIXDERNIERPRIX_SEARCH_PROPALS, DOLIXDERNIERPRIX_ONLY_VALIDATED, DOLIXDERNIERPRIX_AUTO_APPLY, DOLIXDERNIERPRIX_COPY_DISCOUNT y DOLIXDERNIERPRIX_MAX_AGE_MONTHS. |
07
Si el módulo no aparece
Cinco comprobaciones, en este orden. Cubren la mayoría de los casos.
- ¿Está la carpeta en el lugar correcto? La carpeta del módulo debe estar directamente en htdocs/custom/ y llevar exactamente su nombre técnico — el que se indica en su ficha. Una carpeta anidada dos veces (custom/dolixmasse/dolixmasse) es la causa más frecuente.
- ¿Puede el servidor web leer los archivos? Tras descomprimir por FTP o por SSH, los archivos pertenecen a veces a una cuenta distinta de la del servidor web. El módulo queda entonces invisible en la lista.
- ¿Es la versión de Dolibarr suficientemente reciente? Los 21 módulos exigen Dolibarr 19.0 o posterior (21.0 para Etiquetas en columna en las listas) y PHP 7.4 o posterior. La versión de Dolibarr se muestra en InicioAcerca de.
- ¿Está activado el módulo del que depende? Cada ficha indica el módulo de Dolibarr que hay que activar primero — Presupuestos o Terceros, según el caso. Sin él, la pantalla esperada no aparece.
- ¿Se han concedido los permisos? Un módulo activado pero sin ningún permiso concedido queda invisible para el usuario. Los permisos se conceden en InicioUsuarios y grupos, pestaña Permisos.
¿Nada de lo anterior?
Escriba a support@dolix.fr con su versión de Dolibarr, el módulo afectado y su versión, y el mensaje de error copiado tal cual.