Administración

Listo para la actualización

dolixmaj · versión 1.0.3

Antes de actualizar Dolibarr, usted sabe qué bloqueará, qué se romperá y qué hacer antes. El módulo no modifica nada.

Precio
Gratuito
Dolibarr
16.0 mínimo
Versión
1.0.3
Licencia
GPL v3+
Idiomas
Francés, inglés, alemán, español

Gratuito.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Descargar en el DoliStore — gratuito
Informe de una instancia de prueba en 18.0.9 que apunta a la 24.0: «Pas encore prêt : 1 action(s) avant de monter» (todavía no listo: 1 acción antes de subir). El módulo ficticio DemoFutur se rompe desde la 20.0, así que se puede subir hasta la 19.0.4 sin tocar nada. Debajo: la línea de seguridad, el camino etapa por etapa y el plan en orden.
Informe de una instancia de prueba en 18.0.9 que apunta a la 24.0: «Pas encore prêt : 1 action(s) avant de monter» (todavía no listo: 1 acción antes de subir). El módulo ficticio DemoFutur se rompe desde la 20.0, así que se puede subir hasta la 19.0.4 sin tocar nada. Debajo: la línea de seguridad, el camino etapa por etapa y el plan en orden. Captura de la interfaz en francés.
01

Lo que hace el módulo

  • Usted elige la versión de destino, desde la siguiente versión mayor hasta la 24.0, y el PHP previsto después de la actualización. La comprobación no modifica nada: ni la base de datos, ni los archivos, ni los módulos.
  • El código de cada módulo externo se lee archivo por archivo, sin ejecutarlo, y se compara con cada versión del camino: funciones, clases, métodos, archivos, columnas, hooks y eventos eliminados; métodos sobrescritos que se han vuelto incompatibles; funciones y sintaxis rechazadas por el PHP previsto. Cada hallazgo indica el archivo, la línea, la versión en la que se rompe y, cuando se conoce, el sustituto.
  • Para cada módulo, una tasa de cobertura: la parte de las llamadas realmente comprobadas. El código cifrado (ionCube, SourceGuardian, Zend Guard) se señala como no comprobable.
  • Los demás controles: archivos y base de datos en versiones distintas, última versión correctiva de su rama, PHP en cada etapa y momento de cambiarlo, extensiones PHP y memory_limit, codificaciones mezcladas y tablas MyISAM, módulos del núcleo activos que desaparecen, archivos del núcleo modificados, ausentes o sobrantes, traducciones sobrescritas, modelos ODT, fórmulas de campos adicionales rechazadas a partir de la 23, copia de seguridad reciente, clave del registro inalterable para la 24, bloqueo de instalación, permisos de conf.php.
  • El informe empieza con una respuesta en una línea, la versión más alta alcanzable sin tocar nada, el camino etapa por etapa y el plan en orden. También dice si la versión instalada y la de destino siguen recibiendo correcciones de seguridad, qué hay que copiar y qué etapa reescribe más datos.
  • Cada hallazgo tiene un nivel (sin problema, por comprobar, bloqueante o no comprobable) con lo que hay que hacer y la fuente de la regla.
  • Informe descargable en HTML o en Markdown. La opción «anonimizar» oculta el dominio, las rutas, el nombre de la empresa y el identificador del usuario. Para cada módulo afectado, un «informe para el editor» que enviarle: archivos, líneas, corrección conocida, nada sobre su empresa ni su servidor.
  • Nunca se muestra ni se exporta ninguna contraseña ni clave: para conf.php, el módulo solo dice si una clave está presente.
  • Una sola conexión posible: la casilla de integridad de los archivos del núcleo solo viene marcada de oficio si la firma oficial de su versión ya está en install/, y la comparación se hace entonces sin red. Si no, queda desmarcada: al marcarla se autoriza la descarga de la firma desde dolibarr.org. Con la casilla desmarcada, el módulo no se conecta a nada.
  • Interfaz en francés, inglés, alemán y español. Funciona con MySQL/MariaDB y PostgreSQL.
02

Para quién es

Aplaza una y otra vez la actualización de Dolibarr porque no sabe qué se romperá: un módulo externo, la versión de PHP, una personalización.

Una actualización de Dolibarr no se hace de una vez: el asistente pasa las versiones mayores una por una, de la 18 a la 19, después a la 20, y cada una puede romper algo. Un módulo externo que llama a una función eliminada, un PHP demasiado antiguo para la versión siguiente o demasiado reciente para la versión actual, una tabla con una codificación distinta de las demás, un archivo del núcleo modificado a mano que se sobrescribirá.

La wiki oficial pide asegurarse de que los módulos son compatibles, sin decir cómo. Así que se aplaza la actualización, y la distancia crece con cada versión.

La actualización en sí se describe paso a paso en dos guías probadas: Actualizar Dolibarr sin romper nada y Actualizar Dolibarr por línea de comandos (en inglés).

Para quién es: Administradores de una instancia Dolibarr 16 a 23 que preparan una actualización, sobre todo con módulos externos o archivos del núcleo modificados. Proveedores de servicios que quieren una visión de conjunto antes de intervenir.

03

Lo que el módulo no hace

Este apartado figura en las 21 fichas de módulos, sin excepción.

  • El módulo no realiza la actualización. No ejecuta ningún script, no repara nada, no desactiva ningún módulo: los comandos de reparación se indican, nunca se ejecutan.
  • Las versiones de destino son las versiones mayores que conocen sus datos, hasta la 24.0. Una versión publicada después del 25 de septiembre de 2026 no se conoce: hace falta una nueva versión del módulo. En una 24, no se propone ninguna versión de destino.
  • El análisis lee el código sin ejecutarlo. Las llamadas dinámicas y el código cifrado no se pueden comprobar: la tasa de cobertura lo muestra, módulo por módulo. Solo una prueba sobre una copia demuestra que un módulo funciona.
  • Duración limitada: 60 segundos en total para el análisis del código, 30 segundos como máximo por módulo. Los archivos de más de 2 MB y las carpetas vendor, node_modules e includes de los módulos no se analizan. Lo que no se ha leído se indica.
  • Para las copias de seguridad, el módulo busca un archivo reciente en documents/admin/backup. No comprueba que se pueda restaurar, y no ve una copia hecha en otro lugar, en su proveedor de alojamiento por ejemplo.
  • No prevé los errores de la versión de destino, el comportamiento de los scripts de migración con sus datos ni los efectos en el negocio: presentación de los PDF, IVA, integraciones externas.
  • Si Dolibarr ya no arranca, el módulo tampoco puede abrirse.
  • Solo para administradores: ningún permiso lo pone a disposición de otro usuario.
04

Cómo funciona

Usted elige la versión de destino, desde la siguiente versión mayor hasta la 24.0, y el PHP previsto después de la actualización. Hace clic en «Lanzar la comprobación». El módulo lee su instalación sin modificar nada y entrega un informe.

El código de sus módulos externos

Es la parte principal del módulo. El código de cada módulo externo se lee archivo por archivo, sin ejecutarlo, y se compara con los cambios de cada versión del camino, no solo de la versión de destino:

  • funciones, clases, métodos, propiedades, constantes y archivos del núcleo eliminados;
  • métodos sobrescritos que se han vuelto incompatibles con los de Dolibarr;
  • llamadas con menos argumentos de los que Dolibarr exige ahora;
  • columnas y tablas eliminadas en las consultas SQL del módulo;
  • hooks y eventos de trigger que ya no se llaman;
  • funciones, constantes y sintaxis rechazadas por el PHP previsto.

Cada hallazgo indica el archivo, la línea, la versión en la que se rompe, un grado de certeza y, cuando se conoce, el sustituto. Cada módulo recibe una tasa de cobertura: la parte de las llamadas realmente comprobadas. El código cifrado (ionCube, SourceGuardian, Zend Guard) se señala como no comprobable.

Las otras nueve familias de controles

Familia Lo que se comprueba
Camino versión de los archivos y de la base de datos desfasadas, última versión correctiva de su rama, número de etapas
PHP PHP en cada etapa, momento de cambiarlo, extensiones comprobadas por el instalador, memory_limit, max_execution_time
Base de datos versión del servidor, codificaciones mezcladas, tablas MyISAM, tamaño
Módulos del núcleo módulos activos que desaparecen: WebServicesClient (21), ExternalSite y OpenIDConnect (23), Deplacement y Paybox (24)
Integridad archivos del núcleo modificados, ausentes o sobrantes, comparados con la firma oficial de su versión
Personalizaciones traducciones sobrescritas, modelos ODT, menú o tema no estándar, módulos experimentales, fórmulas de campos adicionales rechazadas a partir de la 23
Copia de seguridad copia de seguridad de menos de 24 horas en documents/admin/backup, exec() disponible, espacio en disco
Claves presencia del identificador de instancia y de la clave de cifrado, formato de la clave del registro inalterable para la 24
Asistente bloqueo de instalación, permisos de conf.php, carpeta .git, carpeta documents dentro de la carpeta web

El informe

Empieza con una respuesta en una línea (listo, casi listo o todavía no listo) y después la versión más alta alcanzable sin tocar nada, el camino etapa por etapa y el plan en orden. También dice si la versión instalada y la versión de destino siguen recibiendo correcciones de seguridad, qué hay que copiar y qué etapa reescribe más datos.

Cada hallazgo tiene un nivel (sin problema, por comprobar, bloqueante o no comprobable) con lo que hay que hacer y la fuente de la regla.

El informe se descarga en HTML o en Markdown. La opción anonimizar oculta el dominio, las rutas, el nombre de la empresa y el identificador del usuario. Para cada módulo afectado, el botón informe para el editor genera un archivo para enviárselo: archivos, líneas, corrección conocida, nada sobre su empresa ni su servidor.

Lo que el informe no puede garantizar

El propio informe lo dice, al pie de página: reduce los riesgos conocidos, no garantiza el éxito de la actualización. No demuestra que un módulo externo vaya a funcionar (solo una prueba sobre una copia puede hacerlo), no prevé los errores de la versión de destino ni el comportamiento de los scripts de migración con sus datos, y no comprueba que una copia de seguridad se pueda restaurar.

El análisis del código está limitado: 60 segundos en total, 30 segundos como máximo por módulo. Los archivos de más de 2 MB y las carpetas vendor, node_modules e includes de los módulos no se leen, y el informe lo indica. Las versiones de destino se detienen en la 24.0: los datos de referencia del módulo están actualizados a 25 de septiembre de 2026.

La herramienta se encuentra en InicioHerramientas de administración«Listo para la actualización». Las capturas siguientes se hicieron con la interfaz en francés.

El informe de una instancia de prueba en 18.0.9 que apunta a la 24.0: «Pas encore prêt : 1 action(s) avant de monter» (todavía no listo: 1 acción antes de subir). El módulo ficticio DemoFutur se rompe desde la 20.0: se puede subir hasta la 19.0.4 sin tocar nada. Siguen la línea de seguridad (la 18.0 ya no recibe correcciones), el camino de la 18.0 a la 24.0 y el plan: obtener del editor una versión compatible, después pasar a la 18.0.10 y subir una etapa cada vez.

La pantalla de inicio: la versión de destino, 24.0 (24.0.1), el PHP previsto después de la actualización y la casilla «Intégrité des fichiers du cœur» (integridad de los archivos del núcleo).

El bloque «Vos modules» (sus módulos). Para DemoFutur, una clase eliminada en la 20.0 y una función eliminada en la 23.0, con el archivo, la línea y el sustituto, «code analysé à 100 % (2 appels vérifiés sur 2)» (código analizado al 100 %, 2 llamadas comprobadas de 2) y el botón «Rapport pour l’éditeur» (informe para el editor). DemoCasse, inactivo e incompatible, debe eliminarse.

La pantalla de inicio, en 18.0.9: versión de destino 24.0 (24.0.1), PHP después de la actualización y la casilla «Intégrité des fichiers du cœur» (integridad de los archivos del núcleo).
La pantalla de inicio, en 18.0.9: versión de destino 24.0 (24.0.1), PHP después de la actualización y la casilla «Intégrité des fichiers du cœur» (integridad de los archivos del núcleo). Captura de la interfaz en francés.
El bloque «Vos modules» (sus módulos): para el módulo ficticio DemoFutur, una clase eliminada en la 20.0 y una función eliminada en la 23.0, con el archivo, la línea y el sustituto, la parte del código analizada y el botón «Rapport pour l'éditeur» (informe para el editor). DemoCasse, inactivo e incompatible, debe eliminarse.
El bloque «Vos modules» (sus módulos): para el módulo ficticio DemoFutur, una clase eliminada en la 20.0 y una función eliminada en la 23.0, con el archivo, la línea y el sustituto, la parte del código analizada y el botón «Rapport pour l'éditeur» (informe para el editor). DemoCasse, inactivo e incompatible, debe eliminarse. Captura de la interfaz en francés.
06

Seguridad y salvaguardas

  • Reservado a los administradores. El menú y cada página comprueban que el usuario es administrador de Dolibarr; otro usuario recibe «Acceso denegado». El módulo no tiene permiso propio.
  • Solo lectura. La comprobación no escribe nada, ni en la base de datos ni en el disco. Durante las pruebas, se tomó una huella completa de la base de datos y de los archivos antes y después de una comprobación: era idéntica.
  • Token anti-CSRF en cada acción: comprobación, descargas, informe para el editor.
  • Ningún secreto mostrado ni exportado. Para conf.php, el módulo solo dice si una clave está presente, nunca su valor.
  • Ningún comando ejecutado. Las reparaciones, como armonizar la codificación de las tablas, se indican, nunca se ejecutan.
  • Una sola conexión posible. La casilla de integridad de los archivos del núcleo solo viene marcada de oficio si la firma oficial de su versión ya está en install/: la comparación se hace entonces sin red. Si no, queda desmarcada, y es al marcarla cuando se autoriza la descarga de la firma desde dolibarr.org. Con la casilla desmarcada, el módulo no se conecta a nada.
07

Lo que se entrega

Lo que el módulo escribe en su instalación
Tablas creadas en la base de datosNinguna 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.
PermisosNingún permiso propio. El menú y cada página están reservados a los administradores de Dolibarr: un usuario que no es administrador no ve el menú y recibe un acceso denegado si abre la página.
Desinstalación
  • Desactive el módulo en ConfiguraciónMódulos. El menú desaparece.
  • El módulo no ha creado ninguna tabla ni ningún ajuste: no hay nada que limpiar en la base de datos.
  • Los informes ya descargados se quedan en su equipo. No se conserva ningún informe en el servidor.
  • La carpeta dolixmaj, en claro, con licencia GPL v3 o posterior: la página de la herramienta, una página «Acerca de» sin ajustes, las clases de comprobación y de análisis del código, y los datos de referencia de Dolibarr 16.0 a 24.0.2 (data/).
  • Las traducciones presentes en langs/: francés (fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES).
  • Un README.md y un ChangeLog.md.
  • Dolibarr 16.0 mínimo, PHP 7.0 mínimo, MySQL/MariaDB y PostgreSQL. Instalado y ejecutado en 16.0.5, 17.0.4, 18.0.9, 18.0.10, 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.0, 24.0.1 y 24.0.2.
  • No se crea ninguna tabla, no se guarda ningún ajuste. Solo la activación del módulo registra, como para cualquier módulo, su estado y su menú.
  • No se conserva nada en el servidor: el informe se recalcula en cada solicitud, las descargas se generan al vuelo.
  • Los informes descargados se quedan en su equipo. Anonimizados, no contienen ni el dominio, ni las rutas, ni el nombre de la empresa, ni el identificador del usuario.
  • Al desactivarlo, el menú desaparece. No hay nada que limpiar en la base de datos.
08

Compatibilidad

El descriptor del módulo solo declara una versión mínima. En el código no figura ningún límite superior: las versiones siguientes son aquellas en las que el módulo se ha ejecutado de verdad.

Compatibilidad del módulo Listo para la actualización
Versiones de DolibarrDolibarr 16.0 mínimo. Instalado y ejecutado en 16.0.5, 17.0.4, 18.0.9, 18.0.10, 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4, 24.0.0, 24.0.1 y 24.0.2.
PHP mínimo7.0
Módulos de Dolibarr que activarNinguno
LicenciaGPL v3 o posterior, código fuente completo
IdiomasFrancés, inglés, alemán, español
MenúMenú InicioHerramientas de administración«Listo para la actualización».
09

Instalación

  1. Obtenga el módulo, gratuito, en el DoliStore y descargue el archivo zip.
  2. En Dolibarr: InicioConfiguraciónMódulospestaña «Instalar módulo externo», y después suba el zip. Si no, descomprima la carpeta dolixmaj en htdocs/custom/.
  3. Active «Listo para la actualización» en la lista de módulos. No se crea ninguna tabla.
  4. Abra InicioHerramientas de administración«Listo para la actualización». El menú solo se muestra a los administradores.
  5. Elija la versión de destino y el PHP previsto, marque o desmarque el control de integridad y haga clic en «Lanzar la comprobación».

El detalle — permisos de la carpeta custom, alojamiento compartido, actualizaciones, desinstalación — está en la página Instalación y actualizaciones.

10

Preguntas frecuentes

¿En qué versiones de Dolibarr funciona este módulo?

El descriptor exige Dolibarr 16.0 como mínimo y PHP 7.0 como mínimo. El módulo se ha instalado y ejecutado en 16.0.5, 17.0.4, 18.0.9, 18.0.10, 19.0.4, 20.0.4, 21.0.4, 22.0.5, 23.0.4 y 24.0.0. Las versiones de destino que propone llegan hasta la 24.0: sus datos de referencia están actualizados a 25 de septiembre de 2026. En una 24, por tanto, todavía no tiene una versión más reciente que proponer.

¿La comprobación puede modificar mi base de datos?

No. El módulo no crea ninguna tabla y no escribe nada, ni en la base de datos ni en el disco. Durante las pruebas, se tomó una huella completa de la base de datos y de los archivos antes y después de una comprobación: era idéntica. Solo la activación del módulo registra, como para cualquier módulo, su estado y su menú.

¿El informe garantiza el éxito de la actualización?

No. Reduce los riesgos conocidos. No puede demostrar que un módulo externo vaya a funcionar, ni prever los errores de la versión de destino o el comportamiento de los scripts de migración con sus datos. Haga una copia de seguridad completa y, si es posible, pruebe primero sobre una copia.

¿Qué fiabilidad tiene el análisis del código de los módulos?

El 26 de septiembre de 2026 se comparó con 45 módulos libres actualizados de verdad desde su versión de origen hasta la 24: los 10 errores fatales observados durante esas actualizaciones habían sido todos anunciados. El banco de pruebas solo abría páginas, sin introducir datos: este resultado solo vale para lo que observó. Para cada módulo, el informe muestra la parte del código que ha podido comprobar.

¿Y si lo desinstalo?

El menú desaparece. El módulo no ha creado ninguna tabla ni ningún ajuste, así que no hay nada que eliminar. Los informes descargados se quedan en su equipo.

¿El módulo es realmente gratuito?

Sí: 0 € en el DoliStore, con licencia GPL v3 o posterior. Cuando algo bloquea, el informe en pantalla muestra una línea que remite al servicio de pago «Actualización segura» de Dolix, y el pie del informe muestra «¿Necesita ayuda con esta actualización? Dolix — dolix.fr». Ninguno de los dos aparece en las exportaciones anonimizadas.

¿Quién atiende el soporte, y cómo funcionan las actualizaciones?

El soporte lo presta la persona que escribió el módulo, en support@dolix.fr. La descarga está en el DoliStore, donde se publican las nuevas versiones. Las versiones de Dolibarr que conoce el módulo están en sus datos integrados: para apuntar a una versión publicada después de la 24.0, hará falta una nueva versión del módulo.

11

Historial de versiones

Tomado del archivo ChangeLog.md del módulo: una sola fuente.

1.0.33 de noviembre de 2026

Interfaz traducida al español (es_ES). Probado en 19.0.4 a 24.0.2 con Dolibarr en español.

1.0.214 de octubre de 2026

Dolibarr 24.0.2 conocida: en una 24.0.0 o 24.0.1, el módulo indica la 24.0.2 como última versión correctiva, y el control de la clave del registro inalterable aconseja apuntar a la 24.0.2. API del núcleo 24.0 revisada sobre el código de la etiqueta 24.0.2. Una versión correctiva publicada después de los datos del módulo (por ejemplo, una futura 24.0.3) se señala claramente, sin pretender conocerla. Datos de referencia a 14 de octubre de 2026.

1.0.112 de octubre de 2026

Corrección: la casilla «Intégrité des fichiers du cœur» (integridad de los archivos del núcleo) ya solo viene marcada de oficio si la firma oficial de su versión ya está en el servidor (comparación sin red). Si no, queda desmarcada, y es al marcarla cuando se autoriza la descarga desde dolibarr.org: ninguna llamada de red sin su consentimiento.

1.0.027 de septiembre de 2026

Primera versión: comprobación en solo lectura de una instancia Dolibarr 16.0 a 24.0 frente a una versión de destino. Diez familias de controles, entre ellas la lectura del código de los módulos externos. Informe en pantalla, descargable en HTML y en Markdown, anonimizable: respuesta en una línea, versión más alta alcanzable sin tocar nada, camino, plan de acción. Estado de seguridad de la versión instalada y de la de destino, preparación de la interrupción del servicio, informe para enviar al editor de un módulo. Francés, inglés, alemán. Datos de referencia de Dolibarr actualizados a 25 de septiembre de 2026, versiones 16.0 a 24.0.1.

12

Soporte de este módulo

Escriba a support@dolix.fr. Responde la persona que escribió el módulo.

Respuesta en un plazo de dos días laborables. No es un servicio de guardia.

Qué incluir en su mensaje

  • La versión exacta de Dolibarr.
  • El módulo afectado y su versión — aquí dolixmaj 1.0.3.
  • Lo que ha hecho, y lo que esperaba.
  • El mensaje de error copiado tal cual, o una captura de pantalla.
  • Cómo está instalado Dolibarr, si lo sabe.

Este módulo está disponible gratuitamente en el DoliStore.

El pedido, el pago, la factura y la descarga corren a cargo del DoliStore.

Descargar en el DoliStore — gratuito
También

Los demás módulos