Ir al contenido
JoeCMS Descargar 3.1.5

Changelog

Cada versión de JoeCMS, descrita por lo que cambia para quien la usa.

3.1.5

8 nov 2026 Última versión estable

Seguridad 1 entrada

  • /install cerrado en los sitios instalados. Cuando el sitio ya está configurado, el instalador antiguo rellena su formulario con la configuración en uso, contraseñas de la base de datos y del SMTP incluidas, y acepta el envío del formulario (frmAction=install). Era accesible desde la ruta pública /install sin ningún login. Ahora, en un sitio instalado, el instalador solo se abre desde el back office (Configuración → Básica, /admin/configuration/install, donde el login lo pide el CMS); cualquier otra dirección, /install incluida en todas sus variantes (/INSTALL, /install/, ?setup), responde 404. El control está al principio del instalador, así vale cualquiera que sea el camino que lleve hasta él. (conf/gallery/install/index.php; manual 01)

Corregido 3 entradas

  • Un store inalcanzable ya no tumba la página. Con DEBUG_MODE activo, un isError() sobre un storage no configurado — típicamente las estadísticas de página en MongoDB, que una instalación nueva no tiene — imprimía la ficha de error y cerraba la página en lugar de la página pedida: /login respondía con el error del CMS y parecía roto. Ahora ese caso escribe una línea en cache/logs/…_storage_nosql.txt y la página sigue. Con el debug desactivado la página ya salía: el error iba a …_error_critical.txt, ahora va al log del storage. La rama SQL queda como estaba: una base de datos relacional que falta debe hacerse notar (vendor/wolfgan/storage/Storage.php, controller_nosql).
  • /install ya no responde 500. Un GET /install en un sitio ya instalado — por ejemplo el rastreo de un crawler — acababa en un E_USER_ERROR («Catrina: Percorso Riservato. Verificare perche entra qui»), por tanto en una página de error y en un aviso en Sentry. cmsRouter::regexp() expandía * a (.*) incluso dentro de un grupo ya escrito a mano, así la source ^/install(.*) se convertía en ^/install(.(.*)) y ya no coincidía con la URL corta: el kernel reconocía la página, su ruta no, y el caso service/updater de system_init_on_before_routing() caía — por un // no break — en el caso actex, que lanza el error fatal. El mismo final para /updater/check, cuya página ni siquiera tiene un router. Ahora * se convierte en (.*) solo fuera de los grupos, y si la ruta de la página no cierra la petición se continúa: la toma el router del Content Manager, y una ruta que no existe responde 404. (vendor/wolfgan/cms/services/router.php, library/gallery/system/init.php; manual 01 §2)
  • El instalador se abre en PHP 8. Desde el back office (Configuración → Básica) la página salía vacía por tres casos que en PHP 7 eran warnings y en PHP 8 son fatales: el control ini_get("mysql.max_persistent") (directiva de ext/mysql, eliminada en PHP 7: ini_get() devuelve false, la comparación con -1 falla siempre y el instalador se declaraba crítico imprimiendo solo «mysql.max_persistent must be Unlimited»); VG_SITE_ADMININSTALL, constante que nadie define, leída en la comparación; cm_getClassByFrameworkCss("", "link", null, "bootstrap"), que pasa el nombre del framework donde hace falta la estructura ya resuelta. Además la rama final redirigía a /setup, URL que en un sitio JoeCMS no existe: ahora redirige a la misma URL con ?setup. Las constantes FTP_*, que solo definía el antiguo config.updater.php, se leen con defined(): sin credenciales se ve «FTP Path unavailable» en lugar de un fatal. (conf/gallery/install/index.php, conf/gallery/install/common.php, library/FF/common/framework-css.php)

3.1.3

31 oct 2026

Corregido 2 entradas

  • Los POST por ajax llegan al módulo, no a la página de la que salen. Para cada petición XHR en una página pública, library/gallery/system/init.php intenta primero generar las secciones de la página del Referer, y si sale algo responde con ellas y termina. Sirve para recargar los bloques, pero atrapaba también los envíos: un POST a /registrazione enviado desde la página de inicio recibía su HTML y la cuenta no se creaba. Desde la página /registrazione funcionaba, porque allí las secciones están vacías. Ahora los POST ya no toman ese camino; las recargas en GET siguen como antes. (manual 01 §2, 08)
  • La caché de página ya no guarda ni sirve las respuestas a los POST. La clave de un archivo en caché contiene los parámetros de la petición, campos del formulario incluidos: la respuesta equivocada del punto anterior se guardaba, y quien reenviaba los mismos datos la recibía de la caché, incluso desde la página correcta. check_static_cache_page() ahora descarta los POST antes de buscar el archivo y apaga la escritura (DISABLE_CACHE). (library/gallery/system/cache.php; manual 12 §2)

3.1.2

30 oct 2026

Corregido 1 entrada

  • bin/deploy.sh se hace ejecutable solo. Un proyecto nacido copiando los archivos de cms recibía el script sin el bit de ejecución, y ./bin/deploy.sh respondía permission denied en cada proyecto nuevo. Lanzado una vez con bash bin/deploy.sh, ahora el script vuelve a poner el bit en disco y en el índice de git y pide hacer commit. (bin/deploy.sh, docs/manuale/14-ambienti-e-deploy.md)

3.1.1

26 oct 2026

Corregido 4 entradas

  • Un archivo de caché escrito a medias ya no tumba la página. Filemanager::save() escribía el archivo en su sitio con file_put_contents(..., LOCK_EX): dos peticiones que reescribían el mismo archivo (el índice de los documentos de error, que los bots hacen crecer con URL inventadas) podían dejarle a otra una copia truncada, e incluirla daba un ParseError fatal (Sentry 155604961). Ahora se escribe un archivo temporal y se renombra, lo que es atómico, y se invalida la OPcache del archivo. Un archivo corrupto que se lee de todos modos se borra y se rehace en la escritura siguiente, en lugar de detener la petición; antes, en PHP 8, esa rama fallaba también por la constante Filemanager::DEBUG, que no existía. Corregida la precedencia en SEARCH_IN_KEY || SEARCH_IN_BOTH && isset (fs_php.php, fs_xml.php): una clave ausente devolvía array($chiave => null), que cuenta como verdadero; ahora no se devuelve (vendor/wolfgan/filemanager/; manual 11 §3). El índice de los documentos de error sigue escrito y nunca leído, a propósito: cache_get_error_document() lo llama con los argumentos invertidos, y ponerlos en orden convertiría en 404 una página sana cada vez que el índice está corrupto (library/gallery/system/cache.php).
  • AGENTS.md ya no va al servidor. bin/deploy.sh dejaba fuera CLAUDE.md y MEMORY.md, pero no AGENTS.md, el archivo de instrucciones que leen Antigravity, Cline y los demás asistentes de IA: con el despliegue acababa en la docroot, descargable por cualquiera como el resto de la documentación interna. Ahora se queda fuera como los otros dos. En un sitio ya desplegado la copia en línea hay que quitarla a mano.
  • Un módulo puede tener /api en sus rutas. El kernel y la regla api del core se quedaban con cualquier ruta que contuviera /api — /jd/api/me de un módulo, /apicoltura — y la mandaban a la REST interna del framework, que respondía 404 con el cuerpo vacío antes de que se llegara al módulo o a la página. Ahora /api está reservado solo como primer segmento, y lo mismo /srv en la regla services (antes capturaba también /blog/srvizio). Una ruta con prefijo de idioma (/en/api/…) ya no llega a la REST interna: la plataforma no la usa. Encontrado con JoeDesk, cuyas API en producción no respondían (vendor/wolfgan/cms/services/kernel.php, conf/routing_table.xml; manual 01 §3 y 04). bin/deploy.sh ya no avisa de los service file que empiezan por api-: ahora funcionan.
  • El HTML ya no se queda una semana en el navegador. El .htaccess del instalador daba text/html "access plus 1 week": las páginas del CMS declaran por sí solas su caché, pero un controlador de módulo, un script a medida o una redirección sin cabeceras se quedaban siete días en el navegador, y Apache añadía su max-age=604800 incluso junto al del PHP. Con JoeDesk la redirección hacia el login quedaba memorizada y, tras el acceso, el navegador volvía al login por su cuenta. Ahora "access plus 0 seconds" (install/lib.php, .htaccess, las plantillas conf/gallery/install/.htaccess-*.tpl del antiguo instalador; manual 12). El despliegue no sube el .htaccess: en los sitios ya instalados la línea hay que cambiarla a mano.

Seguridad 2 entradas

  • PHPMailer 7.1.1 en lugar de la 5.2.14. La 5.2.14 es de 2015: tiene los fallos conocidos del transporte mail() (CVE-2016-10033, CVE-2016-10045) y nunca se actualizó para PHP 8. La 7.1.1 viene del tag oficial, con el commit que indica Packagist. La plataforma la carga con las rutas y los nombres de la 5.2: class.phpmailer.php, class.smtp.php y class.pop3.php siguen como adaptadores (PHPMailer, phpmailerException, SMTP, POP3 son alias de las clases de la 7), así que Mailer, process_mail() y el código de los sitios no cambian. Desaparecen el OAuth de la 5.2, EasyPeasyICS, NTLM, y con ellos get_oauth_token.php y las carpetas examples/ y test/, que en el servidor eran scripts ejecutables por cualquiera. Probado con PHP 8.1 y 8.5 sobre lo que usan Mailer y process_mail() (idioma, SMTP, CC, CCO, Reply-To, imágenes incrustadas, adjuntos, quoted-printable, catch (phpmailerException)), y con envíos reales vía JoeSMTP (library/phpmailer/, vendor/wolfgan/mailer/Mailer.php; manual 06 §2).
  • Los archivos internos ya no se abren desde el navegador. Apache sirve por su cuenta cada archivo que existe, y el 404 del kernel sobre /library, /vendor… valía solo para las peticiones que llegan a index.php. En desk.giorgiopalermo.com se descargaban los logs del CMS (cache/logs/…_request.txt, 363 KB del día, y los errores SQL), el dump database.sql y CHANGELOG.md, y se ejecutaban los PHP de library/, vendor/, ff/, conf/, cache/, migrations/ (get_oauth_token.php de PHPMailer respondía 500). Ahora el .htaccess del instalador responde 404 a PHP, .sql, .log, .sh, .ini, .lock… en esas carpetas y en applets/, contents/, uploads/, a todo cache/logs/ y a database.sql y a los .md de la raíz. Siguen abiertos los archivos estáticos (CKEditor en vendor/), cm/, themes/ y modules/ (install/lib.php, .htaccess, conf/gallery/install/.htaccess-*.tpl; manual 14 §3 y 01 §3). El despliegue no sube el .htaccess: en los sitios ya instalados el bloque hay que añadirlo a mano, justo después de la redirección HTTPS.

3.1.0

10 oct 2026 Esquema BD → 5

Corregido 10 entradas

  • Los errores del acceso salen en el idioma de la página. En /en/login, /fr/login o /es/login el formulario respondía igualmente en italiano: «Utente non ancora attivato clicca qui», «Username o password errata», «Campo username o password non compilato». Ahora Auth::login() responde en italiano, inglés, francés o español (los demás idiomas reciben el inglés), y el enlace de una cuenta pendiente de activar lleva a la activación en el mismo idioma (/en/activation, /fr/attivazione) en lugar de ir siempre a /activation. También siguen el idioma de la página los dos mensajes que el script escribe por su cuenta (respuesta sin error, servicio que no responde), y el 2FA en español ya no sale en inglés. Los textos están en Auth::text(), como los del 2FA: funcionan aunque no haya filas en el diccionario. (vendor/wolfgan/auth/Auth.php, vendor/wolfgan/auth/widgets/login/script.js, manual 08 §1)
  • Recuperación de contraseña y activación en el idioma de la página. La recuperación mostraba en italiano las validaciones de los campos, el botón «REIMPOSTA PASSWORD», las etiquetas de la robustez y el error del código equivocado; «Email mancante o non valida» y las etiquetas para lectores de pantalla de las seis casillas del código estaban en italiano también en la activación. Ahora los textos del navegador llegan del diccionario a través de la plantilla del tema, y los del servidor de Auth::text(). El enlace para volver al acceso y los botones finales hacia el área personal respetan el idioma y JC_USER_AREA_PATH (Auth::userArea()), en lugar de apuntar siempre a /login y /area-utente. (themes/site/contents/recover/index.html, themes/site/contents/activation/index.html, vendor/wolfgan/auth/widgets/recover/index.php, vendor/wolfgan/auth/widgets/activation/index.php, manual 08 §1)
  • Los correos de la cuenta salen en el idioma del destinatario. La activación y la recuperación tenían texto y asunto en italiano para todos («Il nostro benvenuto! Codice attivazione: …»). Ahora las plantillas usan el diccionario y el Mailer las traduce al idioma de Mailer::setLang(), es decir, el del perfil del destinatario: antes los códigos de la plantilla seguían siempre FF_LOCALE, y desde un cron el cuerpo salía en el idioma predeterminado. hook.php compone el asunto en el mismo idioma. Un asunto ya escrito ya no se busca en el diccionario: con el código dentro, cada envío añadía una fila de marcador de posición en ff_international. (vendor/wolfgan/mailer/Mailer.php, hook.php, themes/site/contents/email/auth/, manual 06 §2)
  • El correo del código 2FA puede salir. La plantilla era auth::account_code.html, un nombre que el Mailer no resuelve: el envío fallaba (mailer_template_notfound) y el acceso respondía que el código no se podía enviar. Ahora existe la plantilla del tema themes/site/contents/email/auth/account_code.html, traducida, con respaldo en la del módulo. El 2FA sigue desactivado de forma predeterminada. (vendor/wolfgan/auth/Auth.php, manual 08 §5bis)
  • Banner de cookies traducido, y de nuevo en su forma. Sus textos estaban fijos en italiano: ahora están en el diccionario (svc_cookie_*), y el enlace a la política de privacidad sale en el idioma de la página. El CSS en línea perdía tres reglas, borradas por el motor de plantillas porque las llaves {palabra:palabra} parecen variables: el panel «Personalizar» quedaba siempre abierto y en el móvil los botones no se alineaban. (themes/gallery/contents/services/cookie.consent.html, conf/gallery/services/cookie.consent/index.php, manual 10 §4)
  • Páginas 404, 500 y de mantenimiento en el idioma del visitante. Estaban solo en italiano. Los textos están ahora en cm/errori.php en cuatro idiomas, elegidos por el kernel, por el prefijo de la dirección o por el navegador, sin necesidad de la base de datos; inicio y acceso apuntan al mismo idioma. (cm/errori.php, cm/extras/404.html, cm/extras/500.html, cm/maintenance.php, manual 13 §1bis)
  • El mantenimiento detiene de verdad el CMS. Tras la página 503, cm/maintenance.php no salía, e index.php arrancaba igualmente el CMS: durante una actualización, sobre archivos a medio copiar, con su salida añadida al final de la página. (cm/maintenance.php)
  • Se acabaron los códigos en crudo en la página. Un usuario registrado que abría /restricted volvía al acceso con mod_auth_profile_not_authorized en una ventana emergente; la página no encontrada del motor VGallery tenía como título not_found_title, y el recuadro de error http_response_empty_title. Las entradas existen ahora en los cuatro idiomas, y el mensaje de acceso denegado sale en el idioma del usuario. (modules/auth/contents/session/index.php, database.sql)
  • Una actualización ya no sobrescribe el manifiesto PWA del sitio. El paquete joecms-update-*.zip lleva en la raíz manifest.json con sus propios metadatos, y el updater lo extraía en lugar del manifiesto que el instalador escribe para el sitio (nombre, colores, iconos); site.webmanifest y browserconfig.xml volvían a los valores de partida del repositorio. Ahora el updater protege los tres archivos y el paquete de actualización no contiene los PWA. Quien actualice desde la 3.0.3 con el updater (que todavía es el antiguo) se encuentra con un manifest.json con los metadatos: basta con borrarlo, y el tema usa site.webmanifest, que este paquete no toca. (library/updater/JoeCmsUpdater.php, build-zip.sh, library/gallery/common/set_header_page.php)
  • Ventanas emergentes del tema en el idioma de la página. themes/site/javascript/root.js escribía en italiano las ventanas de pago y de resultado, el botón de cerrar y la etiqueta del ojo de la contraseña; el mensaje de pago completado hablaba de un «tesseramento» (afiliación), resto de otro proyecto. (themes/site/javascript/root.js)

Modificado 1 entrada

  • hook.php es todo de la plataforma; lo que es del sitio está en el config y en hook.local.php. El instalador escribía el dominio dentro de hook.php, que el paquete de actualización sustituye: al aplicar una actualización un sitio perdía el dominio, y con él la distinción entre producción y staging (sin noindex en el staging), además de cualquier cambio hecho allí. Ahora el dominio es JC_SITE_DOMAIN en el config, que la actualización no toca; las constantes iniciales de hook.php (AREA_SEO_SHOW_MODIFY, AREA_PUBLISHING_SHOW_PREVIEW, MOD_SEC_PROFILING, MAX_UPLOAD, …) se cambian desde el config; el código propio del sitio va en hook.local.php, que hook.php incluye al final, el updater protege y el paquete no contiene. El updater copia por sí mismo el dominio del antiguo hook.php al config, y a partir de ahora guarda hook.php en la copia de seguridad. Con un deploy manual, antes de subir el nuevo hook.php se añade al config define('JC_SITE_DOMAIN', 'dominio-del-sito');. (hook.php, install/lib.php, library/updater/JoeCmsUpdater.php, build-zip.sh, manual 14 §3, 10 §1)

Seguridad 1 entrada

  • ?error= y ?success= ya no entran en la página como HTML. themes/site/javascript/root.js ponía el valor del parámetro en la ventana emergente tal cual: un enlace como /?error=<img src=x onerror=…> ejecutaba código en el sitio. Ahora se escribe como texto. (themes/site/javascript/root.js)

Documentación 1 entrada

  • Regla 18: un texto que ve el visitante nunca se escribe en un solo idioma, con la tabla de dónde va según qué lo imprime. (manual 02 §2.3, 00)

Esquema 1 entrada

  • 5: en el diccionario (ff_international) las entradas de los textos públicos: banner de cookies (svc_cookie_*), correos de la cuenta (svc_mail_*), recuperación de contraseña (svc_rec_err_*, svc_rec_reset_btn, svc_pw_strength, svc_otp_digit) y las que faltaban (mod_auth_*_not_authorized, mod_auth_access_denied, not_found_*, http_response_*). En un sitio existente las trae migrations/schema_0005_testi_multilingua.php, idempotente, que no toca las traducciones ya escritas por el administrador. El updater la ejecuta solo; con un deploy manual se ejecuta antes que el resto del código (php bin/update.php --migrations-only --vai o /restricted/updater), de lo contrario esos textos salen como códigos.

3.0.3

10 oct 2026

Añadido 6 entradas

  • Motor de actualización automática no destructiva y sistema de migraciones de la BD. Se introduce el gestor de actualizaciones integrado (library/updater/JoeCmsUpdater.php) para pasar de forma segura y sin dolor entre versiones del CMS en sitios en producción. El sistema aplica una lista negra estricta de protección que nunca sobrescribe config.remote.php, config.local.php, .htaccess, uploads/ ni la caché, comprueba antes los requisitos de PHP y los permisos de escritura, activa el modo de mantenimiento atómico (.maintenance con token de bypass) y crea una copia de seguridad preventiva antes de extraer los archivos.
  • CLI para las actualizaciones del sistema (bin/update.php). Nueva utilidad de línea de comandos para comprobar el estado de la instalación (--status), activar y desactivar el mantenimiento (--maintenance on|off), aplicar con seguridad paquetes ZIP de actualización (--file <path> --vai) o ejecutar solo las migraciones de la base de datos (--migrations-only --vai).
  • Interfaz web para las actualizaciones en el backend (/restricted/updater). Nuevo controlador de gestión en conf/gallery/manage/updater/index.php con panel de estado, supervisión de la salud de la plataforma, carga por arrastrar y soltar de paquetes ZIP de actualización, consola de registro en tiempo real y alineación guiada de las migraciones del esquema.
  • Registro de migraciones incrementales (migrations/ y la tabla jc_migrations). Se introduce el sistema de migraciones de la base de datos gestionado por JoeCms\Updater\MigrationsRunner, con soporte para scripts .sql y .php transaccionales. Creada la migración base migrations/schema_0004_v302_baseline.php, correspondiente a JoeCMS 3.0.2 / esquema 4.
  • Gestor centralizado del modo de mantenimiento (cm/maintenance.php). Se añade al principio de index.php una comprobación que devuelve una respuesta 503 Service Unavailable y una plantilla adaptable con la paleta del CMS cuando existe .maintenance, mientras los administradores con el token de bypass siguen teniendo acceso.
  • Doble objetivo de empaquetado en build-zip.sh (instalación + actualización). build-zip.sh genera ahora tanto el archivo completo joecms-<versione>.zip (para instalaciones nuevas, con asistente y seed de la BD) como el paquete ligero joecms-update-<versione>.zip, que lleva manifest.json y deja fuera el instalador, para las actualizaciones automáticas de sitios ya en marcha.

Corregido 5 entradas

  • Enrutamiento del registro multilingüe (conf/modules/auth/routing_table.xml). Se elimina el ancla inicial rígida ^/ de la regla mod_auth_registration, para que las rutas localizadas con prefijo de idioma (p. ej. /en/registration) lleguen correctamente al controlador auth.
  • Resiliencia y gestión de errores JSON en el controlador de registro (modules/auth/contents/registration/index.php). El gestor de las peticiones POST queda dentro de un bloque try ... catch (\Throwable $e) que emite JSON directamente, desactivando la interrupción silenciosa de FormsFramework ($db->on_error = "ignore") y comprobando de forma explícita los errores SQL en todas las consultas. Así cualquier error devuelve una respuesta JSON explícita en lugar de una respuesta HTTP 200 vacía de 0 bytes. Se añaden respaldos de idioma defensivos para evitar excepciones cuando faltan traducciones en el diccionario, y se aísla el despachador de eventos posterior al registro.
  • Validación preventiva y mensajes localizados en el widget de registro (script.js e index.html). Se añade una comprobación obligatoria en el cliente del consentimiento de privacidad, con mensajes localizados (IT/EN), y una mejor gestión de los errores genéricos cuando el servidor no responde.
  • Endurecimiento de la compatibilidad de .htaccess en hosting compartido. Se elimina la directiva Options +FollowSymLinks de .htaccess y de las plantillas del instalador (install/lib.php, conf/gallery/install/.htaccess-*.tpl), que en hostings compartidos con restricciones (como InfinityFree/iFastNet) causaba errores 500. El uso de los módulos de Apache para las cabeceras CORS y Vary (mod_headers.c, mod_setenvif.c) queda protegido con bloques condicionales <IfModule>.
  • Limpieza del asistente de instalación (install/index.php). Se elimina un bloque de código duplicado en la fase final de la instalación.

3.0.2

9 oct 2026

Corregido 1 entrada

  • Prevención de la doble compresión HTTP y autodetección del entorno. Incorporada la función cm_can_compress() en library/gallery/system/compression.php para detectar si el servidor web (Apache con mod_brotli/mod_deflate, OpenResty, Cloudflare) o el motor PHP (zlib.output_compression) ya gestionan la compresión HTTP. En presencia de compresión previa, PHP sirve siempre HTML en texto plano y desactiva la generación y entrega de archivos .gz precomprimidos (library/gallery/system/cache.php, library/gallery/system/set_cache_page.php, cm/cm.php, ff/classes/ffTemplate.php, vendor/wolfgan/cache/services/page.php), eliminando el fallo de caracteres jeroglíficos/ilegibles. Si el servidor no dispone de compresión y el cliente admite gzip, la compresión PHP se mantiene activa. Añadido SetEnv SERVER_COMPRESSION 1 en las directivas .htaccess (install/lib.php, conf/gallery/install/.htaccess-*.tpl, .htaccess) para informar de inmediato a PHP sobre los módulos de Apache.

3.0.1

9 oct 2026

Modificado 1 entrada

  • Compatibilidad con PHP 8.4 para tipos de parámetros anulables implícitos en librerías y proveedores. Normalizadas todas las declaraciones de parámetros con sintaxis obsoleta Type $param = null haciéndolas explícitamente anulables ?Type $param = null en librerías y proveedores (PHPExcel, OAuth2, AlgoliaSearch, CssMin, Facebook SDK, IMAP, Minify, MobileDetect, RabbitMQ, MongoDB, Smarty, Symfony Polyfill, Twilio, Twitter, BunnyCDN). Añadido el atributo #[AllowDynamicProperties] a la clase abstracta vgCommon para compatibilidad completa con PHP 8.2+.

Corregido 4 entradas

  • Resiliencia en la generación de iconos de archivos y previsualizaciones multimedia (ffMedia). Incorporado el método auxiliar ffMedia::createLinkOrCopy(), que intenta la creación de enlaces duros (link()) y recurre de manera transparente a copia física (copy()) si la operación falla por limitaciones de sistema de archivos (EXDEV), symlinks o restricciones de permisos en el alojamiento, evitando interrupciones fatales. Añadidas comprobaciones de existencia de modo y asistente antes de acceder a índices de array.
  • Gestión de sesiones y cookies de autenticación (authSession). En el método destroy() de autenticación ahora se puede inhibir la emisión anticipada de cabeceras Set-Cookie de borrado durante la regeneración de sesión en login o restauración, evitando la pérdida del nuevo identificador de sesión. Mejorada la comprobación de sesión en disco (checkSession) evitando falsos negativos cuando el directorio de sesiones no es directamente legible.
  • Redirección de inicio de sesión y rutas personalizadas del área privada. El widget de autenticación y el controlador de login ahora respetan dinámicamente la constante JC_USER_AREA_PATH para el destino tras iniciar sesión, redirigen a los administradores a /restricted ed evitan bucles de redirección a /area-utente para usuarios estándar.
  • Resolución de ruta en el núcleo del CMS (cmsKernel). Corregida la normalización de path_info en cmsKernel durante la eliminación de enginePath antes de extraer el código de idioma.

Añadido 2 entradas

  • Instalador: rutas de área de usuario y páginas de autenticación multilingüe. El asistente de instalación permite configurar la ruta del área privada para cada idioma habilitado (con valores predeterminados /area-utente, /user-area, /espace-client, /area-usuario, /benutzerbereich, etc.). Rellena automáticamente el manifiesto de slugs localizados contents/i18n.php tanto para el área de usuario como para las rutas de autenticación (/registrazione, /attivazione, /recupero-password), garantizando redirecciones 301 automáticas mediante el router del CMS.
  • Refuerzo de seguridad y soporte de manifiestos web en .htaccess. Añadido mapeo de tipos MIME para application/manifest+json (.webmanifest, .json) en el .htaccess principal y en plantillas de instalación. Actualizada la plantilla .htaccess-noscript.tpl mediante bloques <FilesMatch> y Require all denied para bloquear el acceso directo y la ejecución de scripts en las carpetas de subidas y caché.

3.0.0

8 oct 2026

Añadido 1 entrada

  • Módulo nativo Package Manager (modules/package-manager/) para subida e instalación de extensiones ZIP. Se añade en el backend de administración (/admin/pacchetti y elemento de menú «Gestione Moduli (.zip)») un área para la subida de paquetes de extensión en formato ZIP (al estilo WordPress). El motor:
    • Valida la seguridad del archivo excluyendo intentos de path traversal (../) o rutas absolutas;
    • Inspecciona el archivo descriptor manifest.json presente en el paquete;
    • Extrae los componentes en sus respectivas carpetas (modules/<id>/, contents/, themes/);
    • Activa automáticamente las migraciones y la DDL de la base de datos si manifest.database.schema está definido;
    • Admite asistentes de configuración interactivos posteriores a la instalación para personalizar rutas y ajustes.

2.0.3

8 oct 2026

Corregido 2 entradas

  • Ruta incorrecta en la vista previa de archivos e imágenes en el backend al usar CM_SHOWFILES. En ffField_base::process_file() (ff/classes/ffField.php), si un campo definía file_saved_preview_url con CM_SHOWFILES (p. ej., /cm/showfiles.php/96x96/...), el framework anteponía incondicionalmente "/uploads" a la URL resultante, generando enlaces incorrectos e inexistentes como /uploads/cm/showfiles.php/.... Ahora las URL que ya contienen CM_SHOWFILES (o /cm/showfiles.php), que ya comienzan con /uploads o que son absolutas (http://, https://, //) se utilizan directamente; el prefijo /uploads se aplica únicamente a rutas relativas locales no gestionadas por el servicio de imágenes.
  • Error de depuración en llamadas de autocompletado con consulta vacía o sesión ausente. En los scripts de procesamiento de los widgets activecomboex, autocomplete, autocompletetoken y autocompletex (themes/responsive/ff/ffField/widgets/*/parsedata.php), si la consulta SQL en sesión estaba vacía se lanzaba un ffErrorHandler::raise("debug", ...). Ahora devuelven correctamente un array JSON vacío ([]), evitando bloqueos y mensajes de error innecesarios al escribir.

2.0.2

8 oct 2026

Corregido 2 entradas

  • En hostings que deshabilitan exec() el sitio no arrancaba: "Call to undefined function exec()". Al leer la caché, el gestor de archivos validaba el fragmento PHP con exec("php -l ...") (vendor/wolfgan/filemanager/services/fs_php.php). En muchos hostings compartidos, y en todos los gratuitos, exec/shell_exec están en disable_functions y la llamada resultaba en error fatal — bastaba con la primera página guardada en caché, incluido /login. Ahora la sintaxis se comprueba con el analizador interno de PHP (token_get_all(..., TOKEN_PARSE), que en PHP 8 lanza un ParseError recuperable): mismo resultado que php -l en los archivos de caché, pero siempre disponible y sin subprocesos, siendo por tanto mucho más rápido en cada lectura (en pruebas de unos 70 ms a menos de un milisegundo). Por la misma razón ya no provocan error fatal los demás puntos que usaban comandos de shell sin protección: el mismo control de sintaxis en jobs (Jobs::controller_script(), vendor/hcore/jobs/Jobs.php), installer_commandExist() del asistente (conf/gallery/install/common.php) y ffMedia::commandExist(), que ahora consideran ausente el comando si shell_exec no existe, así como la conversión de PDFs a miniatura (ffThumb::load_image()), que sin exec recurre al icono genérico en vez de interrumpir la página.
  • Miniaturas de media. en 500 en hostings sin shell_exec. ffMedia e ffThumb existen en dos copias, y los sitios instalados por el asistente (COMPOSER_PATH) cargan las de vendor/phpformsframework/ (ffMedia.php, ffImage/ffThumb.php), no las de ff/classes/: la protección ahora está en ambas. Sin ella, cada nueva copia de una imagen pasaba por ffMedia::optimize(), que busca optimizadores externos con shell_exec("which …"), y su primera petición respondía con un 500.

Documentación 1 entrada

  • Manual 14 §1: exec() y shell_exec() no son requisitos. El sitio funciona en hostings que los deshabilitan; sin ellos, solo faltan la vista previa de PDFs y los optimizadores externos de imágenes, CSS y JS.

2.0.1

6 oct 2026

Corregido 3 entradas

  • Con la caché en memoria del router activa, la primera petición fallaba. cmRouter::loadMem() escribía en $this->router y $this->cache, propiedades que no existen en cmRouter (las suyas son rules, named_rules, ordered): la lectura provocaba "property «router» not found on class cmRouter". Además trataba un cache miss (null) como un hit (!== false), y entraba de todos modos. Ahora rellena las propiedades correctas y trata el miss como lo que es. La caché del router de las páginas también está alineada con la clave escrita (cache_router; antes, __cm_cache__ en la lectura y cache_router en la escritura): hasta ahora nunca se reutilizaba. El valor por defecto de CM_ENABLE_MEM_CACHING sigue siendo false, y es el correcto: sin FF_CACHE_ADAPTER la «memoria» es ffGlobals, que dura una petición, y activarla no ahorra nada; con los adaptadores apc y fs en PHP 8 el sitio no arranca, porque llaman a apc_store()/apc_fetch(), que APCu ya no tiene, y apc.php extiende una clase que no existe (ffCacheAdapterAdapter). Solo tiene sentido con redis o memcached y su servidor, e incluso ahí la ganancia es pequeña: las páginas servidas desde la caché de página no llegan al router.
  • cmRouter::orderRules() faltaba por completo. cm::process() la invoca antes de guardar las reglas en caché cuando CM_ENABLE_MEM_CACHING está activo, pero el método no existía en ninguna clase: "function «orderRules» not found on class cmRouter". Ahora existe y ordena cada bucket de prioridad con ffCommon_IndexOrder, el mismo criterio que ya usa cmRouter::process().
  • Documento de error de una dirección inexistente: la página ya no da 500. Una petición a una ruta que no existe — por ejemplo un escáner que prueba /.aws/.env — acaba en system_write_cache_error_document(), que llama a Filemanager::update(): ahí read() puede devolver un valor que no es un array (por ejemplo 1, cuando el archivo incluido no expone ni un return ni una variable declarada), y en PHP 8 pasar un entero a array_replace() es un TypeError. Ahora update() vuelve a partir de un array vacío cuando read() no devuelve un array, como cuando el archivo aún no existe: la dirección sale 404, no 500. (vendor/wolfgan/filemanager/services/fs_php.php)

Añadido 1 entrada

  • Brotli en el .htaccess generado por el instalador. El asistente (jc_htaccess_static_tail() en install/lib.php) y las plantillas del antiguo instalador (conf/gallery/install/.htaccess-cms.tpl y .htaccess-base.tpl) añaden el filtro mod_brotli, protegido por IfModule: en los servidores que lo tienen, html, css, js, json, xml y svg salen en Brotli a los navegadores que lo aceptan y en gzip a los demás. El bloque va antes del de DEFLATE: de los dos filtros comprime el primero de la cadena, y colocado después, un navegador que acepta tanto br como gzip recibía siempre gzip (probado en Apache 2.4.68). La ganancia es pequeña: con la calidad por defecto de mod_brotli (5), alrededor de un 3% en CSS y JS respecto a gzip, y el HTML que llega de la caché de página sigue en gzip, porque ya lo comprime PHP. En los sitios ya instalados hay que llevarlo a mano, porque su .htaccess no viaja con el despliegue.

Cambiado 2 entradas

  • El Cache-Control de las páginas públicas vistas por invitados es una constante. El max-age fijado a 7 en el código de cache_parse() (library/gallery/system/cache.php) es ahora CM_PAGECACHE_GUEST_MAXAGE (cm/conf/config.php, por defecto 7), que se puede sobrescribir en la config de la instalación (config.local.php / config.remote.php). Vale para las páginas servidas desde la caché de página: la respuesta que compone la página la primera vez sigue saliendo con max-age=3. Solo afecta a los invitados: las páginas de quien ha entrado siguen siendo no-store. Sirve para subir el TTL en los sitios con contenidos que no son en tiempo real, sin tocar el código.
  • CM_ENABLE_MEM_CACHING se puede sobrescribir. En conf/gallery/config.php la constante ya no es un define() incondicional: una instalación puede activarla desde su propia config de entorno. Valor por defecto sin cambios (false), que conviene dejar así salvo con un adaptador redis o memcached (ver «Corregido»). Con la constante activa funciona también __CLEARCACHE__ en la URL; debe ir acompañada del procedimiento de vaciado en el despliegue.

Documentación 2 entradas

  • Manual 12: caché del router y ffCache descritas por lo que hace el código. Activar CM_ENABLE_MEM_CACHING no es «una optimización gratuita»: sin adaptador no hace nada, y con apc o fs en PHP 8 hace que el sitio dé error. La tabla de los adaptadores daba fs como «filesystem, por defecto, funciona en todas partes»: fs.php es una copia de apc.php (llama a apc_store()), y sin FF_CACHE_ADAPTER la caché dura lo que la petición. El max-age de las páginas públicas se describe en los dos casos: 3 cuando la página se compone, y CM_PAGECACHE_GUEST_MAXAGE cuando llega de la caché.
  • Manual 14 §4: con opcache.revalidate_freq alto la caché se vacía después, no enseguida. En el primer intervalo tras la subida PHP puede seguir ejecutando la versión vieja de un archivo ya compilado, mientras que las plantillas las lee nuevas del disco: las páginas regeneradas en ese momento se quedan en la caché de página con el código viejo. Se vacía cache/ cuando ha pasado ese tiempo, o se reinicia el PHP-FPM del sitio antes de vaciarla.

2.0.0

1 oct 2026

Seguridad 1 entrada

  • Contraseñas solo bcrypt, también en el acceso y en la recuperación. La recuperación de contraseña guardaba la nueva contraseña con PASSWORD() de MySQL (SHA1 doble, sin sal), y lo mismo toda escritura que pasa por el modelo access. Ahora todas las escrituras producen bcrypt (Auth::hashPassword(), campo password del modelo en inBcrypt), y el acceso solo acepta bcrypt (Auth::verifyPassword()): ya no reconoce los hashes PASSWORD() y WordPress ni los convierte. Quien todavía tenga un hash en esos formatos tiene que restablecer la contraseña con la recuperación. Un bcrypt con un coste distinto del actual se reescribe en el acceso. El acceso ya no usa PASSWORD(), que en MySQL 8 no existe.

1.7.0

1 oct 2026

Añadido 2 entradas

  • Registro: los campos del proyecto llegan al evento. El widget envía también los campos del formulario que se llaman extra[...], tal cual, y on_registration_done los recibe en $dati["extra"] (hay que validarlos: vienen del navegador), junto con la fecha de nacimiento en $dati["dob"]. Un proyecto añade sus preguntas al formulario sin tocar el widget; sin campos extra no cambia nada. (vendor/wolfgan/auth/widgets/registration/script.js, modules/auth/contents/registration/index.php, manual 08 §5)
  • Widget de recuperación de contraseña traducible. Los mensajes de error, el texto del botón tras el envío del código y las etiquetas de robustez de la contraseña se leen de la plantilla — data-err-password, data-err-conferma, data-err-diverse en #errorMsg, data-testo-codice en el botón, data-etichette (separadas por |) en la etiqueta —; sin ellos, quedan los textos italianos de siempre. (vendor/wolfgan/auth/widgets/recover/script.js, manual 08 §1)

Corregido 9 entradas

  • Las reglas de ruta del kernel se llevaban toda URL que empezaba como una carpeta de sistema. En vendor/wolfgan/cms/services/kernel.php las entradas eran '^/conf*', '^/error*', '^/cm*', '^/asset*', '^/cache*', '^/ff*', '^/contents*'… y en cmsRouter::regexp() cada * se convierte en (.*), con un preg_match no anclado al final: la regla capturaba todo lo que empieza por esa palabra, no solo la carpeta. Un sitio que publicaba una página /confronto la veía responder 404 con el cuerpo vacío — la página estaba y funcionaba, nunca se llegaba a ella —, /errore acababa en la página de error del CMS, y /cms, /assetto, /cachet, /ffmpeg, /contents-vecchi en la carpeta equivocada. Ahora cada regla de carpeta es '^/nombre(/|$)': la carpeta y lo que está debajo, nada más. Vale también para /themes, /uploads y /asset, que siguen pasando por cm/static.php, y para el área reservada, /restricted(/|$); se quedan como estaban /static/*, /media/*, /showfiles/* y las reglas de la API. Si tiene un sitio en producción: tras la actualización conviene comprobar si usa direcciones que empezaban como una carpeta de sistema (manual 01 §2-3).
  • Idioma: la lista de idiomas ya no tumba las páginas de quien ha entrado. El motor del idioma preferido (library/gallery/common/language_preference.php) se ejecuta en el kernel, justo después de Auth::check(): antes de ff/main.php y antes de que el Content Manager cargue los módulos. Ahí get_locale() no puede funcionar: sin FF_PHP_EXT es "Undefined constant", y con la caché de idiomas fría pasa por mod_auth_get_locale(), que está en modules/auth/common.php y todavía no existe ("Call to undefined function"). La 1.5.1 había cerrado el primer caso evitando ahí get_locale() mientras el framework no está cargado; GDay, todavía en la 1.3.0, se encontró con los dos, con cada página del área en 500. Ahora el motor lee la lista del esquema que el kernel ya tiene en memoria (cache/locale.php, la misma ff_languages con status > 0) y la reutiliza durante toda la petición; y la propia get_locale() ya no se cae: recurre a "php" si falta FF_PHP_EXT, y al esquema del kernel si mod_auth_get_locale() todavía no está. (library/gallery/common/language_preference.php, library/gallery/common/get_locale.php)
  • Acceso: el botón "Acceder" nunca mostraba el motivo de un acceso rechazado. En el onclick del widget la ruta de retorno acababa donde el script espera el elemento pulsado — hCore.auth.login(url, selector, elem, redirect) — y ahí elem va a jQuery: jQuery("/restricted") → "Syntax error, unrecognized expression: /restricted". La respuesta moría antes de escribir el mensaje de la API (consola aparte, la página se quedaba muda); con las credenciales correctas esa rama no se toca, por eso el defecto solo se veía en los accesos fallidos, en el segundo factor y en las redes caídas. La página de acceso del tema tenía el mismo onclick, y ahí además el retorno de ?ret_url= se perdía. Ahora las plantillas pasan this y la ruta en cuarto lugar, y el script acepta como elem solo un elemento (o un id), recurriendo al contenedor del formulario. Un tema que copió la página con el onclick antiguo ahora muestra el mensaje, pero para el retorno hay que corregirlo también. (vendor/wolfgan/auth/widgets/login/index.html, index-corretto.html, script.js, themes/site/contents/login/index.html, manual 08 §1)
  • Recuperación de contraseña: para muchos emails reales el código no salía. El validador quería un dominio de primer nivel de 2-4 letras y ningún + antes de la arroba: nome@studio.online, nome+studio@gmail.com o un .invalid de prueba no eran emails, Auth::request buscaba por nombre de usuario, no encontraba a quién escribir y respondía "ok" de todos modos. Ahora isEmail usa filter_var(…, FILTER_VALIDATE_EMAIL). (vendor/wolfgan/cms/services/validator.php)
  • Recuperación de contraseña en los sitios multilingües: llegaba la bienvenida con el código de activación. hook.php elegía la plantilla del email por el PATH_INFO, y el switch solo conocía /recover: en /recupero-password o /en/recover acababa en la rama de la activación (asunto y plantilla equivocados). Ahora lee la plantilla que ya ha elegido Auth::request (recover_code o activation_code). (hook.php)
  • /logout era un 404 incluso para quien había entrado. modules/auth/contents/logout pide la regla mod_auth_logout, que no estaba en la tabla de rutas. (conf/modules/auth/routing_table.xml)
  • Pagos: desde el sitio la clase Payment no se cargaba. Solo la conocía el autoload.php raíz, que index.php no incluye (carga el de Composer): checkout, webhooks de Stripe y cron de pagos morían con "Class Payment not found". La API la encontraba, y las pruebas desde la línea de comandos la cargaban a mano. (vendor/wolfgan/autoload.php, manual 10 §2)
  • El despliegue llevaba al servidor las pruebas de los módulos (modules/*/tests/), destructivas con la base de datos que se les pasa. Ahora se excluyen. (bin/deploy.sh, manual 14 §4)
  • PHP 8.5: curl_close() obsoleta. En el Notifier y en downloadRemoteFile() solo se llama en PHP 7, donde todavía hace falta. (vendor/hcore/notifier/Notifier.php, hook.php)

Seguridad 3 entradas

  • ?__debug__ y ?__query__ encendían el diagnóstico a cualquiera. Cualquier visitante, añadiendo ?__debug__ a la dirección, volvía a encender display_errors y los volcados del CMS: rutas del servidor, warnings, variables. Ahora cm/livello-errori.php quita los dos parámetros de la petición a quien no puede pedirlos: se abren desde la línea de comandos, con SetEnv JC_DEBUG_ALLOWED 1 (o la variable de entorno), o en una copia .local vista desde la propia máquina. También la API lo incluye en primer lugar, cuando antes no lo incluía en absoluto: con ?__debug__ los warnings podían acabar dentro del JSON. (cm/livello-errori.php, api/1.0/index.php, manual 13 §2)
  • Caché: las páginas personales salían con public, max-age=3. Quien entraba con su cuenta — área de usuario, gestión — recibía la página con un Cache-Control que la declaraba pública y reutilizable durante tres segundos: tras salir, el navegador volvía a mostrar el área recién vista, y una caché compartida habría podido servirla a otra persona. Ahora una página con use_cache(false), o vista por un usuario que ha entrado, sale no-store; para los invitados la caché de página queda como estaba. (library/gallery/system/set_cache_page.php, library/gallery/system/cache.php, manual 12 §2)
  • checkUserRights(): la suplantación solo vale para unos datos personales con cuenta, y la cookie ya no se reescribe en cada página. El helper devuelve el ID de los datos personales de quien ha entrado (anagraph.ID, el de Auth::get()["ID"]) o, para un administrador, el de la persona suplantada (?force_id= o la cookie user-id-value). Ahora un ID suplantado solo se respeta si corresponde a unos datos personales vinculados a una cuenta (anagraph.ID_user); si no, se vuelve al usuario que ha entrado y la cookie se borra. Y solo se borra si está: antes cada llamada, para cualquiera que hubiera entrado, añadía a la respuesta un Set-Cookie. (hook.php, manual 08 §2)

Cambiado 1 entrada

  • El esquema de la base de datos declarado en el CHANGELOG se comprueba en cada versión. joecms.it lo lee para decidir si la página de descarga debe avisar de que la versión cambia la base de datos. build-zip.sh se detiene, y el pre-commit bloquea el commit de versión, si la sección no tiene en el encabezado · schema **N** con N = JC_SCHEMA_VERSION, si falta el grupo ### Schema cuando el esquema cambia (o está cuando no cambia), o si database.sql ha cambiado sin subirlo. (.githooks/changelog-schema.php, manual 14 §5)

Documentación 1 entrada

  • La guarda del residuo de ruta del manual no saltaba nunca. El ejemplo leía el Content Manager de $GLOBALS["cm"], que está vacío: cm/main.php se ejecuta dentro de Cms::execute() y su $cm es una variable local. El residuo salía vacío sin errores, y un sitio que lo copió (joecms.it) mostraba el índice de la Guía en lugar de cada capítulo. Ahora el ejemplo usa cm::getInstance(), y el manual avisa de que el residuo llega en minúsculas (ffCommon_url_normalize()). (manual 01 §4)

1.6.2

28 sept 2026

Corregido 2 entradas

  • Imágenes de media.<dominio> sin copia en caché: se acabaron los 500 y los redirects truncados. Cuando falta la copia en cache/.thumbs/ y el original existe en uploads/ con la misma ruta, ahora lo sirve Apache, también por partes como piden los vídeos en iPhone; las versiones redimensionadas las siguen generando cm/error.php y ffMedia. Vale para el .htaccess que el asistente escribe en las instalaciones nuevas (jc_write_htaccess() en install/lib.php) y para la plantilla del antiguo instalador (conf/gallery/install/.htaccess-cms.tpl). El asistente y el .htaccess del repositorio tenían además la condición sobre el host del front controller sin anclar: valía también para media. y mandaba a 500 cada copia que faltaba (exceeded the limit of 10 internal redirects). ffMedia::process() ya no propone redirects hacia copias inexistentes: para los originales de los que no conseguía crear la copia (visto con JPG y vídeos) respondía con un 301 permanente hacia una ruta truncada (/prodotto-v2/intro.mp4 → tto-v2/intro.mp4), ahora con un 404. Los sitios ya instalados hay que actualizarlos a mano: su .htaccess no viaja con el despliegue. (ff/classes/ffMedia.php, manual 11 §5)
  • bin/deploy.sh --svuota-cache ya no borra cache/.thumbs/, las copias que sirve media.. Vaciarlas todas a la vez, en un sitio con la Rewrite Base válida también para media., mandó a 500 todas las imágenes (grandchef, 28/9/2026). (manual 14 §4)

1.6.1

27 sept 2026

Corregido 2 entradas

  • Backend en PHP 8: seis páginas ya no fallan. Encontradas por el crawler que recorre frontend y backend en MySQL 8.4; ya estaban en la 1.5.x.
    • Utility → Sitemap: Call to undefined function cache_get_settings(). sitemap.php usaba las funciones de cache.php sin incluirlo, y en el flujo del kernel solo las carga router.php, por donde el backend no pasa: ahora las incluye él. La entrada de menú apuntaba a /admin/utility/sitemap, una dirección sin página que la regla de enrutamiento …/sitemap envía al generador de sección: ahora abre la sitemap del sitio, /sitemap.xml. (library/gallery/system/sitemap.php, conf/contents/admin/mod_restricted.xml)
    • Configuración de Google Maps y del módulo de mapas: Undefined constant "TOP_CENTER". Las posiciones de los controles (TOP_CENTER, SMALL, HORIZONTAL_BAR…) eran constantes no definidas, que PHP 7 convertía en la cadena de su propio nombre: ahora son cadenas, con el mismo valor que antes. (conf/gallery/services/google.maps/config/index.php, conf/gallery/modules/maps/config/modify.php)
    • Edición de dominio, y todo campo de moneda sin decimales: Unsupported operand types: string / int. La parte decimal vacía de un importe como 5 se dividía como cadena: ahora se convierte a número, en todos los formatos de idioma. (ff/classes/ffData/locale/FormsLocale_*.php)
    • Grupos (/restricted/groups): "Cannot determine order field!". La ordenación predeterminada era "level DESC", pero la tabla quiere el nombre del campo; la dirección ahora está en el campo level. (conf/gallery/manage/groups/index.php)
    • Ejemplos de los componentes (/admin/doc/record): "CM: Unable to find Widget". Quitados los dos ejemplos con ckuploadify, que depende de CKFinder y no está en el tema del backend; los ejemplos "uploadifive" y "kcuploadifive" usan ahora esos widgets en lugar de sus gemelos.
    • Import (/admin/configuration/import): los enlaces del menú salían con {import_path} y {_import_…} sin resolver, porque ese contenido no pasa por la plantilla. Ahora ruta y etiquetas se resuelven en PHP. (conf/gallery/import/index.php)
  • Emails del sistema: se acabó el fatal Undefined constant "EMAIL_DEBUG". La config del antiguo instalador la definía, la del asistente no, y email_system() la lee: servicio de envío, notificaciones al insertar y modificar contenidos, vistas previas de los emails, módulo de registro. Ahora tiene un valor por defecto vacío. (conf/gallery/config.php)

1.6.0

27 sept 2026 Esquema BD → 4

Corregido 7 entradas

  • MySQL 8, Aiven, MariaDB strict: el CMS funciona con el sql_mode por defecto de los servidores modernos (ONLY_FULL_GROUP_BY, STRICT_TRANS_TABLES, NO_ZERO_DATE), sin relajarlo. Probado con instalación, frontend, backoffice, registro y guardados en MySQL 8.4 (también con el sql_mode de Aiven) y MariaDB 12. (manual 07 §1)
    • Consultas con GROUP BY o DISTINCT no admitidos (#1055, #3065) reescritas en una treintena de archivos: módulos y permisos de layout, secciones, menú de operaciones, cuadrículas del backoffice, API, facturas y pagos. Donde se quería "la primera fila por grupo" la elección ahora es explícita (en PHP, ROW_NUMBER() o MIN(ID)), mientras que antes dependía del servidor. Las comprobaciones de facturas sin pagos las agrupaban todas en una sola.
    • Esquema: DEFAULT explícito en todas las columnas NOT NULL (error #1364 "Field doesn't have a default value"); columnas de fecha nullable y fechas vacías escritas como NULL en lugar de '0000-00-00', rechazado incluso en una simple comparación.
    • Escrituras: ffDB_Sql::toSqlColumn() adapta el valor vacío al tipo de la columna (0 para las numéricas, NULL para las fechas) en ffRecord, ffDetails, Storage y en las consultas escritas a mano (error #1366 "Incorrect integer value: ''"). Los INSERT con '' en la clave autoincremental escriben NULL.
    • Dialecto ANSI de Aiven: con PIPES_AS_CONCAT el || concatena en lugar de hacer OR, sin dar error. El único || en una consulta, el estado del envío de la API de operaciones, ahora es OR. (conf/gallery/api/get_operation.php)
  • Puerto de la base de datos: el instalador lo pedía pero no lo escribía, y ffDB_Sql no se lo pasaba a mysqli, así que una base de datos en un puerto no estándar (Aiven) no se conectaba. Ahora el asistente escribe FF_DATABASE_PORT y el driver acepta también host:porta.
  • PHP 8: se acabó el fatal sem_get(): Argument #1 ($key) must be of type int en las páginas en caché (p. ej. /login): la clave del semáforo de la caché es siempre un entero (library/gallery/system/cache.php, vendor/wolfgan/cache/services/sem.php).
  • Pagos: el driver de Stripe sin clave o sin red ya no acaba en error fatal. Desde la 1.5.1 paymentStripe llamaba a un método errore() que no existía: sin clave secreta, o con la red caída, en lugar del resultado de error llegaba Call to undefined method. Ahora el resultado de error tiene la misma forma que el éxito (ok a false, error, error_code). Además, una factura figura como pagada aunque Stripe no envíe el campo paid, que las API recientes ya no tienen: cuenta status igual a paid. (library/payment/services/stripe.php)
  • Sitios multilingües: el canonical de las páginas en inglés apuntaba a las italianas. Para una página de archivo en un idioma no predeterminado set_header_page() usaba la ruta canónica en disco: /en/contact declaraba /contattaci, /en declaraba /, y Google nunca indexaba la versión traducida. Ahora pasa por content_i18n_url(); las páginas de vgallery quedan como antes. (library/gallery/common/set_header_page.php, manual 12 §2)
  • Registro: el consentimiento a las ofertas ya no se pierde, y hay un evento tras la cuenta. El widget enviaba desde siempre la casilla newsletter, pero jc_registration_submit() no la guardaba. Ahora, creada la cuenta, se lanza Auth::doEvent("on_registration_done", $account, $dati) con ID_user, ID_anagraph, email y los consentimientos (newsletter, privacy), idioma, IP y navegador: el proyecto decide dónde escribirlos. Sin oyentes no cambia nada. (modules/auth/contents/registration/index.php, manual 08 §5)
  • ?__nocache__ en una página nunca guardada en caché daba 500: el delete() del gestor de archivos sobre un archivo que aún no existe pasaba null a array_diff_key(). (vendor/wolfgan/filemanager/services/fs_php.php)

Añadido 2 entradas

  • bin/db-allinea-schema.php: lleva una base de datos ya instalada al esquema 4 (valores por defecto explícitos, fechas nullable, fechas cero → NULL) leyendo las columnas reales, sin cambiar ningún tipo. Prueba en vacío por defecto, --vai para ejecutar, --config <file> para otra config; idempotente. Si la conexión se cae a mitad (errores 2006, 2013) se reconecta y reintenta; si no vuelve se detiene enseguida y, relanzada, retoma desde donde había llegado.
  • Sitemap multilingüe. Con varios idiomas activos cada página de archivo y la página de inicio aparecen una vez por idioma, con el slug del manifiesto contents/i18n.php y <xhtml:link rel="alternate" hreflang>; las direcciones coinciden con los canonical. Con un solo idioma no cambia nada. (modules/cms-common/models/Sitemap.php, GUIDA_SITEMAP.md)

Seguridad 1 entrada

  • Acceso, registro, activación, recuperación y logout: la vuelta solo hacia una ruta del sitio. ?redirect= y ?ret_url= llegan de la dirección de la página y acababan sin control en la respuesta y en las plantillas: /login?redirect=https://altro.sito mandaba fuera a quien acababa de autenticarse (open redirect), ?redirect=javascript:… ejecutaba código en la página de login, y ret_url entraba en bruto en un onclick (XSS reflejado; en activación y recuperación lo mismo con redirect). Nuevo Auth::redirectLocale(): solo pasa una ruta que empieza por una barra (no //, no /\), sin espacios, caracteres de control, comillas, < > ni barras invertidas; si no, el widget se comporta como sin parámetro. Los scripts de login y logout aplican la misma regla en el navegador. Quien redirigía tras el acceso a una dirección absoluta, incluso de su propio dominio, debe pasar solo la ruta. Más estricto que pm_safe_dest() (library/security, aún no cargado) porque aquí el valor acaba también en atributos y cadenas JavaScript. (vendor/wolfgan/auth/Auth.php, vendor/wolfgan/auth/widgets/{login,registration,activation,recover}/index.php, widgets/login/script.js, widgets/logout/script.js, manual 08 §5)

Esquema 1 entrada

  • 4: DEFAULT en cada columna NOT NULL, columnas de fecha nullable con valor por defecto NULL, fechas cero convertidas en NULL. En un sitio existente se aplica con bin/db-allinea-schema.php, antes de subir el código 1.6.0 (ver al principio de la sección).

1.5.2

25 sept 2026

Corregido 2 entradas

  • bin/deploy.sh llega siempre ejecutable. Si el checkout desde el que se construía el paquete había perdido el bit de ejecución, el sitio instalado respondía permission denied a ./bin/deploy.sh. Ahora build-zip.sh lo fija en 0755 antes de comprimir y lo comprueba en el ZIP; el manual explica cómo restaurarlo en un sitio ya instalado. (build-zip.sh, docs/manuale/14-ambienti-e-deploy.md)
  • Pagos: el driver de Stripe ya no depende de constantes de GDay. Las fechas de Stripe se convertían a la zona horaria GDAY_FUSO, una constante que solo existe en ese proyecto: en los demás se recurría a la zona horaria de PHP sin avisar. Ahora pasan por Payment::fuso(), que usa la zona horaria del sitio (TIMEZONE), luego la de PHP, y ante un valor no válido recurre a UTC sin excepciones. También se han quitado las referencias a GDay de los comentarios del driver. (library/payment/Payment.php, library/payment/services/stripe.php, manual 10 §2)

1.5.1

25 sept 2026

Añadido 1 entrada

  • Pagos: un hub único, las pasarelas como drivers. library/payment/Payment.php declara qué significa cobrar (abrir una sesión, releer su estado, reembolsar, verificar la firma de un webhook) sin saber quién lo hace; la pasarela es un driver en library/payment/services/<nombre>.php, cargado por el hub (en autoload.php basta un caso). Primer driver: Stripe, pagos únicos y recurrentes. Las claves se introducen desde el área Servicios (conf/gallery/services/payment.stripe/), y el entorno real solo se activa con una clave sk_live_ / rk_live_: quien olvida cambiar la clave no cobra dinero real por error. Productos, créditos y recibos se quedan en el módulo del sitio. (manual 10 §2)

Corregido 1 entrada

  • Error fatal en la página de inicio para los usuarios autenticados (desde la 1.3.1). En un sitio multilingüe, un usuario con sesión iniciada que abría una URL sin prefijo de idioma (la página de inicio, por ejemplo) recibía una página en blanco: Undefined constant "FF_PHP_EXT". La resolución del idioma preferido se ejecuta en cmsKernel::run(), antes de que se cargue el framework, y para leer la preferencia del perfil recalculaba la lista de idiomas con get_locale(), que en ese punto no puede funcionar. Ahora la lista que ya proporciona el kernel se pasa a la lectura y a la escritura en el perfil, y la reutilizan las demás funciones. Si el framework no está listo, no se llama a get_locale(). Los visitantes anónimos no se ven afectados. (library/gallery/common/language_preference.php)

1.5.0

25 sept 2026

Añadido 1 entrada

  • Instalador multilingüe (italiano, inglés, español, francés). El asistente se abre en el idioma del navegador (inglés si no es uno de los cuatro) y tiene un selector de idioma arriba a la derecha. Están traducidos todos los textos: pasos, campos, sugerencias, mensajes de error (base de datos, SMTP, iconos), el email de prueba, la página final y la de eliminación del instalador. El idioma elegido se convierte en el idioma predeterminado del sitio, y se puede cambiar en el paso Idiomas. La zona horaria y el país propuestos siguen el idioma. Diccionario en install/i18n.php; la elección vive en la sesión y en la cookie jc_install_lang. (manual 14 §3)

Corregido 3 entradas

  • Acceso con token: se acabó el error fatal. La verificación del token consultaba un servicio externo de la instalación original y usaba las constantes PM_CLIENT_*, que en JoeCMS no están definidas: la petición se detenía con un error fatal. Ahora el token se verifica en la base de datos del sitio. Un token que no existe se rechaza, cosa que antes no ocurría: read() devuelve un array vacío, que acababa en la rama del éxito. Los tokens nuevos reciben una caducidad real (ahora más la duración): antes se guardaba solo la duración, es decir, una fecha de 1970. (vendor/wolfgan/auth/services/token.php)
  • Activación y recuperación de contraseña sin callback configurado. Los widgets activation y recover llamaban al callback del proyecto sin comprobar que existiera: si el proyecto no definía uno, el paso final fallaba. Ahora el callback es opcional, como ya lo era en login y registration. (vendor/wolfgan/auth/widgets/activation/index.php, vendor/wolfgan/auth/widgets/recover/index.php)
  • Datos personales: sin TypeError ante un resultado de lectura inesperado. Anagraph contaba el resultado antes de comprobar que fuera un array; con PHP 8 un resultado que no es un array da TypeError. (vendor/hcore/anagraph/Anagraph.php)

1.4.2

23 sept 2026

Corregido 2 entradas

  • Email: las imágenes inline y los adjuntos se convierten en enlaces. Algunos relays (JoeSMTP, Aruba) rechazan el mensaje entero si contiene una parte adjunta — 550 … Attachments are not supported — y las imágenes cid: son partes adjuntas a todos los efectos: los emails con el logo no salían. Mailer ahora reescribe los cid: como URL absolutas y añade los adjuntos al final del cuerpo como lista de enlaces (los uploads pasan por CM_SHOWFILES). Cuando la dirección no se puede obtener — archivo fuera de la docroot, WWW_LINK_ABSOLUTE no definida — se mantiene el comportamiento anterior, así ningún proyecto pierde imágenes o adjuntos por una ruta que no existe. Se vuelve atrás con MAILER_EMBED_IMAGES y MAILER_EMBED_ATTACHMENTS a true en el config. (vendor/wolfgan/mailer/Mailer.php, manual 06 §2)
  • Página de activación de cuenta: error incluso cuando el email salía. La corrección de la 1.4.0 leía el resultado de Notifier::send() tal cual, pero con un solo servicio de notificación configurado ese método devuelve true cuando el envío tiene éxito: true acababa en $res["error"] y /attivazione respondía 500, con un error sin texto, justo en el caso bueno — el código se había enviado. Ahora el resultado pasa por un único punto (Auth::erroreInvio(), vendor/wolfgan/auth/Auth.php): es un error solo si es una cadena no vacía, o la clave error del array que se devuelve cuando hay más de un servicio. Vale para la rama email y para la SMS.

Seguridad 1 entrada

  • El código de activación ya no vuelve al navegador. La petición de envío del código (el POST del widget activation) devolvía al cliente, dentro del JSON de respuesta, también el código de 6 cifras recién enviado por email: bastaba leerlo en las herramientas de desarrollo para activar una cuenta sin acceso al buzón. El campo ahora se vacía antes de la respuesta (vendor/wolfgan/auth/widgets/activation/index.php); el widget no lo usaba — toma el código de los campos que rellena quien ha recibido el email — así que la página se comporta como antes. (manual 08 §5)

1.4.1

23 sept 2026

Corregido 1 entrada

  • Página de activación de cuenta: el botón no respondía en los sitios que renderizan el widget en su propia estructura pública en lugar del layout del CMS. El script del widget llamaba al loader del tema (showLoader), que allí no existe: el error JS lo detenía todo antes de la llamada al servidor, y en la página no aparecía nada. Ahora el loader se usa si existe (vendor/wolfgan/auth/widgets/activation/script.js). En el mismo paso, un error de red o del servidor ya no deja la página a medias: el botón vuelve a estar activo y aparece el mensaje de error.

1.4.0

23 sept 2026

Añadido 1 entrada

  • API pública: endpoints adicionales sin tocar el core, y subrutas. La whitelist de api/1.0/index.php se amplía con la constante JC_API_ENDPOINTS (lista separada por comas) en el config de la instalación; auth siempre está. Antes cada proyecto tenía que modificar el front controller a mano, y el nombre de un endpoint vertical acababa dentro del CMS. api/1.0/.htaccess enruta también /api/1.0/<ep>/<recurso>/… y pasa el resto de la ruta en _path: antes la ruta se detenía en el primer segmento, y un endpoint con varios recursos tenía que poner el "qué" en el body, lo que en una GET no tiene sentido. Los endpoints existentes no cambian.

Corregido 1 entrada

  • Página de activación de cuenta: cuando el email con el código no salía, /attivazione respondía 500 con página en blanco en lugar de decir qué había fallado. El resultado de Notifier::send() se leía como array, pero es una cadena cuando el envío falla (vendor/wolfgan/auth/Auth.php). Ahora el error del envío aparece en la página — y sigue visible también la causa real, que hay que resolver en el lado SMTP.

1.3.2

21 sept 2026

Corregido 2 entradas

  • Instalador, email de prueba SMTP: con el puerto 587 fallaba siempre (y el sitio instalado no enviaba correo) porque el cifrado estaba fijo en SSL. Ahora se elige (SSL/TLS, STARTTLS, ninguno), la contraseña no se pierde tras la prueba y el error muestra la respuesta del servidor (install/index.php, install/lib.php).
  • Instalador, tecla Intro en el paso Aplicación: pulsada en un campo enviaba el email de prueba en lugar de continuar; ahora equivale a "Continuar".

1.3.1

21 sept 2026

Añadido 5 entradas

  • Despliegue de la rama activa en producción: bin/deploy.sh (+ bin/deploy.conf.example, bin/.htaccess). Sube por SSH el HEAD de la rama git en la que estás — nunca los archivos sin commit — y solo los que cambiaron desde el último despliegue, que el servidor recuerda en $HOME/.joecms-deploy-rev-<sitio> (en la home del usuario SSH, no en la docroot: no debe ser accesible desde la web; el sufijo con el nombre del sitio sirve cuando en el mismo servidor, con el mismo usuario, hay varias instalaciones). Sustituye la subida de archivos sueltos, que deja en producción una mezcla de versiones no reproducible en local.
    • controlla hace el diagnóstico del servidor: usuario, docroot encontrada sola, binarios PHP con mysqli/mbstring, permisos de cache/ y uploads/, commit registrado.
    • Sin --vai es una prueba en vacío que no toca el servidor. Luego --completo, --rimuovi, --svuota-cache, --da <sha>, --solo <path>, --forza, --niente-smoke.
    • No arranca si se entra como root sin DEPLOY_CHOWN: los archivos quedarían de root y con suexec o suPHP el sitio respondería 500 a todo.
    • Nunca sube config.remote.php/config.local.php, el .htaccess raíz (en producción es el que escribió el instalador con el dominio real), install/ (ya eliminado por install/cleanup.php al final de la instalación), database.sql, cache/ ni el material de trabajo. Cuando una de estas cosas cambia lo dice en el resumen — migraciones de docs/sql/ que aplicar antes del código, define() nuevas en el config.remote.php.dist, .htaccess modificado — en lugar de subirla a escondidas.
    • Smoke test HTTP al final del despliegue desde el ordenador de quien despliega, con una ruta por idioma en un sitio multilingüe: es el control que descubre el idioma que se ha quedado atrás. Si el proyecto tiene tests/run.php con tests/smoke.config.php, usa esa suite.
    • La configuración está en bin/deploy.conf, fuera de git porque es por instalación.
    • Varios entornos por sitio (producción, staging): --ambiente <nombre> lee bin/deploy.<nombre>.conf en lugar de bin/deploy.conf, y se detiene si el archivo no existe en lugar de recurrir al entorno por defecto. bin/.htaccess (Require all denied) mantiene la carpeta fuera de la web.
  • Idioma preferido del usuario, para las páginas y las comunicaciones. library/gallery/common/language_preference.php resuelve el idioma de cada petición pública y recuerda la elección en la cookie y, para quien está autenticado, en el perfil (access_users.locale/ID_lang, anagraph.ID_lang). Orden: ?lang= explícito → prefijo URL → perfil → cookie → Accept-Language (solo en la raíz, en la primera visita) → predeterminado. El kernel lo llama después de Auth::check(), así que vale también para las páginas no cacheables; cache_check_lang() ahora remite a él.
    • El selector de idioma enlaza siempre con ?lang=: es la única señal que actualiza también el perfil. Abrir un enlace /en/… cambia solo la cookie.
    • Emails y notificaciones salen en el idioma del destinatario, incluso desde cron y jobs asíncronos: process_mail() lo obtiene de la dirección si quien llama no pasa un "lang"; Notifier hace un envío por idioma; nuevo Mailer::setLang().
    • Helpers para el código de proyecto: language_pref_for_user(), language_pref_for_email().
  • SMS vía JoeSMTP (servicio sms.joesmtp, driver vendor/hcore/notifier/services/sms_joesmtp.php): los SMS del Notifier pueden salir desde la API transaccional de JoeSMTP (/api/1.0/sms-send, client credentials del proyecto). Si están configurados tanto JoeSMTP como Twilio, sale JoeSMTP. Configurable también desde el asistente, paso Servicios.
  • Segundo factor en el login (2FA) por email o SMS, activado con AUTH_2FA en config.remote.php (el instalador lo escribe vacío = apagado). El widget de login pide el código solo. Ver manual 08 §5bis.
  • Push por usuario: el navegador vincula la suscripción OneSignal al usuario conectado (OneSignal.login, ID leído de /OneSignalIdentity, nunca escrito en el HTML en caché) y el servidor la alcanza por ID de usuario. Nuevo campo api_key en el servicio notification.onesignal.

Corregido 15 entradas

  • Fatal error en toda URL que contiene la palabra source o destination (p. ej. /esperto-risponde/sources/nginx.conf, típico de los escaneos automáticos). El kernel fusionaba la ruta declarada por $schema["page"][...]["router"] en su propia tabla con array_replace(): las claves source y destination se convertían en dos rutas, es decir dos regexp literales no ancladas que coincidían con esas URL y mandaban a Cms::execute() a hacer require() de la propia regexp. Ahora mergePageRouter() (vendor/wolfgan/cms/services/kernel.php) fusiona solo la forma de mapa regexp => destino; la forma {source, destination} sigue siendo el dato con el que el kernel reconoce la página (manual 01 §2).
  • 500 en /INSTALL.md (Sentry urbanrunners): la ruta del instalador (^/install(.*) → /conf/gallery/install/$1), que para los grupos service/updater ejecuta library/gallery/system/init.php, llegaba al require() con el $1 sin sustituir. Y como el match de rutas del kernel no distingue mayúsculas, acababa ahí también una URL de documentación probada por un crawler. Ahora responde 404.
  • Como red de seguridad en la misma ruta: Cms::execute() responde 404 — en lugar de morir con fatal error — si el destino no es un archivo existente dentro de la document root, y cmsRouter::run() sustituye los grupos de la regla también en los destinos "a archivo", rechazando aquellos en los que queda un $1 sin resolver o en los que el grupo capturado contiene .., un byte nulo o un esquema de protocolo.
  • Petición bloqueada hasta el max_execution_time en URL con una ruta relativa (p. ej. /srv/request.tar, que llega al kernel como .tar). En get_page_properties() (vendor/wolfgan/cms/services/kernel.php) la subida de carpetas solo salía al llegar a /: en una ruta sin barra inicial dirname() devuelve . indefinidamente y el bucle no terminaba nunca, ocupando un proceso PHP durante 200 segundos — con suficientes peticiones así, el sitio se bloquea solo. Ahora sale también cuando dirname() deja de acortar la ruta.
  • Call to undefined function check_function() en las áreas reservadas con ruta propia (/gestione/… y similares, que no están en la lista de prefijos que se salta el resolvedor de idioma). language_pref_langs() (library/gallery/common/language_preference.php) usaba check_function(), definida en library/gallery/common.php: el kernel llama al resolvedor justo después de Auth::check(), cuando ese archivo aún no está cargado. Ahora pasa por language_pref_has_locale(), que carga get_locale() por sí mismo cuando el autoload del CMS aún no está (manual 12 §6).
  • Home en blanco en un host no previsto: set_header_page() leía WWW_LINK como constante desnuda para componer el title tag. Si hook.php no la definía — las instalaciones antiguas la definían solo dentro de un switch ($_SERVER["HTTP_HOST"]), así que nunca en un host con www., con puerto o detrás de un proxy — en PHP 8 era un Error fatal y el sitio respondía una página en blanco. Ahora la comparación pasa por set_header_page_is_canonical_host(), tolerante con www. y puerto, y sin constante asume el dominio canónico. Las constantes de hook.php ya estaban definidas en toda condición en esta versión: la corrección protege las instalaciones con un hook.php más antiguo que el código (manual 14 §3).
  • El registro guardaba siempre italiano como idioma en anagraph (ID_lang = 1), incluso para quien se registraba desde /en/. La migración docs/sql/2026-09_lingua-profili-allineamento.sql repara los perfiles existentes. Toca solo datos: no va en database.sql y el esquema sigue en 3.
  • El control "manual por actualizar" (.githooks/manuale-check.sh) tenía tres puntos ciegos, surgidos precisamente con el trabajo sobre el idioma: ignoraba una ruta citada con número de línea, descartaba las migraciones de docs/sql/ antes de mandarlas al capítulo 07, y señalaba ocho capítulos en cada modificación de hook.php. Ahora tolera :línea, enruta las migraciones y para hook.php señala solo los capítulos que nombran una función tocada. Nuevo modo --commit <sha> para verificar un commit ya hecho.
  • El pre-commit del manual ahora bloquea una vez en lugar de avisar: Sourcetree muestra la salida de un hook solo cuando falla, así que el aviso no lo veía nadie. Si el manual no hay que tocarlo, basta con repetir el mismo commit. MANUALE_WARN_ONLY=1 vuelve al simple aviso; MANUALE_STRICT ya no existe.
  • ffDb_Sql en ff/classes: mysqli_report(MYSQLI_REPORT_OFF) en connect(), como ya en la copia de vendor/phpformsframework/ffDb_Sql. Desde PHP 8.1 mysqli lanza mysqli_sql_exception en lugar de devolver false, y el driver (que hace @mysqli_*() y luego comprueba errno) no la interceptaba. En las páginas se carga siempre la copia de vendor, pero esta la carga por ruta directa el instalador (conf/gallery/install/common.php): en PHP 8.1+ el asistente acababa en un error fatal al primer error SQL en lugar de mostrar el mensaje.
  • Push web: servicio notification.onesignal llevado al Web SDK v16. Cargaba el stub v15 desde un archivo inexistente (/themes/site/javascript/OneSignalSDK.min.js), así que el push web estaba apagado en todos los sitios. Ahora usa OneSignalSDK.page.js v16 desde el CDN; el worker raíz /OneSignalSDKWorker.js (y el viejo /OneSignalSDKUpdaterWorker.js, para quien se suscribió con la v15) importa OneSignalSDK.sw.js v16. Prompt y campana se configuran desde el panel de OneSignal; el idioma de la página pasa a OneSignal para los envíos multilingües. Sin App ID el servicio no inyecta nada. Eliminados gcm_sender_id del manifest y las rutas excluidas de un sitio antiguo.
  • Push y SMS del Notifier no funcionaban, nunca usados hasta ahora. El driver OneSignal daba un error fatal al primer envío, el de Twilio no hacía ninguna llamada, y send() con un mensaje de texto daba TypeError en PHP 8. Reescritos: OneSignal sobre la REST actual (api.onesignal.com, Authorization: Key), Twilio sobre la REST sin SDK, certificado siempre verificado, resultado en el retorno de send() y fallos en el log notifier_error.
  • 2FA del login ineficaz: la sesión se abría antes de enviar el código, que nunca se verificaba, y era el mismo para todos los usuarios en el mismo minuto. Ahora el código se pide antes de sesión o token, es por usuario y tiene límites de reenvío y de intentos.
  • Notifier: sendMail() pasaba los argumentos en el orden equivocado (las acciones acababan en el título); getStorage() llamaba a setConfig() con un argumento (ArgumentCountError en PHP 8, notificaciones in-app incluidas); un teléfono sin + se tomaba por un ID de usuario (Notifier::normalizeTel()).
  • Asistente: Twilio pedía solo SID y token, pero sin remitente no envía; ahora pide también from.

Eliminado 3 entradas

  • Copias muertas de Notifier, Mailer y Storage en library/classes/ y library/gallery/classes/: el CMS carga solo las de vendor/. En autoload.php, el bloque que apuntaba a library/gallery/models/<clase>, carpeta inexistente.
  • Script de prueba público /api/notifier (conf/gallery/api/notifier/).
  • sendSMSTwilio() y las constantes vacías MOD_SHARE_TWILIO_* en hook.php, nunca usadas: los SMS pasan por el Notifier con las credenciales del área Servicios.

Seguridad 2 entradas

  • Eliminados los conectores del lado servidor de tres librerías vulnerables (traído de GDay en el commit b50933a5, que por error lleva el mensaje del modelo de datos de ese sitio):
    • themes/library/ckfinder/: el conector PHP (core/connector/php/, ckfinder.php, config.php, plugins). Quedan los archivos JavaScript: los widgets ckfinder y ckuploadify de ffField (temas default y restricted) ya no tienen backend y la subida de archivos que pasa por ellos no funciona. Quien los use debe pasar a kcfinder/kcuploadify o al upload del CMS;
    • themes/library/tiny_mce/plugins/filemanager/: el file manager MoxieCode, con autenticadores de ejemplo para Joomla, Mambo, PHPNuke, WordPress y un auth_example.php accesibles desde la web;
    • themes/library/highcharts/exporting-server/: el servidor de exportación de los gráficos.
  • library/security/bootstrap.php (nuevo): helpers para la entrada no fiable reflejada en la salida — pm_safe_dest() (open redirect), pm_js_value()/pm_js_attr() (XSS en JavaScript), pm_html(), pm_safe_token(). Aún no lo carga nadie: el enganche en hook.php y los puntos que lo usan llegan con la intervención siguiente. ⚠️ Antes de cargarlo hay que hacer configurable la lista de dominios admitidos de pm_redirect_allowed_domains(), que hoy contiene los de paginemediche: un redirect absoluto hacia el dominio del sitio se descartaría (las rutas relativas pasan).

Documentación 3 entradas

  • Manual alineado con el trabajo sobre notificaciones, SMS y 2FA: 06 reescrito en las secciones 1, 3 y 4 (drivers del Notifier, servicios y campos, OneSignal v16, JoeSMTP), 08 §5bis (segundo factor), 10 y el mapa de capacidades.
  • Manual alineado con el trabajo sobre el idioma: 12 §Multilingüe (resolvedor y orden de resolución), 06 §2 (idioma del destinatario), 07 (columnas de preferencia, migraciones solo de datos), 01, 08, índice. 14: reglas del mapa y límites del control.
  • Manual 14 §4 reescrito: la sección "despliegue sin ZIP" describía el procedimiento manual (listar las rutas y subirlas a mano), ahora documenta bin/deploy.sh — configuración, opciones, qué no viaja y por qué, caché, smoke test, qué queda a mano. Checklist de puesta en línea actualizada en consecuencia.

1.3.0

18 sept 2026

Añadido 2 entradas

  • El manual (docs/manuale/) viaja en el ZIP (build-zip.sh), como instantánea de la versión: cada capítulo lleva en cabecera versión y fecha del paquete, docs/manuale/VERSIONE.txt declara de qué build viene, los archivos son de solo lectura. En el sitio instalado queda el manual de la versión instalada aunque el CMS avance; la actualización siguiente trae el suyo. Un docs/.htaccess (Require all denied) lo mantiene fuera de la web: describe el interior de la plataforma y se consulta desde el ZIP o vía FTP/panel.
  • Control automático "manual por actualizar", solo en el repositorio principal (.githooks/manuale-check.sh). Compara los archivos modificados con las rutas que cita cada capítulo y señala los capítulos tocados pero no actualizados: el mapa archivo → capítulo se obtiene del propio manual, sin listas que mantener. Salta al final de un turno de Claude Code (hook Stop en .claude/settings.json, que hace actualizar el capítulo antes de cerrar) y al hacer commit (hook git pre-commit, activo con git config core.hooksPath .githooks; avisa sin bloquear, salvo MANUALE_STRICT=1). .githooks/ y .claude/ no entran en el paquete.

Documentación 1 entrada

  • docs/manuale/14-ambienti-e-deploy.md §5: el manual en el paquete, la instantánea inmutable, el control de actualización; checklist de puesta en línea con la entrada sobre el manual.

1.2.2

18 sept 2026

Seguridad 1 entrada

  • Ejecución de código PHP arbitrario desde los parámetros de búsqueda por lugar (ffl, pci, pcn, ppi, ppn, pps, pri, prn, psi, psn, pss). vgCommon::getRequest() escribía el valor que llegaba de la request dentro de un eval() — ?ffl=<código php> en cualquier página pública primaria ejecutaba ese código, sin autenticación (el kernel activa los parámetros en toda página primaria no reservada). Ahora la ruta de destino (["filter"]["place"]["city"]["ID"]) se resuelve por claves con preg_match_all y la asignación se hace por referencia: el valor nunca se interpreta como código, y solo se aceptan valores escalares. Efecto colateral: la búsqueda por lugar con valores de texto (?pcn=roma) vuelve a funcionar — en PHP 8 el eval fallaba con Error: Undefined constant "roma".

Corregido 2 entradas

  • 500 en URL malformadas construidas por bots (TypeError: urlencode(): Argument #1 ($string) must be of type string, array given, vendor/wolfgan/vgCommon.php). Cuando un escáner enviaba un parámetro con valor array y nombre "sucio" (p. ej. ?<?php $env[...]=...), la construcción de la query de los parámetros descartados llamaba a urlencode() sobre un array: en PHP 8 es un fatal, así que la página respondía 500 y el error acababa en Sentry. Ahora los valores array se serializan con http_build_query().
  • Sitio en blanco (500) justo después de la instalación, con Error: Undefined constant "DOMAIN_PROD". Las constantes de dominio se definían solo si el host de la petición coincidía exactamente con el dominio escrito en el asistente: bastaba la diferencia de un www. para que toda página pública diera error fatal. Ahora hook.php reconoce el dominio ignorando www. y puerto, y define igualmente DOMAIN_PROD, WWW_LINK, WWW_LINK_ABSOLUTE y LOCAL_DOMAIN; la regla que pone noindex fuera de producción (library/gallery/common/set_header_page.php) ya no lee constantes desnudas. De rebote, un sitio de staging servido en un host distinto del declarado ahora se marca realmente noindex,follow.

Cambiado 1 entrada

  • El paquete ya no contiene scripts shell: build-zip.sh (herramienta de build, inútil en el servidor porque trabaja sobre git ls-files) y los .sh residuales dentro de vendor/, library/ y themes/library/ se excluyen del ZIP. Un .sh ejecutable en la document root era solo superficie de ataque de más. El build lo señala en la verificación final ("scripts shell en el paquete").

Documentación 1 entrada

  • Nuevo manual de la plataforma en docs/manuale/ (15 documentos): qué permite el sistema y cómo se hace, capítulo a capítulo — ciclo de una petición y enrutamiento, páginas/plantillas/applets, servicios HTTP y webhooks, API interna y pública, cron/jobs/workers, email-notificaciones-SMS-push, datos y modelo de contenidos, auth y permisos, backend y secciones ffGrid/ffRecord, módulos y servicios de terceros, medios y archivos, caché, observabilidad y CLI, entornos y despliegue. El índice (docs/manuale/00-INDICE.md) contiene un mapa de capacidades con el estado de cada una (en producción / por configurar / andamiaje upstream) y la lista de reglas no negociables. Cubre subsistemas hasta ahora no documentados en el repo: bus de servicios /srv/request, clase Jobs (cola y llamadas asíncronas), Notifier (notificaciones, push OneSignal, SMS Twilio), Storage multi-driver, showfiles y los modos de imagen, $schema["request"] como whitelist de parámetros, subida del router en lugar del 404. Parte del contenido se ha recuperado de los proyectos hermanos sobre el mismo stack (JoeSING, JoeQUIZ, JoeSMTP), donde mecanismos generales del CMS estaban documentados solo en el proyecto que los había usado primero.

1.2.1

16 sept 2026

Corregido 1 entrada

  • Todas las páginas respondían 500 en una instalación nueva: Error: Undefined constant "FF_PHP_EXT" (index.php, library/gallery/common/content_i18n.php). La carga del manifiesto de los slugs localizados usaba FF_PHP_EXT, constante definida por ff/main.php — que en ese punto aún no está cargado, porque el framework entra más adelante desde cm/main.php. En desarrollo el defecto quedaba invisible: el servidor PHP interno pasa por router.php, que carga ff/main.php antes de index.php. En Apache/PHP-FPM, en cambio, index.php es el primer archivo ejecutado y en PHP 8 una constante no definida es un error fatal. Ahora el bootstrap usa __DIR__ y la extensión escrita completa, sin depender de constantes del framework.

1.2.0

16 sept 2026

Añadido 7 entradas

  • Icono del sitio pedido en la instalación, y todos los formatos generados a partir de esa única imagen (install/icons.php, nuevo; paso Apariencia del asistente). Hasta ahora quien instalaba JoeCMS se quedaba con la favicon de JoeCMS hasta que sustituía a mano media docena de archivos, cada uno con su tamaño y su nombre. Ahora se sube una imagen cuadrada (PNG, JPEG, GIF, WebP, o SVG si el servidor tiene Imagick) y el instalador escribe: favicon.ico — verdadero ICO multitamaño 16/32/48, escrito en PHP sin dependencias — favicon.png, favicon-16x16.png, favicon-32x32.png, apple-touch-icon.png (180×180 sobre fondo sólido, porque iOS vuelve negra la transparencia), el set PWA iconpreview-NN-NN.png de 36 a 512 px en /media-resource/, el icono maskable para Android, los mosaicos de Windows mstile-*.png y el original en uploads/loghi/icona-sito.png para regenerar más adelante. La favicon.svg se reescribe encapsulando el nuevo PNG: si no, ganaría ella, porque los navegadores prefieren el vectorial.
  • manifest.json y browserconfig.xml creados durante la instalación, rellenados con los datos ya recogidos por el asistente: nombre y nombre corto de la app, descripción, idioma predeterminado, start_url/scope que tienen en cuenta el site path, colores y la lista de solo los iconos realmente presentes en disco. No hace falta subirlos: un sitio recién instalado ya es instalable como app y muestra el mosaico correcto en Windows. Si no se sube ninguna imagen el set se genera igualmente a partir del icono JoeCMS del paquete, así el manifest nunca apunta a archivos inexistentes (era el caso del viejo site.webmanifest, que citaba un /icon-192.png que nunca existió). El tema enlaza manifest.json cuando existe, y añade los meta theme-color, msapplication-config y msapplication-TileColor.
  • Color del tema y color de fondo de la app elegidos en el paso Apariencia, con campos que se pueden dejar vacíos: en ese caso el color del tema se obtiene de la imagen (color dominante, descartando transparencias, blancos y negros). Acaban en manifest.json, en browserconfig.xml y en las constantes JC_THEME_COLOR/JC_BG_COLOR de config.remote.php.
  • Páginas de error 404 y 500 de marca (cm/errori.php, cm/extras/404.html, cm/extras/500.html). Antes el CMS respondía mal las dos veces que importa: el 404 del kernel era un <h1> sin página alrededor, el de Apache (ErrorDocument → cm/error.php) salía con cuerpo vacío, y un error fatal — con display_errors a 0, como debe ser en producción — daba página en blanco. Ahora las tres puertas convergen en una sola función, cms_error_document(), y las páginas son tarjetas JoeCMS con CSS en línea: ninguna dependencia de red, porque una página de error debe aparecer incluso cuando el resto no responde. Un sitio que parte de JoeCMS las tiene enseguida, y las sustituye poniendo las suyas en conf/cm/extras/ (esa ruta siempre gana sobre cm/extras/).
  • Los errores fatales y las excepciones no capturadas se convierten en un 500 legible (cms_error_handler_register(), enganchada en index.php justo después de CMS_START). La página nunca muestra mensaje, archivo ni línea: muestra una referencia de diez caracteres que acaba también en error_log junto al error real y a la URL, así un aviso se encuentra con un grep. Si la salida estaba en buffer se descarta (nada de página truncada); si ya se había enviado no se imprime nada. Las peticiones bajo /srv/, /rt/, /api/ y las XHR reciben JSON, no HTML. Con __debug__ o display_errors activado el sistema se hace a un lado: en desarrollo el error hay que leerlo. Registrado antes de Sentry a propósito: así Sentry encapsula nuestros handlers en lugar de sustituirlos, y el shutdown handler no llama a exit para no impedir el envío del evento.
  • Este changelog, reconstruido a partir de git y de las sesiones de trabajo, y distribuido dentro del paquete: CHANGELOG.md es el único markdown que sobrevive a las exclusiones de build-zip.sh, así quien instala ve qué cambia entre una versión y otra.
  • build-zip.sh avisa si falta la sección de la versión en build y verifica al final del build que el changelog haya acabado en el zip.

Corregido 7 entradas

  • Cookie de sesión: doble cookie homónima, login imposible (vendor/wolfgan/auth/services/session.php). session_start() se llamaba antes de configurar los parámetros de la cookie, así que PHP emitía una cookie host-only y sin flags; justo después la aplicación emitía una segunda, con el mismo nombre pero Domain=.dominio. El navegador conservaba ambas y las enviaba juntas: en $_COOKIE sobrevivía solo una, a menudo la equivocada, y la sesión resultaba siempre inválida — el único remedio era borrar las cookies a mano. Ahora los parámetros se configuran una sola vez antes de abrir la sesión, y la cookie emitida es una.
  • El logout no borraba las cookies: cookie_destroy() usaba lifetime (0) como caducidad, es decir escribía una cookie de sesión en lugar de borrarla, y probaba solo el dominio HTTP_HOST, que no toca las cookies host-only. Ahora la caducidad está en el pasado y se borran ambas formas.
  • secure ya no está fijado a true: se deduce de la conexión (MOD_AUTH_COOKIE_SECURE para forzarlo). En HTTP el navegador descartaba la cookie y en desarrollo el login no se sostenía.
  • SameSite pasa de None a Lax (MOD_AUTH_COOKIE_SAMESITE para volver a None, que sigue siendo necesario solo si el sitio se incrusta en un iframe de terceros). None exponía la cookie de sesión a toda petición cross-site.
  • Sin atributo Domain en localhost y en las direcciones IP: los navegadores descartan la cookie y la sesión no se sostenía en desarrollo.
  • session_regenerate_id(true) se invocaba después de session_destroy(), sin sesión activa: no regeneraba nada. Ahora va después de session_start().
  • build-zip.sh: la exclusión de los markdown distinguía mayúsculas y dejaba pasar los .MD de los vendors (p. ej. library/algoliasearch-client/DOCKER_README.MD).

Cambiado 1 entrada

  • SESSION_NAME se deriva del dominio, ya no es fijo: PHPSESS_[tercero][segundo][AAAAMM], con el tercer nivel omitido cuando es www (quiz.esempio.com → PHPSESS_quizesempio202609). Sirve porque dos instalaciones bajo el mismo dominio padre comparten las cookies: con el mismo nombre las sesiones se pisan. Año y mes son los de la instalación y quedan congelados en la constante — recalcularlos en cada petición desconectaría a todos en cada cambio de mes. Nueva función jc_session_name() en install/lib.php; el viejo instalador usa installer_session_name() en conf/gallery/install/common.php.

1.1.0

29 ago 2026 Esquema BD → 3

Añadido 5 entradas

  • build-zip.sh — build del paquete de instalación (joecms-<versión>.zip, ~77 MB). Empaqueta los archivos rastreados por git en el estado del working tree, excluye los config de entorno (quedan los .dist), el .htaccess de desarrollo, los *.md de la raíz, los source maps y los directorios de test/doc/example de los vendors; vacía cache/ y de uploads/ conserva solo loghi. Verifica por sí mismo que no acaben secretos en el paquete y que seed e instalador estén presentes.
  • Sitemap — generador propio (modules/cms-common/models/Sitemap.php, conf/gallery/sitemap/, configuración por sitio en themes/site/conf/sitemap.php). Documentada en GUIDA_SITEMAP.md.
  • Herramientas de administración como servicio (conf/gallery/services/admin.tools/): barra de administración y guías de alineación se convierten en dos interruptores en /restricted/services/admin.tools, apagados por defecto y por dominio.
  • Guía del CMS generada por el instalador (install/guide.php), producida en todos los idiomas activos de la instalación.
  • Documentación: PANORAMICA_JOECMS.md (cómo está hecho y qué queda abierto), IGIENE_SEGRETI.md, GUIDA_SITEMAP.md.

Cambiado 4 entradas

  • Higiene de secretos: los config de entorno (config.local.php, config.remote*.php) se han sacado del repositorio; en git queda solo config.remote.php.dist. El instalador regenera el config real en el primer arranque, con chmod 0640.
  • robots.txt generado: excluidos también /search/, /area-utente/, /srv/; confirmada la regla para los crawlers de IA (indexación sí, entrenamiento no).
  • Contenidos multilingües (content_i18n.php, process/language.php), toolbar de administración del lado JS, frame de administración, tipografía del tema site.
  • Parches de compatibilidad en los vendors: google-api-php-client, wolfgan/* (Auth, Storage, Filemanager, vgCommon), ffDb_Sql_mysqli, ffDb_MongoDB.

Esquema 1 entrada

  • JC_SCHEMA_VERSION 2 → 3 (cambios en database.sql).

1.0.6

29 jul 2026

Cambiado 4 entradas

  • VGallery Next: editor de nodos reescrito y aligerado (conf/gallery/manage/vgallery-next/), contrato del formulario (FormContract) ampliado; la escritura sigue pasando por la ruta original vía $_REQUEST.
  • Tema vgnext: theme_settings.xml y hoja de estilo de los formularios (vgnext-form.css) propios.
  • Motor de idiomas (process/language.php) y caché de sistema (system/cache.php) revisados; enganche en system/init.php.
  • Header del sitio y pasos del instalador (install/index.php, view.php).

1.0.5

28 jul 2026

Añadido 2 entradas

  • Guía interna del CMS producida al final de la instalación.
  • Ajustes específicos por dominio: las opciones ya no son globales sino ligadas al dominio servido.

1.0.3

27 jul 2026

Añadido 7 entradas

  • Gestión de usuarios y grupos en /restricted/users y /restricted/groups (antes eran páginas vacías): listas y formularios de edición sobre access_users / registro.
  • VGallery Next — nueva área de administración para los nodos (conf/gallery/manage/vgallery-next/) con repositorio, layout y editor propios; plan en VGALLERY_NEXT_PIANO.md.
  • Barra de administración en el front-end y guías de alineación.
  • Registro migrado a widget (modules/auth/contents/registration/), con la cuenta gestionada desde el backend; el viejo contents/registrazione/ se ha eliminado y las páginas se han renombrado a registration.
  • Gestión de idiomas en el asistente y en el backend; páginas de autenticación traducidas y redirecciones de idioma vía cookie.
  • Seed de la base de datos y conf/gallery/config.php alineado.
  • Integración Sentry (bootstrap + selftest).

Corregido 4 entradas

  • [LANGUAGE_SWITCHER] impreso literalmente en las páginas del front-end (p. ej. /login).
  • TRACE_VISITOR no definido → fatal en tiempo de ejecución durante el asistente.
  • /restricted/{tags,place,resources}: error 500 en la tabla de usuarios.
  • Pestañas que no funcionaban en los popups del backend y diálogo invisible en el campo actex (Estructura).

1.0.0

26 jul 2026

Añadido 8 entradas

  • Instalador automático estilo WordPress (install/): asistente, generación del config, install.lock, autodesactivación, install/cleanup.php que borra /install al final de la instalación. Plan en INSTALLER_PIANO.md.
  • Versionado: JC_VERSION y JC_SCHEMA_VERSION, escritas en el config generado.
  • Branding JoeCMS: identidad, logo, paleta.
  • Servicio API de autenticación (api/1.0): client credentials → Bearer token, con los helpers joecms_api_* en hook.php.
  • Autenticación completa del lado del sitio: registro, login, recuperación de contraseña, activación.
  • Multilingüe, banner de cookies, nuevos headers y footers, nueva home, nuevos servicios.
  • Previsualizador de emails y envío con logo inline (cid:, nunca URL).
  • Indexación IA: llms.txt, versión Markdown de los contenidos, reglas robots para los bots de IA (GUIDA_INDICIZZAZIONE_AI.md).

Eliminado 1 entrada

  • Todo el residuo del proyecto legacy del que nace el código: más de un centenar de conf/packages/*.xml (applets y configuraciones de medici-online / liveinhealth), servicios ya no usados, referencias a dominios y rutas del viejo entorno, contraseñas en claro en los fuentes.

Pre-1.0

2026-04-29 → 2026-07-20 · migración PHP 7 → PHP 8
Fin de la historia. Todo empezó aquí.