Vai al contenuto
JoeCMS Scarica 3.1.5

Changelog

Ogni versione di JoeCMS, descritta per quello che cambia a chi lo usa.

3.1.5

8 nov 2026 Ultima versione stabile

Sicurezza 1 voce

  • /install chiuso sui siti installati. Il vecchio installer, quando il sito è già configurato, precompila il suo form con la configurazione in uso, password del database e dell'SMTP comprese, e accetta l'invio del form (frmAction=install). Era raggiungibile dalla rotta pubblica /install senza alcun login. Ora, su un sito installato, l'installer si apre solo dal backend (Configurazione → Base, /admin/configuration/install, dove il login lo chiede il CMS); ogni altro indirizzo, /install compreso in ogni sua variante (/INSTALL, /install/, ?setup), risponde 404. Il controllo sta in testa all'installer, così vale qualunque strada porti lì. (conf/gallery/install/index.php; manuale 01)

Corretto 3 voci

  • Uno store non raggiungibile non porta più via la pagina. Con DEBUG_MODE acceso, un isError() su uno storage non configurato — tipicamente le statistiche di pagina su MongoDB, che in un'installazione nuova non c'è — stampava la scheda d'errore e chiudeva la pagina al posto della pagina richiesta: /login rispondeva con l'errore del CMS e sembrava rotto. Ora quel caso scrive una riga in cache/logs/…_storage_nosql.txt e la pagina prosegue. Con il debug spento la pagina usciva già: l'errore finiva in …_error_critical.txt, ora va nel log dello storage. Il ramo SQL resta com'era: un database relazionale mancante deve farsi sentire (vendor/wolfgan/storage/Storage.php, controller_nosql).
  • /install non risponde più 500. Un GET /install su un sito già installato — per esempio la scansione di un crawler — finiva in un E_USER_ERROR («Catrina: Percorso Riservato. Verificare perche entra qui»), quindi in una pagina d'errore e in una segnalazione in Sentry. cmsRouter::regexp() espandeva il * in (.*) anche dentro un gruppo già scritto a mano, così la source ^/install(.*) diventava ^/install(.(.*)) e non matchava più l'URL corto: la pagina veniva riconosciuta dal kernel, la sua rotta no, e il caso service/updater di system_init_on_before_routing() ricadeva — per un // no break — nel caso actex, che alza l'errore fatale. Stessa fine per /updater/check, che nella sua pagina non ha nemmeno una router. Ora il * diventa (.*) solo fuori dai gruppi, e se la rotta della pagina non chiude la richiesta si prosegue: la prende il router del Content Manager, e un percorso che non esiste risponde 404. (vendor/wolfgan/cms/services/router.php, library/gallery/system/init.php; manuale 01 §2)
  • L'installer si apre su PHP 8. Dal backend (Configurazione → Base) la pagina usciva vuota per tre casi che in PHP 7 erano warning e in PHP 8 sono fatali: il controllo ini_get("mysql.max_persistent") (direttiva di ext/mysql, tolta in PHP 7: ini_get() torna false, il confronto con -1 fallisce sempre e l'installer si dichiarava critico stampando solo «mysql.max_persistent must be Unlimited»); VG_SITE_ADMININSTALL, costante che nessuno definisce, letta al confronto; cm_getClassByFrameworkCss("", "link", null, "bootstrap"), che passa il nome del framework dove serve la struttura già risolta. In più il ramo finale rimandava a /setup, URL che su un sito JoeCMS non esiste: ora rimanda alla stessa URL con ?setup. Le costanti FTP_*, che solo il vecchio config.updater.php definiva, si leggono con defined(): senza credenziali si vede «FTP Path unavailable» invece di un fatal. (conf/gallery/install/index.php, conf/gallery/install/common.php, library/FF/common/framework-css.php)

3.1.3

31 ott 2026

Corretto 2 voci

  • Le POST via ajax arrivano al modulo, non alla pagina da cui partono. Per ogni richiesta XHR su una pagina pubblica, library/gallery/system/init.php prova prima a rendere le sezioni della pagina del Referer, e se ne esce qualcosa risponde con quelle e chiude. Serve alla ricarica dei blocchi, ma prendeva anche gli invii: una POST a /registrazione partita dalla home riceveva l'HTML della home e l'account non veniva creato. Dalla pagina /registrazione funzionava, perché lì le sezioni sono vuote. Ora le POST non prendono più quella strada; le ricariche in GET restano come prima. (manuale 01 §2, 08)
  • La cache di pagina non salva e non serve più le risposte alle POST. La chiave di un file in cache contiene i parametri della richiesta, campi del form compresi: la risposta sbagliata del punto sopra veniva salvata, e chi rimandava gli stessi dati la riceveva dalla cache, anche dalla pagina giusta. check_static_cache_page() ora scarta le POST prima di cercare il file e spegne la scrittura (DISABLE_CACHE). (library/gallery/system/cache.php; manuale 12 §2)

3.1.2

30 ott 2026

Corretto 1 voce

  • bin/deploy.sh si rende eseguibile da solo. Un progetto nato copiando i file di cms riceveva lo script senza il bit di esecuzione, e ./bin/deploy.sh rispondeva permission denied a ogni progetto nuovo. Lanciato una volta con bash bin/deploy.sh, ora lo script rimette il bit su disco e nell'indice di git e chiede di committarlo. (bin/deploy.sh, docs/manuale/14-ambienti-e-deploy.md)

3.1.1

26 ott 2026

Corretto 4 voci

  • Un file di cache scritto a metà non fa più cadere la pagina. Filemanager::save() scriveva il file al suo posto con file_put_contents(..., LOCK_EX): due richieste che riscrivevano lo stesso file (l'indice dei documenti d'errore, che i bot fanno crescere con URL inventati) potevano lasciarne a un'altra una copia troncata, e includerla dava un ParseError fatale (Sentry 155604961). Ora si scrive un file temporaneo e lo si rinomina, che è atomico, e si invalida l'OPcache del file. Un file corrotto che si legge comunque viene cancellato e rifatto alla scrittura successiva, invece di fermare la richiesta; prima, su PHP 8, quel ramo cadeva anche per la costante Filemanager::DEBUG che non esisteva. Corretta la precedenza in SEARCH_IN_KEY || SEARCH_IN_BOTH && isset (fs_php.php, fs_xml.php): una chiave assente tornava array($chiave => null), che vale come vero, ora non torna (vendor/wolfgan/filemanager/; manuale 11 §3). L'indice dei documenti d'errore resta scritto e mai letto, di proposito: cache_get_error_document() lo chiama con gli argomenti invertiti, e rimetterli in ordine renderebbe 404 una pagina sana ogni volta che l'indice è corrotto (library/gallery/system/cache.php).
  • AGENTS.md non va più sul server. bin/deploy.sh lasciava fuori CLAUDE.md e MEMORY.md, ma non AGENTS.md, il file di istruzioni che leggono Antigravity, Cline e gli altri assistenti AI: con il deploy finiva nella docroot, scaricabile da chiunque come il resto della documentazione interna. Ora resta fuori come gli altri due. Su un sito già deployato la copia online va tolta a mano.
  • Un modulo può avere /api nei suoi percorsi. Il kernel e la regola api del core si prendevano qualunque percorso che contenesse /api — /jd/api/me di un modulo, /apicoltura — e lo mandavano alla REST interna del framework, che rispondeva 404 con il corpo vuoto prima che il modulo o la pagina venissero raggiunti. Ora /api è riservato solo come primo segmento, e così /srv nella regola services (prima prendeva anche /blog/srvizio). Un percorso con prefisso di lingua (/en/api/…) non arriva più alla REST interna: la piattaforma non ne usa. Trovato con JoeDesk, le cui API in produzione non rispondevano (vendor/wolfgan/cms/services/kernel.php, conf/routing_table.xml; manuale 01 §3 e 04). bin/deploy.sh non avvisa più dei service file che cominciano per api-: ora funzionano.
  • L'HTML non resta più una settimana nel browser. Il .htaccess dell'installer dava text/html "access plus 1 week": le pagine del CMS dichiarano da sole la loro cache, ma un controller di modulo, uno script su misura o un redirect senza intestazioni restavano sette giorni nel browser, e Apache aggiungeva il suo max-age=604800 anche accanto a quello del PHP. Con JoeDesk il redirect verso il login restava memorizzato e, dopo l'accesso, il browser tornava al login da solo. Ora "access plus 0 seconds" (install/lib.php, .htaccess, i modelli conf/gallery/install/.htaccess-*.tpl del vecchio installer; manuale 12). Il deploy non carica il .htaccess: sui siti già installati la riga va cambiata a mano.

Sicurezza 2 voci

  • PHPMailer 7.1.1 al posto della 5.2.14. La 5.2.14 è del 2015: ha le falle note del trasporto mail() (CVE-2016-10033, CVE-2016-10045) e non è mai stata aggiornata per PHP 8. La 7.1.1 viene dal tag ufficiale, con il commit che indica Packagist. La piattaforma la carica con i percorsi e i nomi della 5.2: class.phpmailer.php, class.smtp.php e class.pop3.php restano come adattatori (PHPMailer, phpmailerException, SMTP, POP3 sono alias delle classi della 7), quindi Mailer, process_mail() e il codice dei siti non cambiano. Spariscono l'OAuth della 5.2, EasyPeasyICS, NTLM, e con loro get_oauth_token.php e le cartelle examples/ e test/, che sul server erano script eseguibili da chiunque. Provato con PHP 8.1 e 8.5 su quello che usano Mailer e process_mail() (lingua, SMTP, CC, CCN, Reply-To, immagini incorporate, allegati, quoted-printable, catch (phpmailerException)), e con invii veri via JoeSMTP (library/phpmailer/, vendor/wolfgan/mailer/Mailer.php; manuale 06 §2).
  • I file interni non si aprono più dal browser. Apache serve da sé ogni file che esiste, e il 404 del kernel su /library, /vendor… valeva solo per le richieste che arrivano a index.php. Su desk.giorgiopalermo.com si scaricavano i log del CMS (cache/logs/…_request.txt, 363 KB del giorno, e gli errori SQL), il dump database.sql e CHANGELOG.md, e si eseguivano i PHP di library/, vendor/, ff/, conf/, cache/, migrations/ (get_oauth_token.php di PHPMailer rispondeva 500). Ora il .htaccess dell'installer risponde 404 a PHP, .sql, .log, .sh, .ini, .lock… in quelle cartelle e in applets/, contents/, uploads/, a tutto cache/logs/ e a database.sql e ai .md della radice. Restano aperti i file statici (CKEditor in vendor/), cm/, themes/ e modules/ (install/lib.php, .htaccess, conf/gallery/install/.htaccess-*.tpl; manuale 14 §3 e 01 §3). Il deploy non carica il .htaccess: sui siti già installati il blocco va aggiunto a mano, subito dopo il redirect HTTPS.

3.1.0

10 ott 2026 Schema DB → 5

Corretto 10 voci

  • Gli errori del login sono nella lingua della pagina. Su /en/login, /fr/login o /es/login il form rispondeva comunque in italiano: «Utente non ancora attivato clicca qui», «Username o password errata», «Campo username o password non compilato». Ora Auth::login() risponde in italiano, inglese, francese o spagnolo (le altre lingue ricevono l'inglese), e il link dell'account da attivare porta all'attivazione nella stessa lingua (/en/activation, /fr/attivazione) invece che sempre a /activation. Nella lingua della pagina anche i due messaggi che lo script scrive da sé (risposta senza errore, servizio che non risponde); il 2FA in spagnolo non esce più in inglese. I testi stanno in Auth::text(), come quelli del 2FA: valgono anche senza righe nel dizionario. (vendor/wolfgan/auth/Auth.php, vendor/wolfgan/auth/widgets/login/script.js, manuale 08 §1)
  • Recupero password e attivazione nella lingua della pagina. Il recupero mostrava in italiano le validazioni dei campi, il pulsante «REIMPOSTA PASSWORD», le etichette della robustezza e l'errore del codice sbagliato; «Email mancante o non valida» e le etichette per lettori di schermo delle sei caselle del codice erano in italiano anche nell'attivazione. Ora i testi del browser arrivano dal dizionario attraverso il template del tema, quelli del server da Auth::text(). Il link per tornare all'accesso e i pulsanti finali verso l'area personale rispettano la lingua e JC_USER_AREA_PATH (Auth::userArea()), invece di puntare sempre a /login e /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, manuale 08 §1)
  • Le email dell'account escono nella lingua del destinatario. Attivazione e recupero avevano testo e oggetto in italiano per tutti («Il nostro benvenuto! Codice attivazione: …»). Ora i template usano il dizionario e il Mailer li traduce nella lingua di Mailer::setLang(), cioè quella del profilo del destinatario: prima i codici del template seguivano sempre FF_LOCALE, e da un cron il corpo usciva nella lingua predefinita. L'oggetto lo compone hook.php nella stessa lingua. Un oggetto già scritto non si cerca più nel dizionario: con il codice dentro, ogni invio aggiungeva una riga segnaposto in ff_international. (vendor/wolfgan/mailer/Mailer.php, hook.php, themes/site/contents/email/auth/, manuale 06 §2)
  • L'email del codice 2FA può partire. Il template era auth::account_code.html, un nome che il Mailer non risolve: l'invio falliva (mailer_template_notfound) e il login rispondeva che il codice non si poteva inviare. Ora c'è il template del tema themes/site/contents/email/auth/account_code.html, tradotto, con ripiego su quello del modulo. Il 2FA resta spento di default. (vendor/wolfgan/auth/Auth.php, manuale 08 §5bis)
  • Banner dei cookie tradotto, e di nuovo nella sua forma. I testi erano in italiano fisso: ora sono nel dizionario (svc_cookie_*), e il link all'informativa è nella lingua della pagina. Il CSS in linea perdeva tre regole, cancellate dal motore dei template perché graffe {parola:parola} sembrano variabili: il pannello «Personalizza» restava sempre aperto e su mobile i pulsanti non si allineavano. (themes/gallery/contents/services/cookie.consent.html, conf/gallery/services/cookie.consent/index.php, manuale 10 §4)
  • Pagine 404, 500 e manutenzione nella lingua del visitatore. Erano solo in italiano. I testi ora stanno in cm/errori.php in quattro lingue, scelte dal kernel, dal prefisso dell'indirizzo o dal browser, senza bisogno del database; home e accesso puntano alla stessa lingua. (cm/errori.php, cm/extras/404.html, cm/extras/500.html, cm/maintenance.php, manuale 13 §1bis)
  • La manutenzione ferma davvero il CMS. Dopo la pagina 503 cm/maintenance.php non usciva, e index.php avviava comunque il CMS: durante un aggiornamento, su file a metà, con l'output in coda alla pagina. (cm/maintenance.php)
  • Niente più codici crudi in pagina. Un utente registrato che apriva /restricted tornava all'accesso con mod_auth_profile_not_authorized in un popup; la pagina non trovata del motore VGallery aveva per titolo not_found_title, il riquadro d'errore http_response_empty_title. Le voci ora esistono nelle quattro lingue, e il messaggio di accesso negato è nella lingua dell'utente. (modules/auth/contents/session/index.php, database.sql)
  • Un aggiornamento non sovrascrive più il manifest PWA del sito. Il pacchetto joecms-update-*.zip porta in radice manifest.json con i propri metadati, e l'updater lo estraeva al posto del manifest che l'installer scrive per il sito (nome, colori, icone); con site.webmanifest e browserconfig.xml rimettevano i valori di partenza del repository. Ora l'updater protegge i tre file e il pacchetto di aggiornamento non contiene quelli PWA. Chi aggiorna dalla 3.0.3 con l'updater (che è ancora il vecchio) si ritrova manifest.json con i metadati: basta cancellarlo, e il tema usa site.webmanifest, che questo pacchetto non tocca. (library/updater/JoeCmsUpdater.php, build-zip.sh, library/gallery/common/set_header_page.php)
  • Popup del tema nella lingua della pagina. themes/site/javascript/root.js scriveva in italiano i popup di pagamento ed esito, il pulsante di chiusura e l'etichetta dell'occhio della password; il messaggio di pagamento riuscito parlava di un «tesseramento», rimasto da un altro progetto. (themes/site/javascript/root.js)

Modificato 1 voce

  • hook.php è tutto della piattaforma; ciò che è del sito sta nel config e in hook.local.php. L'installer scriveva il dominio dentro hook.php, che il pacchetto di aggiornamento sostituisce: applicando un aggiornamento un sito perdeva il dominio, e con lui la distinzione fra produzione e staging (niente noindex sullo staging), più ogni modifica fatta lì. Ora il dominio è JC_SITE_DOMAIN nel config, che l'aggiornamento non tocca; le costanti iniziali di hook.php (AREA_SEO_SHOW_MODIFY, AREA_PUBLISHING_SHOW_PREVIEW, MOD_SEC_PROFILING, MAX_UPLOAD, …) si cambiano dal config; il codice proprio del sito va in hook.local.php, che hook.php include in fondo, l'updater protegge e il pacchetto non contiene. L'updater porta da sé il dominio dal vecchio hook.php al config, e da ora tiene hook.php nel backup. Con un deploy a mano, prima di caricare il nuovo hook.php si aggiunge al config define('JC_SITE_DOMAIN', 'dominio-del-sito');. (hook.php, install/lib.php, library/updater/JoeCmsUpdater.php, build-zip.sh, manuale 14 §3, 10 §1)

Sicurezza 1 voce

  • ?error= e ?success= non entrano più come HTML nella pagina. themes/site/javascript/root.js metteva il valore del parametro nel popup così com'era: un link come /?error=<img src=x onerror=…> eseguiva codice nel sito. Ora è scritto come testo. (themes/site/javascript/root.js)

Documentazione 1 voce

  • Regola 18: un testo che vede il visitatore non si scrive in una lingua sola, con la tabella di dove va a seconda di chi lo stampa. (manuale 02 §2.3, 00)

Schema 1 voce

  • 5: nel dizionario (ff_international) le voci dei testi pubblici: banner cookie (svc_cookie_*), email dell'account (svc_mail_*), recupero password (svc_rec_err_*, svc_rec_reset_btn, svc_pw_strength, svc_otp_digit) e quelle che mancavano (mod_auth_*_not_authorized, mod_auth_access_denied, not_found_*, http_response_*). Su un sito esistente le porta migrations/schema_0005_testi_multilingua.php, idempotente, che non tocca le traduzioni già scritte dall'amministratore. L'updater la esegue da sé; con un deploy a mano si esegue prima del resto del codice (php bin/update.php --migrations-only --vai o /restricted/updater), altrimenti quei testi escono come codici.

3.0.3

10 ott 2026

Aggiunto 6 voci

  • Motore di aggiornamento automatico non distruttivo e sistema di migrazioni DB. Introdotto il gestore integrato degli aggiornamenti (library/updater/JoeCmsUpdater.php) per consentire il passaggio sicuro e indolore tra versioni del CMS su siti in produzione. Il sistema implementa una blacklist rigida di protezione che non sovrascrive mai config.remote.php, config.local.php, .htaccess, uploads/ né cache, esegue pre-flight check dei requisiti PHP e dei permessi di scrittura, attiva la modalità manutenzione atomica (.maintenance con bypass token) e crea un backup preventivo di sicurezza prima di estrarre i file.
  • CLI per gli aggiornamenti di sistema (bin/update.php). Nuova utility da riga di comando per verificare lo stato dell'installazione (--status), attivare/disattivare la manutenzione (--maintenance on|off), applicare in sicurezza pacchetti ZIP di aggiornamento (--file <path> --vai) o eseguire esclusivamente le migrazioni del database (--migrations-only --vai).
  • Interfaccia Web per aggiornamenti nel backend (/restricted/updater). Nuovo controller di gestione in conf/gallery/manage/updater/index.php con dashboard di stato, monitoraggio di salute della piattaforma, caricamento drag & drop di pacchetti di aggiornamento ZIP, console di log in tempo reale e allineamento guidato delle migrazioni di schema.
  • Registro delle migrazioni incrementali (migrations/ e tabella jc_migrations). Introdotto il sistema di migrazioni database gestito da JoeCms\Updater\MigrationsRunner con supporto a script .sql e .php transazionali. Creata la migrazione baseline migrations/schema_0004_v302_baseline.php corrispondente a JoeCMS 3.0.2 / schema 4.
  • Gestore centralizzato della modalità manutenzione (cm/maintenance.php). Integrato controllo in cima a index.php che restituisce risposta 503 Service Unavailable e template responsive coordinato con la palette del CMS quando è presente .maintenance, consentendo l'accesso continuo agli amministratori provvisti di bypass token.
  • Doppio target di packaging in build-zip.sh (installazione + aggiornamento). Esteso build-zip.sh per generare sia l'archivio completo joecms-<versione>.zip (per nuove installazioni con wizard e seed DB), sia il pacchetto leggero joecms-update-<versione>.zip arricchito di manifest.json e ripulito dell'installer per gli aggiornamenti automatici su siti già attivi.

Corretto 5 voci

  • Routing registrazione multilingua (conf/modules/auth/routing_table.xml). Rimossa l'ancora iniziale rigida ^/ dalla regola mod_auth_registration per consentire il corretto matching dei percorsi localizzati con prefisso lingua (es. /en/registration) verso il controller auth.
  • Resilienza e gestione errori JSON nel controller registrazione (modules/auth/contents/registration/index.php). Incapsulato il gestore delle chiamate POST in un blocco try ... catch (\Throwable $e) con emissione diretta di JSON, disattivando l'interruzione silente di FormsFramework ($db->on_error = "ignore") ed eseguendo il controllo esplicito degli errori SQL su tutte le query. In questo modo qualsiasi errore restituisce una risposta JSON esplicita invece di una risposta HTTP 200 vuota a 0 byte. Aggiunti fallback linguistici difensivi per prevenire eccezioni da mancate traduzioni nel dizionario e isolato il dispatcher eventi post-registrazione.
  • Validazione preventiva e messaggi localizzati nel widget di registrazione (script.js e index.html). Aggiunto controllo preventivo obbligatorio del consenso alla privacy lato client con messaggi localizzati (IT/EN) e gestione migliorata degli errori generici in caso di mancate risposte del server.
  • Hardening compatibilità .htaccess su hosting condivisi. Rimossa la direttiva Options +FollowSymLinks da .htaccess e dai template dell'installer (install/lib.php, conf/gallery/install/.htaccess-*.tpl), che su hosting condivisi con restrizioni (come InfinityFree/iFastNet) causava errori 500. Protetto l'uso dei moduli Apache per gli header CORS e Vary (mod_headers.c, mod_setenvif.c) con blocchi <IfModule> condizionali.
  • Pulizia wizard di installazione (install/index.php). Rimosso un blocco duplicato di codice nella fase di finalizzazione del setup.

3.0.2

9 ott 2026

Corretto 1 voce

  • Prevenzione della doppia compressione HTTP e auto-rilevamento dell'ambiente. Introdotta cm_can_compress() in library/gallery/system/compression.php per rilevare se il web server (Apache con mod_brotli/mod_deflate, OpenResty, Cloudflare) o il motore PHP (zlib.output_compression) gestiscono già la compressione HTTP. In presenza di compressione a monte, PHP serve sempre HTML in chiaro e disattiva la generazione e il servizio di file .gz pre-compressi (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 il bug dei caratteri geroglifici/illeggibili. Se invece il server è privo di moduli di compressione e il client supporta gzip, la compressione PHP viene mantenuta attiva. Aggiunto SetEnv SERVER_COMPRESSION 1 nelle direttive .htaccess (install/lib.php, conf/gallery/install/.htaccess-*.tpl, .htaccess) per segnalare immediatamente la presenza dei moduli Apache a PHP.

3.0.1

9 ott 2026

Modificato 1 voce

  • Compatibilità con PHP 8.4 nei tipi nullable impliciti di librerie e vendor. Normalizzate tutte le dichiarazioni di parametri che utilizzavano la sintassi deprecata Type $param = null rendendole esplicitamente nullable ?Type $param = null nelle librerie e nei vendor (PHPExcel, OAuth2, AlgoliaSearch, CssMin, Facebook SDK, IMAP, Minify, MobileDetect, RabbitMQ, MongoDB, Smarty, Symfony Polyfill, Twilio, Twitter, BunnyCDN). Aggiunto inoltre l'attributo #[AllowDynamicProperties] sulla classe astratta vgCommon per piena compatibilità con PHP 8.2+.

Corretto 4 voci

  • Resilienza nella generazione di icone e anteprime media (ffMedia). Introdotto il metodo helper ffMedia::createLinkOrCopy(), che tenta la creazione dell'hard link tra risorsa sorgente e destinazione (link()) ed esegue un fallback trasparente su copia file (copy()) qualora l'operazione fallisca per vincoli di filesystem (cross-device EXDEV), symlink o restrizioni di permessi dell'hosting, evitando interruzioni fatali. Aggiunti controlli di esistenza sulla modalità e sul wizard prima dell'accesso agli indici array.
  • Gestione sessioni e cookie di autenticazione (authSession). Nel metodo destroy() dell'autenticazione è ora possibile inibire l'emissione anticipata di header Set-Cookie di cancellazione durante la rigenerazione della sessione al login o al ripristino, evitando la perdita del nuovo identificativo di sessione. Migliorata la funzione di controllo sessione su disco (checkSession) evitando falsi negativi quando la directory di sessione non è direttamente leggibile.
  • Reindirizzamento login e percorsi personalizzati dell'area riservata. Il widget di autenticazione e il controller di login supportano ora dinamicamente la costante JC_USER_AREA_PATH per la destinazione post-login, reindirizzano gli amministratori a /restricted ed evitano redirect loop verso /area-utente per gli utenti standard.
  • Risoluzione percorso nel kernel CMS (cmsKernel). Corretta la normalizzazione di path_info in cmsKernel durante la rimozione di enginePath prima dell'estrazione del codice lingua.

Aggiunto 2 voci

  • Installer: percorsi area personale e pagine di autenticazione multilingua. Il wizard di installazione supporta la configurazione differenziata del percorso dell'area riservata per ciascuna lingua abilitata (con fallback predefiniti /area-utente, /user-area, /espace-client, /area-usuario, /benutzerbereich, ecc.). Popola automaticamente il manifest degli slug localizzati contents/i18n.php sia per l'area personale sia per le route di autenticazione (/registrazione, /attivazione, /recupero-password), garantendo i redirect 301 automatici da parte del controller del CMS.
  • Hardening sicurezza e supporto manifest web in .htaccess. Aggiunto il mapping dei tipi MIME per application/manifest+json (.webmanifest, .json) sia nel .htaccess principale sia nei modelli di installazione. Aggiornato il template protettivo .htaccess-noscript.tpl utilizzando blocchi <FilesMatch> e Require all denied per inibire l'accesso ed esecuzione diretta di file script nelle cartelle uploads e cache.

3.0.0

8 ott 2026

Aggiunto 1 voce

  • Modulo nativo Package Manager (modules/package-manager/) per upload e installazione di estensioni ZIP. Aggiunta nel backend di amministrazione (/admin/pacchetti e voce di menu «Gestione Moduli (.zip)») un'area per il caricamento di pacchetti di estensione in formato ZIP (in stile WordPress). Il motore:
    • Valida la sicurezza dell'archivio escludendo tentativi di path traversal (../) o percorsi assoluti;
    • Ispeziona il file descrittore manifest.json presente nel pacchetto;
    • Estrae i componenti nelle rispettive cartelle (modules/<id>/, contents/, themes/);
    • Attiva automaticamente le migrazioni e la DDL del database se manifest.database.schema è definito;
    • Supporta setup wizard interattivi post-installazione per la personalizzazione dei percorsi e delle impostazioni.

2.0.3

8 ott 2026

Corretto 2 voci

  • Anteprima file e immagini con percorso errato nel backend quando si usa CM_SHOWFILES. In ffField_base::process_file() (ff/classes/ffField.php), se un campo definiva file_saved_preview_url con CM_SHOWFILES (es. /cm/showfiles.php/96x96/...), il framework anteponeva incondizionatamente "/uploads" all'URL risultante, producendo link errati e inesistenti come /uploads/cm/showfiles.php/.... Ora gli URL che contengono già CM_SHOWFILES (o /cm/showfiles.php), che iniziano già per /uploads o che sono assoluti (http://, https://, //) vengono utilizzati direttamente; il prefisso /uploads viene applicato solo ai percorsi relativi locali non gestiti dal servizio immagini.
  • Errore di debug su chiamate di autocompletamento con query vuota o sessione mancante. Negli script di parsing dei widget activecomboex, autocomplete, autocompletetoken e autocompletex (themes/responsive/ff/ffField/widgets/*/parsedata.php), se la query SQL in sessione risultava vuota veniva sollevato un ffErrorHandler::raise("debug", ...). Ora restituiscono correttamente un array JSON vuoto ([]), evitando blocchi e messaggi di errore non necessari durante la digitazione.

2.0.2

8 ott 2026

Corretto 2 voci

  • Su hosting che disabilitano exec() il sito non parte: "Call to undefined function exec()". In lettura cache il filemanager validava il frammento PHP con exec("php -l ...") (vendor/wolfgan/filemanager/services/fs_php.php). Su molti hosting condivisi, e su tutti quelli gratuiti, exec/shell_exec stanno nelle disable_functions e la chiamata era un fatale — bastava la prima pagina messa in cache, /login compreso. Ora la sintassi si verifica col parser interno di PHP (token_get_all(..., TOKEN_PARSE), che su PHP 8 lancia una ParseError recuperabile): stesso esito di php -l sui file di cache, ma sempre disponibile e senza sottoprocesso, quindi anche più veloce a ogni lettura (in prova da circa 70 ms a meno di un millisecondo). Per la stessa ragione non vanno più in fatale gli altri punti che usavano i comandi di shell senza guardia: lo stesso controllo di sintassi nei job (Jobs::controller_script(), vendor/hcore/jobs/Jobs.php), installer_commandExist() del wizard (conf/gallery/install/common.php) e ffMedia::commandExist(), che ora considerano il comando assente se shell_exec non c'è, e la conversione dei PDF in miniatura (ffThumb::load_image()), che senza exec ripiega sull'icona generica invece di interrompere la pagina.
  • Miniature di media. in 500 sugli hosting senza shell_exec. ffMedia e ffThumb esistono in due copie, e i siti installati dal wizard (COMPOSER_PATH) caricano quelle di vendor/phpformsframework/ (ffMedia.php, ffImage/ffThumb.php), non quelle di ff/classes/: la guardia ora sta in tutte e due. Senza, ogni copia nuova di un'immagine passava da ffMedia::optimize(), che cerca gli ottimizzatori esterni con shell_exec("which …"), e la sua prima richiesta rispondeva 500.

Documentazione 1 voce

  • Manuale 14 §1: exec() e shell_exec() non sono requisiti. Il sito gira sugli hosting che li disabilitano; senza, mancano solo l'anteprima dei PDF e gli ottimizzatori esterni di immagini, CSS e JS.

2.0.1

6 ott 2026

Corretto 3 voci

  • Con la cache in memoria del router attiva la prima richiesta andava in errore. cmRouter::loadMem() scriveva su $this->router e $this->cache, proprietà che non esistono su cmRouter (le sue sono rules, named_rules, ordered): la lettura scatenava "property «router» not found on class cmRouter". In più trattava un cache miss (null) come un hit (!== false), e ci entrava comunque. Ora popola le proprietà corrette e considera il miss per quello che è. La cache del router delle pagine è anche allineata alla chiave scritta (cache_router, prima __cm_cache__ lato lettura e cache_router lato scrittura): prima non veniva mai riusata. Il default di CM_ENABLE_MEM_CACHING resta false, ed è quello giusto: senza FF_CACHE_ADAPTER la «memoria» è ffGlobals, che dura una richiesta, e accenderla non fa risparmiare nulla; con gli adapter apc e fs su PHP 8 il sito non parte, perché chiamano apc_store()/apc_fetch(), che APCu non ha più, e apc.php estende una classe che non esiste (ffCacheAdapterAdapter). Ha senso solo con redis o memcached e il loro server, e anche lì il guadagno è piccolo: le pagine servite dalla cache di pagina non arrivano al router.
  • cmRouter::orderRules() mancava del tutto. cm::process() la invoca prima di salvare le regole in cache quando CM_ENABLE_MEM_CACHING è attivo, ma il metodo non esisteva in nessuna classe: "function «orderRules» not found on class cmRouter". Ora esiste e ordina ogni bucket di priorità con ffCommon_IndexOrder, lo stesso criterio già usato da cmRouter::process().
  • Documento d'errore su un indirizzo inesistente: la pagina non fa più 500. Una richiesta a un percorso che non esiste — per esempio la scansione /.aws/.env di uno scanner — finisce su system_write_cache_error_document(), che chiama Filemanager::update(): lì read() può tornare un valore non-array (per esempio 1, quando il file incluso non espone né un return né una variabile dichiarata), e su PHP 8 passare un intero ad array_replace() è un TypeError. Ora update() riparte da un array vuoto quando read() non torna un array, come quando il file non esiste ancora: l'indirizzo esce 404, non 500. (vendor/wolfgan/filemanager/services/fs_php.php)

Aggiunto 1 voce

  • Brotli nel .htaccess generato dall'installer. Il wizard (jc_htaccess_static_tail() in install/lib.php) e i modelli del vecchio installer (conf/gallery/install/.htaccess-cms.tpl e .htaccess-base.tpl) aggiungono il filtro mod_brotli, guardato da IfModule: sui server che lo hanno, html, css, js, json, xml e svg escono in Brotli ai browser che lo accettano e in gzip agli altri. Il blocco sta prima di quello DEFLATE: dei due filtri comprime il primo della catena, e messo dopo un browser che accetta sia br sia gzip riceveva sempre gzip (provato su Apache 2.4.68). Il guadagno è piccolo: alla qualità di default di mod_brotli (5) circa il 3% su CSS e JS rispetto a gzip, e l'HTML che arriva dalla cache di pagina resta gzip, perché lo comprime già PHP. Per i siti già installati va riportato a mano, perché il loro .htaccess non viaggia col deploy.

Modificato 2 voci

  • Il Cache-Control delle pagine pubbliche viste da ospiti è una costante. Il max-age cablato a 7 in cache_parse() (library/gallery/system/cache.php) è ora CM_PAGECACHE_GUEST_MAXAGE (cm/conf/config.php, default 7), sovrascrivibile nel config dell'installazione (config.local.php / config.remote.php). Vale per le pagine servite dalla cache di pagina: la risposta che compone la pagina la prima volta esce ancora max-age=3. Riguarda solo gli ospiti: le pagine di chi è entrato restano no-store. Serve ad alzare il TTL per i siti con contenuti non in tempo reale, senza toccare il codice.
  • CM_ENABLE_MEM_CACHING è sovrascrivibile. In conf/gallery/config.php la costante non è più define() incondizionato: un'installazione può accenderla dal proprio config d'ambiente. Default invariato (false), da lasciare così salvo un adapter redis o memcached (vedi «Corretto»). Con la costante attiva funziona anche __CLEARCACHE__ in URL; va accompagnata dalla procedura di svuotamento nel deploy.

Documentazione 2 voci

  • Manuale 12: cache del router e ffCache descritte per quello che il codice fa. Accendere CM_ENABLE_MEM_CACHING non è «un'ottimizzazione gratuita»: senza adapter non fa niente, e con apc o fs su PHP 8 manda il sito in errore. La tabella degli adapter dava fs per «filesystem, default, funziona ovunque»: fs.php è una copia di apc.php (chiama apc_store()), e senza FF_CACHE_ADAPTER la cache dura quanto la richiesta. Il max-age delle pagine pubbliche è descritto nei due casi: 3 quando la pagina si compone, e CM_PAGECACHE_GUEST_MAXAGE quando arriva dalla cache.
  • Manuale 14 §4: con opcache.revalidate_freq alto la cache si svuota dopo, non subito. Nel primo intervallo dopo il caricamento PHP può ancora eseguire la versione vecchia di un file già compilato, mentre i template li legge nuovi dal disco: le pagine rigenerate in quel momento restano nella cache di pagina col codice vecchio. Si svuota cache/ quando quel tempo è passato, oppure si riavvia PHP-FPM del sito prima di svuotarla.

2.0.0

1 ott 2026

Sicurezza 1 voce

  • Password solo bcrypt, anche al login e nel recupero. Il recupero password salvava la nuova password con PASSWORD() di MySQL (SHA1 doppio, senza salt), e così anche ogni scrittura che passa dal modello access. Ora tutte le scritture producono bcrypt (Auth::hashPassword(), campo password del modello in inBcrypt), e il login accetta solo bcrypt (Auth::verifyPassword()): non riconosce più gli hash PASSWORD() e WordPress e non li converte. Chi ha ancora un hash in quei formati deve reimpostare la password con il recupero. Un bcrypt con costo diverso da quello corrente viene riscritto al login. Il login non usa più PASSWORD(), che su MySQL 8 non esiste.

1.7.0

1 ott 2026

Aggiunto 2 voci

  • Registrazione: i campi del progetto arrivano all'evento. Il widget manda anche i campi del form che si chiamano extra[...], così come sono, e on_registration_done li riceve in $dati["extra"] (da validare: vengono dal browser), insieme alla data di nascita in $dati["dob"]. Un progetto aggiunge le sue domande al form senza toccare il widget; senza campi extra non cambia niente. (vendor/wolfgan/auth/widgets/registration/script.js, modules/auth/contents/registration/index.php, manuale 08 §5)
  • Widget di recupero password traducibile. I messaggi di errore, il testo del pulsante dopo l'invio del codice e le etichette della robustezza della password si leggono dal template — data-err-password, data-err-conferma, data-err-diverse su #errorMsg, data-testo-codice sul pulsante, data-etichette (separate da |) sull'etichetta —; senza, restano i testi italiani di sempre. (vendor/wolfgan/auth/widgets/recover/script.js, manuale 08 §1)

Corretto 9 voci

  • Le regole di percorso del kernel si prendevano ogni URL che cominciava come una cartella di sistema. In vendor/wolfgan/cms/services/kernel.php le voci erano '^/conf*', '^/error*', '^/cm*', '^/asset*', '^/cache*', '^/ff*', '^/contents*'… e in cmsRouter::regexp() ogni * diventa (.*), con un preg_match non ancorato in coda: la regola catturava tutto ciò che comincia per quella parola, non solo la cartella. Un sito che pubblicava una pagina /confronto la vedeva rispondere 404 con corpo vuoto — la pagina c'era e funzionava, non ci si arrivava mai — /errore finiva sulla pagina d'errore del CMS, e /cms, /assetto, /cachet, /ffmpeg, /contents-vecchi sulla cartella sbagliata. Ora ogni regola di cartella è '^/nome(/|$)': la cartella e ciò che sta sotto, nient'altro. Vale anche per /themes, /uploads e /asset, che continuano a passare da cm/static.php, e per l'area riservata, /restricted(/|$); restano come erano /static/*, /media/*, /showfiles/* e le regole delle API. Chi ha un sito in esercizio: dopo l'aggiornamento vale la pena controllare se usa indirizzi che cominciavano come una cartella di sistema (manuale 01 §2-3).
  • Lingua: l'elenco delle lingue non fa più cadere le pagine di chi è entrato. Il motore della lingua preferita (library/gallery/common/language_preference.php) gira nel kernel, subito dopo Auth::check(): prima di ff/main.php e prima che il Content Manager carichi i moduli. Lì get_locale() non può funzionare: senza FF_PHP_EXT è «Undefined constant», e con la cache delle lingue fredda passa da mod_auth_get_locale(), che sta in modules/auth/common.php e non esiste ancora («Call to undefined function»). La 1.5.1 aveva chiuso il primo caso evitando lì get_locale() finché il framework non è carico; GDay, ancora sulla 1.3.0, li ha incontrati tutti e due, con ogni pagina dell'area in 500. Ora il motore legge l'elenco dallo schema che il kernel ha già in memoria (cache/locale.php, la stessa ff_languages con status > 0) e lo riusa per tutta la richiesta; e get_locale() stessa non cade più: ripiega su "php" se FF_PHP_EXT manca, e sullo schema del kernel se mod_auth_get_locale() non c'è ancora. (library/gallery/common/language_preference.php, library/gallery/common/get_locale.php)
  • Login: il pulsante «Accedi» non mostrava mai il motivo di un accesso rifiutato. Nello onclick del widget il percorso di ritorno finiva dove lo script si aspetta l'elemento cliccato — hCore.auth.login(url, selector, elem, redirect) — e lì elem va a jQuery: jQuery("/restricted") → «Syntax error, unrecognized expression: /restricted». La risposta moriva prima di scrivere il messaggio dell'API (console a parte, la pagina restava muta); con le credenziali giuste quel ramo non si tocca, perciò il difetto si vedeva solo sugli accessi falliti, sul secondo fattore e sulle reti cadute. Lo stesso onclick aveva la pagina di login del tema, dove in più il ritorno di ?ret_url= si perdeva. Ora i template passano this e il percorso al quarto posto, e lo script accetta come elem solo un elemento (o un id), ripiegando sul contenitore del form. Un tema che ha copiato la pagina col vecchio onclick ora mostra il messaggio, ma per il ritorno va corretto anche lui. (vendor/wolfgan/auth/widgets/login/index.html, index-corretto.html, script.js, themes/site/contents/login/index.html, manuale 08 §1)
  • Recupero password: per molte email vere il codice non partiva. Il validatore voleva un dominio di primo livello di 2-4 lettere e niente + prima della chiocciola: nome@studio.online, nome+studio@gmail.com o un .invalid di collaudo non erano email, Auth::request cercava per username, non trovava a chi scrivere e rispondeva comunque «ok». Ora isEmail usa filter_var(…, FILTER_VALIDATE_EMAIL). (vendor/wolfgan/cms/services/validator.php)
  • Recupero password nei siti multilingua: arrivava il benvenuto col codice di attivazione. hook.php sceglieva il modello dell'email dal PATH_INFO, e lo switch conosceva solo /recover: su /recupero-password o /en/recover finiva nel ramo dell'attivazione (oggetto e modello sbagliati). Ora legge il modello che ha già scelto Auth::request (recover_code o activation_code). (hook.php)
  • /logout era un 404 anche per chi era entrato. modules/auth/contents/logout chiede la regola mod_auth_logout, che nella tabella delle rotte non c'era. (conf/modules/auth/routing_table.xml)
  • Pagamenti: dal sito la classe Payment non si caricava. La conosceva solo autoload.php di radice, che index.php non include (carica quello di Composer): checkout, webhook di Stripe e cron dei pagamenti morivano con «Class Payment not found». L'API la trovava, e i collaudi da riga di comando la caricavano a mano. (vendor/wolfgan/autoload.php, manuale 10 §2)
  • Il deploy portava sul server i collaudi dei moduli (modules/*/tests/), distruttivi sul database che gli si passa. Ora sono esclusi. (bin/deploy.sh, manuale 14 §4)
  • PHP 8.5: curl_close() deprecata. Nel Notifier e in downloadRemoteFile() si chiama solo su PHP 7, dove serve ancora. (vendor/hcore/notifier/Notifier.php, hook.php)

Sicurezza 3 voci

  • ?__debug__ e ?__query__ accendevano la diagnostica a chiunque. Un visitatore qualunque, aggiungendo ?__debug__ all'indirizzo, riaccendeva display_errors e i dump del CMS: percorsi del server, warning, variabili. Ora cm/livello-errori.php toglie i due parametri dalla richiesta a chi non li può chiedere: si aprono da riga di comando, con SetEnv JC_DEBUG_ALLOWED 1 (o la variabile d'ambiente), o su una copia .local vista dalla macchina stessa. Lo include per primo anche l'API, che prima non lo includeva affatto: con ?__debug__ i warning potevano finire dentro il JSON. (cm/livello-errori.php, api/1.0/index.php, manuale 13 §2)
  • Cache: le pagine personali uscivano con public, max-age=3. Chi entrava con il suo account — area utente, gestione — riceveva la pagina con un Cache-Control che la dichiarava pubblica e riusabile per tre secondi: dopo l'uscita il browser rivedeva l'area appena vista, e una cache condivisa avrebbe potuto servirla a un'altra persona. Ora una pagina con use_cache(false), o vista da un utente entrato, esce no-store; per gli ospiti la cache di pagina resta com'era. (library/gallery/system/set_cache_page.php, library/gallery/system/cache.php, manuale 12 §2)
  • checkUserRights(): l'impersonificazione vale solo per un'anagrafica con un account, e il cookie non si riscrive a ogni pagina. L'helper restituisce l'ID anagrafico di chi è entrato (anagraph.ID, quello di Auth::get()["ID"]) o, per un amministratore, quello della persona impersonata (?force_id= o il cookie user-id-value). Ora un ID impersonato si onora solo se è un'anagrafica collegata a un account (anagraph.ID_user); altrimenti si torna all'utente entrato e il cookie si cancella. E si cancella solo se c'è: prima ogni chiamata, per chiunque fosse entrato, aggiungeva alla risposta un Set-Cookie. (hook.php, manuale 08 §2)

Modificato 1 voce

  • Lo schema del database dichiarato nel CHANGELOG si verifica a ogni rilascio. joecms.it lo legge per decidere se la pagina Download deve avvisare che la versione cambia il database. build-zip.sh si ferma, e il pre-commit blocca il commit di rilascio, se la sezione non ha in intestazione · schema **N** con N = JC_SCHEMA_VERSION, se il gruppo ### Schema manca quando lo schema cambia (o c'è quando non cambia), o se database.sql è cambiato senza alzarlo. (.githooks/changelog-schema.php, manuale 14 §5)

Documentazione 1 voce

  • La guardia sul residuo di percorso del manuale non scattava mai. L'esempio leggeva il Content Manager da $GLOBALS["cm"], che è vuoto: cm/main.php gira dentro Cms::execute() e il suo $cm è una variabile locale. Il residuo usciva vuoto senza errori, e un sito che l'ha copiato (joecms.it) mostrava l'indice della Guida al posto di ogni capitolo. Ora l'esempio usa cm::getInstance(), e il manuale avverte che il residuo arriva in minuscolo (ffCommon_url_normalize()). (manuale 01 §4)

1.6.2

28 set 2026

Corretto 2 voci

  • Immagini di media.<dominio> senza copia in cache: niente più 500 né redirect troncati. Quando la copia in cache/.thumbs/ manca e l'originale esiste in uploads/ con lo stesso percorso, ora lo serve Apache, anche a pezzi come vogliono i video su iPhone; le versioni ridimensionate continuano a generarle cm/error.php e ffMedia. Vale per il .htaccess che il wizard scrive alle installazioni nuove (jc_write_htaccess() in install/lib.php) e per il modello del vecchio installer (conf/gallery/install/.htaccess-cms.tpl). Il wizard e il .htaccess del repo avevano in più la condizione sull'host del front controller non ancorata: valeva anche per media. e mandava in 500 ogni copia mancante (exceeded the limit of 10 internal redirects). ffMedia::process() non propone più redirect verso copie inesistenti: per gli originali di cui non riusciva a creare la copia (visto con JPG e video) rispondeva con un 301 permanente verso un percorso troncato (/prodotto-v2/intro.mp4 → tto-v2/intro.mp4), ora con un
    1. I siti già installati vanno aggiornati a mano: il loro .htaccess non viaggia col

    deploy. (ff/classes/ffMedia.php, manuale 11 §5)

  • bin/deploy.sh --svuota-cache non cancella più cache/.thumbs/, le copie servite da media.. Svuotarle tutte insieme, su un sito con la Rewrite Base valida anche per media., ha mandato in 500 ogni immagine (grandchef, 28/9/2026). (manuale 14 §4)

1.6.1

27 set 2026

Corretto 2 voci

  • Backoffice su PHP 8: sei pagine non vanno più in errore. Trovate dal crawler che percorre frontend e backoffice su MySQL 8.4; c'erano già nella 1.5.x.
    • Utility → Sitemap: Call to undefined function cache_get_settings(). sitemap.php usava le funzioni di cache.php senza includerlo, e nel flusso del kernel le carica solo router.php, da cui il backoffice non passa: ora le include lui. La voce di menu puntava a /admin/utility/sitemap, un indirizzo senza pagina che la regola di routing …/sitemap manda al generatore di sezione: ora apre la sitemap del sito, /sitemap.xml. (library/gallery/system/sitemap.php, conf/contents/admin/mod_restricted.xml)
    • Configurazione di Google Maps e del modulo mappe: Undefined constant "TOP_CENTER". Le posizioni dei controlli (TOP_CENTER, SMALL, HORIZONTAL_BAR…) erano costanti non definite, che PHP 7 trasformava nella stringa del loro nome: ora sono stringhe, con lo stesso valore di prima. (conf/gallery/services/google.maps/config/index.php, conf/gallery/modules/maps/config/modify.php)
    • Modifica dominio, e ogni campo valuta senza decimali: Unsupported operand types: string / int. La parte decimale vuota di un importo come 5 veniva divisa come stringa: ora è convertita a numero, in tutti i formati di lingua. (ff/classes/ffData/locale/FormsLocale_*.php)
    • Gruppi (/restricted/groups): "Cannot determine order field!". L'ordinamento predefinito era "level DESC", ma la griglia vuole il nome del campo; la direzione ora sta nel campo level. (conf/gallery/manage/groups/index.php)
    • Esempi dei componenti (/admin/doc/record): "CM: Unable to find Widget". Tolti i due esempi con ckuploadify, che dipende da CKFinder e non c'è nel tema del backoffice; gli esempi "uploadifive" e "kcuploadifive" usano ora quei widget invece dei gemelli.
    • Import (/admin/configuration/import): i link del menu uscivano con {import_path} e {_import_…} crudi, perché quel contenuto non passa dal template. Ora percorso ed etichette sono risolti in PHP. (conf/gallery/import/index.php)
  • Invio email di sistema: niente più fatal Undefined constant "EMAIL_DEBUG". La config del vecchio installer la definiva, quella del wizard no, ed email_system() la legge: servizio di invio, notifiche su inserimento e modifica dei contenuti, anteprime email, modulo di registrazione. Ora ha un default vuoto. (conf/gallery/config.php)

1.6.0

27 set 2026 Schema DB → 4

Corretto 7 voci

  • MySQL 8, Aiven, MariaDB strict: il CMS gira col sql_mode di default dei server moderni (ONLY_FULL_GROUP_BY, STRICT_TRANS_TABLES, NO_ZERO_DATE), senza allentarlo. Provato con installazione, frontend, backoffice, registrazione e salvataggi su MySQL 8.4 (anche col sql_mode di Aiven) e MariaDB 12. (manuale 07 §1)
    • Query con GROUP BY o DISTINCT non ammessi (#1055, #3065) riscritte in una trentina di file: moduli e permessi di layout, sezioni, menu operazioni, griglie del backoffice, API, fatture e pagamenti. Dove si voleva "la prima riga per gruppo" la scelta ora è esplicita (in PHP, ROW_NUMBER() o MIN(ID)), mentre prima dipendeva dal server. Le verifiche su fatture senza pagamenti le raggruppavano tutte in una sola.
    • Schema: DEFAULT esplicito su tutte le colonne NOT NULL (errore #1364 "Field doesn't have a default value"); colonne data nullable e date vuote scritte come NULL invece di '0000-00-00', rifiutato anche solo in un confronto.
    • Scritture: ffDB_Sql::toSqlColumn() adatta il valore vuoto al tipo della colonna (0 per le numeriche, NULL per le date) in ffRecord, ffDetails, Storage e nelle query scritte a mano (errore #1366 "Incorrect integer value: ''"). Le INSERT con '' sulla chiave auto-incrementale scrivono NULL.
    • Dialetto ANSI di Aiven: con PIPES_AS_CONCAT il || concatena invece di fare OR, senza dare errore. L'unico || in una query, lo stato di spedizione dell'API delle operazioni, ora è OR. (conf/gallery/api/get_operation.php)
  • Porta del database: l'installer la chiedeva ma non la scriveva, e ffDB_Sql non la passava a mysqli, per cui un database su porta non standard (Aiven) non si collegava. Ora il wizard scrive FF_DATABASE_PORT e il driver accetta anche host:porta.
  • PHP 8: niente più fatal sem_get(): Argument #1 ($key) must be of type int sulle pagine in cache (es. /login): la chiave del semaforo della cache è sempre un intero (library/gallery/system/cache.php, vendor/wolfgan/cache/services/sem.php).
  • Pagamenti: il driver Stripe senza chiave o senza rete non va più in errore fatale. Dalla 1.5.1 paymentStripe chiamava un metodo errore() che non esisteva: senza chiave segreta, o con la rete giù, invece dell'esito d'errore arrivava Call to undefined method. Ora l'esito d'errore ha la stessa forma del successo (ok a false, error, error_code). In più una fattura risulta pagata anche quando Stripe non manda il campo paid, che le API recenti non hanno più: conta status uguale a paid. (library/payment/services/stripe.php)
  • Siti multilingua: il canonical delle pagine in inglese puntava a quelle italiane. Per una pagina a file in una lingua non di default set_header_page() usava il percorso canonico su disco: /en/contact dichiarava /contattaci, /en dichiarava /, e Google non indicizzava mai la versione tradotta. Ora passa da content_i18n_url(); le pagine di vgallery restano come prima. (library/gallery/common/set_header_page.php, manuale 12 §2)
  • Registrazione: il consenso alle offerte non va più perso, e c'è un evento dopo l'account. Il widget mandava da sempre la casella newsletter, ma jc_registration_submit() non la salvava. Ora, creato l'account, parte Auth::doEvent("on_registration_done", $account, $dati) con ID_user, ID_anagraph, email e i consensi (newsletter, privacy), lingua, IP e browser: il progetto decide dove scriverli. Senza ascoltatori non cambia niente. (modules/auth/contents/registration/index.php, manuale 08 §5)
  • ?__nocache__ su una pagina mai messa in cache dava 500: delete() del filemanager su un file che non c'è ancora passava null ad array_diff_key(). (vendor/wolfgan/filemanager/services/fs_php.php)

Aggiunto 2 voci

  • bin/db-allinea-schema.php: porta un database già installato allo schema 4 (default espliciti, date nullable, date zero → NULL) leggendo le colonne reali, senza cambiare nessun tipo. Prova a vuoto di default, --vai per eseguire, --config <file> per un'altra config; idempotente. Se la connessione cade a metà (errori 2006, 2013) si ricollega e riprova; se non torna si ferma subito, e rilanciato riparte da dove era arrivato.
  • Sitemap multilingua. Con più lingue attive ogni pagina a file e la home compaiono una volta per lingua, con lo slug del manifest contents/i18n.php e <xhtml:link rel="alternate" hreflang>; gli indirizzi coincidono con i canonical. Con una lingua sola non cambia niente. (modules/cms-common/models/Sitemap.php, GUIDA_SITEMAP.md)

Sicurezza 1 voce

  • Accesso, registrazione, attivazione, recupero e logout: il ritorno solo verso un percorso del sito. ?redirect= e ?ret_url= arrivano dall'indirizzo della pagina e finivano senza controllo nella risposta e nei template: /login?redirect=https://altro.sito mandava fuori chi si era appena autenticato (open redirect), ?redirect=javascript:… eseguiva codice nella pagina di login, e ret_url entrava crudo in un onclick (XSS riflesso; in attivazione e recupero lo stesso con redirect). Nuovo Auth::redirectLocale(): passa solo un percorso che comincia con una barra (non //, non /\), senza spazi, caratteri di controllo, apici, < > o barre rovesciate; altrimenti il widget si comporta come senza parametro. Gli script di login e logout applicano la stessa regola nel browser. Chi rimandava dopo l'accesso a un indirizzo assoluto, anche del proprio dominio, deve passare il solo percorso. Più stretto di pm_safe_dest() (library/security, non ancora caricato) perché qui il valore finisce anche in attributi e stringhe JavaScript. (vendor/wolfgan/auth/Auth.php, vendor/wolfgan/auth/widgets/{login,registration,activation,recover}/index.php, widgets/login/script.js, widgets/logout/script.js, manuale 08 §5)

Schema 1 voce

  • 4: DEFAULT su ogni colonna NOT NULL, colonne data nullable con default NULL, date zero convertite in NULL. Su un sito esistente si applica con bin/db-allinea-schema.php, prima di caricare il codice 1.6.0 (vedi in testa alla sezione).

1.5.2

25 set 2026

Corretto 2 voci

  • bin/deploy.sh arriva sempre eseguibile. Se il checkout da cui si costruisce il pacchetto aveva perso il bit di esecuzione, il sito installato rispondeva permission denied a ./bin/deploy.sh. Ora build-zip.sh lo imposta a 0755 prima di comprimere e lo verifica nello ZIP; il manuale spiega come ripristinarlo su un sito già installato. (build-zip.sh, docs/manuale/14-ambienti-e-deploy.md)
  • Pagamenti: il driver Stripe non dipende più da costanti di GDay. Le date di Stripe si convertivano nel fuso GDAY_FUSO, una costante che esiste solo su quel progetto: altrove si ripiegava sul fuso di PHP senza dirlo. Ora passano da Payment::fuso(), che usa il fuso del sito (TIMEZONE), poi quello di PHP, e su un valore non valido ripiega su UTC senza eccezioni. Tolti anche i riferimenti a GDay dai commenti del driver. (library/payment/Payment.php, library/payment/services/stripe.php, manuale 10 §2)

1.5.1

25 set 2026

Aggiunto 1 voce

  • Pagamenti: un mozzo unico, i gateway come driver. library/payment/Payment.php dichiara cosa vuol dire incassare (aprire una sessione, rileggerne lo stato, rimborsare, verificare la firma di un webhook) senza sapere chi lo fa; il gateway è un driver in library/payment/services/<nome>.php, caricato dal mozzo (in autoload.php basta un caso). Primo driver: Stripe, one-shot e ricorrenti. Le chiavi si inseriscono dall'area Servizi (conf/gallery/services/payment.stripe/), e l'ambiente vero si accende solo con una chiave sk_live_ / rk_live_: chi dimentica di cambiare chiave non incassa soldi veri per sbaglio. Prodotti, crediti e ricevute restano nel modulo del sito. (manuale 10 §2)

Corretto 1 voce

  • Home in errore fatale per gli utenti autenticati (dalla 1.3.1). Con un sito multilingua, un utente loggato che apriva un URL senza prefisso di lingua (la home, per esempio) riceveva una pagina bianca: Undefined constant "FF_PHP_EXT". La risoluzione della lingua preferita gira in cmsKernel::run(), prima che il framework sia caricato, e per leggere la preferenza dal profilo ricalcolava l'elenco delle lingue con get_locale(), che a quel punto non può funzionare. Ora l'elenco già fornito dal kernel viene passato alla lettura e alla scrittura sul profilo e riusato dalle altre funzioni. Se il framework non è pronto, get_locale() non viene chiamata. Visitatori anonimi non coinvolti. (library/gallery/common/language_preference.php)

1.5.0

25 set 2026

Aggiunto 1 voce

  • Installer multilingua (italiano, inglese, spagnolo, francese). Il wizard si apre nella lingua del browser (inglese se non è una delle quattro) e ha un selettore di lingua in alto a destra. Sono tradotti tutti i testi: step, campi, suggerimenti, messaggi d'errore (database, SMTP, icone), l'email di prova, la pagina finale e quella di rimozione dell'installer. La lingua scelta diventa la lingua predefinita del sito, e resta modificabile nello step Lingue. Fuso orario e nazione proposti seguono la lingua. Dizionario in install/i18n.php; la scelta vive in sessione e nel cookie jc_install_lang. (manuale 14 §3)

Corretto 3 voci

  • Accesso con token: niente più errore fatale. La verifica del token interrogava un servizio esterno dell'installazione originale e usava le costanti PM_CLIENT_*, che su JoeCMS non sono definite: la richiesta si fermava con un errore fatale. Ora il token si verifica sul database del sito. Un token che non esiste viene rifiutato, e prima non succedeva: read() restituisce un array vuoto, che finiva nel ramo del successo. I token nuovi prendono una scadenza vera (adesso più la durata): prima veniva salvata la sola durata, cioè una data nel 1970. (vendor/wolfgan/auth/services/token.php)
  • Attivazione e recupero password senza callback configurato. I widget activation e recover chiamavano il callback del progetto senza controllare che esistesse: se il progetto non ne definiva uno, il passaggio finale falliva. Ora il callback è facoltativo, come già in login e registration. (vendor/wolfgan/auth/widgets/activation/index.php, vendor/wolfgan/auth/widgets/recover/index.php)
  • Anagrafica: niente TypeError su un risultato di lettura inatteso. Anagraph contava il risultato prima di verificare che fosse un array; con PHP 8 un risultato non-array dà TypeError. (vendor/hcore/anagraph/Anagraph.php)

1.4.2

23 set 2026

Corretto 2 voci

  • Email: le immagini inline e gli allegati diventano link. Certi relay (JoeSMTP, Aruba) rifiutano il messaggio intero se contiene una parte allegata — 550 … Attachments are not supported — e le immagini cid: sono parti allegate a tutti gli effetti: le email col logo non partivano. Mailer ora riscrive i cid: come URL assoluti e mette gli allegati in coda al corpo come elenco di link (gli upload passano da CM_SHOWFILES). Quando l'indirizzo non si ricava — file fuori dalla docroot, WWW_LINK_ABSOLUTE non definita — resta il comportamento di prima, così nessun progetto perde immagini o allegati per un percorso che non c'è. Si torna indietro con MAILER_EMBED_IMAGES e MAILER_EMBED_ATTACHMENTS a true nel config. (vendor/wolfgan/mailer/Mailer.php, manuale 06 §2)
  • Pagina di attivazione account: errore anche quando l'email partiva. Il fix della 1.4.0 leggeva l'esito di Notifier::send() così com'era, ma con un solo servizio di notifica configurato quel metodo torna true quando l'invio riesce: true finiva in $res["error"] e /attivazione rispondeva 500, con un errore senza testo, proprio nel caso buono — il codice era stato spedito. Ora l'esito passa da un punto solo (Auth::erroreInvio(), vendor/wolfgan/auth/Auth.php): è un errore solo se è una stringa non vuota, o la chiave error dell'array che torna quando i servizi sono più d'uno. Vale per il ramo email e per quello SMS.

Sicurezza 1 voce

  • Il codice di attivazione non torna più al browser. La richiesta d'invio del codice (il POST del widget activation) rimandava al client, dentro il JSON di risposta, anche il codice a 6 cifre appena spedito per email: bastava leggerlo negli strumenti per sviluppatori per attivare un account senza avere accesso alla casella. Il campo viene ora svuotato prima della risposta (vendor/wolfgan/auth/widgets/activation/index.php); il widget non lo usava — il codice lo prende dai campi che compila chi ha ricevuto l'email — quindi la pagina si comporta come prima. (manuale 08 §5)

1.4.1

23 set 2026

Corretto 1 voce

  • Pagina di attivazione account: il pulsante non rispondeva sui siti che rendono il widget nel proprio guscio pubblico invece che nel layout del CMS. Lo script del widget chiamava il loader del tema (showLoader), che lì non esiste: l'errore JS fermava tutto prima della chiamata al server, e in pagina non compariva niente. Ora il loader si usa se c'è (vendor/wolfgan/auth/widgets/activation/script.js). Nello stesso passaggio, un errore di rete o del server non lascia più la pagina a metà: il pulsante torna attivo e il messaggio d'errore compare.

1.4.0

23 set 2026

Aggiunto 1 voce

  • API pubblica: endpoint aggiuntivi senza toccare il core, e sotto-percorsi. La whitelist di api/1.0/index.php si allarga con la costante JC_API_ENDPOINTS (elenco separato da virgole) nel config dell'installazione; auth c'è sempre. Prima ogni progetto doveva modificare il front controller a mano, e il nome di un endpoint verticale finiva dentro il CMS. api/1.0/.htaccess instrada anche /api/1.0/<ep>/<risorsa>/… e passa il resto del percorso in _path: prima il percorso si fermava al primo segmento, e un endpoint con più risorse doveva mettere il "cosa" nel body, che per una GET non ha senso. Gli endpoint esistenti non cambiano.

Corretto 1 voce

  • Pagina di attivazione account: quando l'email con il codice non partiva, /attivazione rispondeva 500 con pagina bianca invece di dire cosa fosse andato storto. L'esito di Notifier::send() veniva letto come array, ma è una stringa quando l'invio fallisce (vendor/wolfgan/auth/Auth.php). Ora l'errore dell'invio compare in pagina — e resta visibile anche la causa vera, da risolvere lato SMTP.

1.3.2

21 set 2026

Corretto 2 voci

  • Installer, email di prova SMTP: con la porta 587 falliva sempre (e il sito installato non spediva posta) perché la cifratura era fissa su SSL. Ora si sceglie (SSL/TLS, STARTTLS, nessuna), la password non si perde dopo la prova e l'errore mostra la risposta del server (install/index.php, install/lib.php).
  • Installer, tasto Invio nello step Applicazione: premuto in un campo inviava l'email di prova invece di proseguire; ora equivale a "Continua".

1.3.1

21 set 2026

Aggiunto 5 voci

  • Deploy del ramo attivo in produzione: bin/deploy.sh (+ bin/deploy.conf.example, bin/.htaccess). Carica via SSH l'HEAD del ramo git su cui sei — mai i file non committati — e solo quelli cambiati dall'ultimo deploy, che il server ricorda in $HOME/.joecms-deploy-rev-<sito> (nella home dell'utente SSH, non nella docroot: non deve essere raggiungibile dal web; il suffisso col nome del sito serve quando sullo stesso server, con lo stesso utente, stanno più installazioni). Sostituisce l'upload a file singoli, che lascia in produzione un misto di versioni non riproducibile in locale.
    • controlla fa la diagnostica del server: utente, docroot trovata da sola, binari PHP con mysqli/mbstring, permessi di cache/ e uploads/, commit registrato.
    • Senza --vai è una prova a vuoto che non tocca il server. Poi --completo, --rimuovi, --svuota-cache, --da <sha>, --solo <path>, --forza, --niente-smoke.
    • Non parte se si entra come root senza DEPLOY_CHOWN: i file resterebbero di root e con suexec o suPHP il sito risponderebbe 500 su tutto.
    • Non carica mai config.remote.php/config.local.php, il .htaccess di radice (in produzione è quello scritto dall'installer col dominio vero), install/ (già rimosso da install/cleanup.php a fine installazione), database.sql, cache/ e il materiale di lavoro. Quando una di queste cose cambia lo dice nel riepilogo — migration di docs/sql/ da applicare prima del codice, define() nuove nel config.remote.php.dist, .htaccess modificato — invece di caricarla di nascosto.
    • Smoke test HTTP di fine deploy dal computer di chi deploya, con un percorso per lingua su un sito multilingua: è il controllo che scopre la lingua rimasta indietro. Se il progetto ha tests/run.php con tests/smoke.config.php, usa quella suite.
    • La configurazione sta in bin/deploy.conf, fuori da git perché è per-installazione.
    • Più ambienti per sito (produzione, staging): --ambiente <nome> legge bin/deploy.<nome>.conf invece di bin/deploy.conf, e si ferma se il file non c'è invece di ripiegare sull'ambiente di difetto. bin/.htaccess (Require all denied) tiene la cartella fuori dal web.
  • Lingua preferita dell'utente, per le pagine e per le comunicazioni. library/gallery/common/language_preference.php risolve la lingua di ogni richiesta pubblica e ricorda la scelta nel cookie e, per chi è autenticato, sul profilo (access_users.locale/ID_lang, anagraph.ID_lang). Ordine: ?lang= esplicito → prefisso URL → profilo → cookie → Accept-Language (solo sulla radice, alla prima visita) → default. Il kernel lo chiama dopo Auth::check(), quindi vale anche per le pagine non cacheabili; cache_check_lang() ora rimanda lì.
    • Il selettore lingua linka sempre con ?lang=: è l'unico segnale che aggiorna anche il profilo. Aprire un link /en/… cambia solo il cookie.
    • Email e notifiche escono nella lingua del destinatario, anche da cron e job asincroni: process_mail() la ricava dall'indirizzo, se il chiamante non passa una "lang"; Notifier fa un invio per lingua; nuovo Mailer::setLang().
    • Helper per il codice di progetto: language_pref_for_user(), language_pref_for_email().
  • SMS via JoeSMTP (servizio sms.joesmtp, driver vendor/hcore/notifier/services/sms_joesmtp.php): gli SMS del Notifier possono partire dall'API transazionale di JoeSMTP (/api/1.0/sms-send, client credentials del progetto). Se sono configurati sia JoeSMTP sia Twilio, parte JoeSMTP. Configurabile anche dal wizard, step Servizi.
  • Secondo fattore al login (2FA) via email o SMS, acceso con AUTH_2FA in config.remote.php (l'installer la scrive vuota = spento). Il widget di login chiede il codice da solo. Vedi manuale 08 §5bis.
  • Push per utente: il browser collega l'iscrizione OneSignal all'utente loggato (OneSignal.login, ID letto da /OneSignalIdentity, mai scritto nell'HTML in cache) e il server la raggiunge per ID utente. Nuovo campo api_key nel servizio notification.onesignal.

Corretto 15 voci

  • Fatal error su ogni URL che contiene la parola source o destination (es. /esperto-risponde/sources/nginx.conf, tipico delle scansioni automatiche). Il kernel fondeva la rotta dichiarata da $schema["page"][...]["router"] nella propria tabella con array_replace(): le chiavi source e destination diventavano due rotte, ovvero due regexp letterali non ancorate che matchavano quegli URL e mandavano Cms::execute() a fare require() della regexp stessa. Ora mergePageRouter() (vendor/wolfgan/cms/services/kernel.php) fonde solo la forma a mappa regexp => destinazione; la forma {source, destination} resta il dato con cui il kernel riconosce la pagina (manuale 01 §2).
  • 500 su /INSTALL.md (Sentry urbanrunners): la rotta dell'installer (^/install(.*) → /conf/gallery/install/$1), che per i gruppi service/updater viene eseguita da library/gallery/system/init.php, arrivava al require() con il $1 non sostituito. E siccome il match delle rotte del kernel è case-insensitive, ci finiva anche un URL di documentazione provato da un crawler. Ora risponde 404.
  • Come rete di sicurezza sullo stesso percorso: Cms::execute() risponde 404 — invece di morire di fatal error — se la destinazione non è un file esistente dentro la document root, e cmsRouter::run() sostituisce i gruppi della regola anche nelle destinazioni "a file", rifiutando quelle in cui resta un $1 non risolto o in cui il gruppo catturato contiene .., un byte nullo o uno schema di protocollo.
  • Richiesta bloccata fino al max_execution_time su URL con un percorso relativo (es. /srv/request.tar, che al kernel arriva come .tar). In get_page_properties() (vendor/wolfgan/cms/services/kernel.php) la risalita di cartella usciva solo arrivando a /: su un percorso senza barra iniziale dirname() torna . all'infinito e il ciclo non finiva mai, tenendo occupato un processo PHP per 200 secondi — con abbastanza richieste così, il sito si pianta da solo. Ora si esce anche quando dirname() smette di accorciare il percorso.
  • Call to undefined function check_function() nelle aree riservate con un percorso proprio (/gestione/… e simili, che non stanno nell'elenco dei prefissi saltati dal resolver di lingua). language_pref_langs() (library/gallery/common/language_preference.php) usava check_function(), che è definita in library/gallery/common.php: il kernel chiama il resolver subito dopo Auth::check(), quando quel file non è ancora caricato. Ora passa da language_pref_has_locale(), che carica get_locale() da sé quando l'autoload del CMS non c'è ancora (manuale 12 §6).
  • Home bianca su host non previsto: set_header_page() leggeva WWW_LINK come costante nuda per comporre il title tag. Se hook.php non la definiva — le installazioni vecchie la definivano solo dentro una switch ($_SERVER["HTTP_HOST"]), quindi mai su un host con www., con porta o passato da un proxy — su PHP 8 era un Error fatale e il sito rispondeva una pagina bianca. Ora il confronto passa da set_header_page_is_canonical_host(), tollerante su www. e porta, e senza costante assume il dominio canonico. Le costanti di hook.php erano già definite in ogni condizione da questa versione: il fix protegge le installazioni con un hook.php più vecchio del codice (manuale 14 §3).
  • La registrazione salvava sempre italiano come lingua in anagraph (ID_lang = 1), anche per chi si registrava da /en/. La migration docs/sql/2026-09_lingua-profili-allineamento.sql ripara i profili esistenti. Tocca solo dati: non va in database.sql e lo schema resta alla 3.
  • Il controllo "manuale da aggiornare" (.githooks/manuale-check.sh) aveva tre punti ciechi, emersi proprio con il lavoro sulla lingua: ignorava un percorso citato con il numero di riga, scartava le migration di docs/sql/ prima di mandarle al capitolo 07, e segnalava otto capitoli a ogni modifica di hook.php. Ora tollera :riga, instrada le migration e per hook.php segnala solo i capitoli che nominano una funzione toccata. Nuova modalità --commit <sha> per verificare un commit già fatto.
  • Il pre-commit del manuale ora blocca una volta invece di avvisare: Sourcetree mostra l'output di un hook solo quando fallisce, quindi l'avviso non lo vedeva nessuno. Se il manuale non va toccato, basta ripetere lo stesso commit. MANUALE_WARN_ONLY=1 riporta al solo avviso; MANUALE_STRICT non esiste più.
  • ffDb_Sql in ff/classes: mysqli_report(MYSQLI_REPORT_OFF) in connect(), come già nella copia in vendor/phpformsframework/ffDb_Sql. Da PHP 8.1 mysqli lancia mysqli_sql_exception invece di restituire false, e il driver (che fa @mysqli_*() e poi controlla errno) non la intercettava. Nelle pagine si carica sempre la copia in vendor, ma questa la carica per percorso diretto l'installer (conf/gallery/install/common.php): su PHP 8.1+ il wizard finiva in un errore fatale al primo errore SQL invece di mostrare il messaggio.
  • Push web: servizio notification.onesignal portato al Web SDK v16. Caricava lo stub v15 da un file inesistente (/themes/site/javascript/OneSignalSDK.min.js), quindi il push web era spento su ogni sito. Ora usa OneSignalSDK.page.js v16 dal CDN; il worker di radice /OneSignalSDKWorker.js (e il vecchio /OneSignalSDKUpdaterWorker.js, per chi si era iscritto con la v15) importa OneSignalSDK.sw.js v16. Prompt e campanella si configurano dalla dashboard OneSignal; la lingua della pagina passa a OneSignal per gli invii multilingua. Senza App ID il servizio non inietta nulla. Tolti gcm_sender_id dal manifest e i percorsi esclusi di un vecchio sito.
  • Push e SMS del Notifier non funzionavano, mai usati finora. Il driver OneSignal andava in errore fatale al primo invio, quello Twilio non faceva nessuna chiamata, e send() con un messaggio stringa andava in TypeError su PHP 8. Riscritti: OneSignal sulla REST attuale (api.onesignal.com, Authorization: Key), Twilio sulla REST senza SDK, certificato sempre verificato, esito nel risultato di send() e fallimenti nel log notifier_error.
  • 2FA del login inefficace: la sessione veniva aperta prima di spedire il codice, che non veniva mai verificato, ed era lo stesso per tutti gli utenti nello stesso minuto. Ora il codice si chiede prima di sessione o token, è per utente e ha limiti di reinvio e di tentativi.
  • Notifier: sendMail() passava gli argomenti nell'ordine sbagliato (le azioni finivano nel titolo); getStorage() chiamava setConfig() con un argomento (ArgumentCountError su PHP 8, notifiche in-app comprese); un telefono senza + veniva preso per un ID utente (Notifier::normalizeTel()).
  • Wizard: Twilio chiedeva solo SID e token, ma senza mittente non invia; ora chiede anche from.

Rimosso 3 voci

  • Copie morte di Notifier, Mailer e Storage in library/classes/ e library/gallery/classes/: il CMS carica solo quelle in vendor/. In autoload.php, il blocco che puntava a library/gallery/models/<classe>, cartella inesistente.
  • Script di prova pubblico /api/notifier (conf/gallery/api/notifier/).
  • sendSMSTwilio() e le costanti vuote MOD_SHARE_TWILIO_* in hook.php, mai usate: gli SMS passano dal Notifier con le credenziali dell'area Servizi.

Sicurezza 2 voci

  • Tolti i connettori lato server di tre librerie vulnerabili (portato da GDay nel commit b50933a5, che per errore ha il messaggio del modello dati di quel sito):
    • themes/library/ckfinder/: il connettore PHP (core/connector/php/, ckfinder.php, config.php, plugin). Restano i file JavaScript: i widget ckfinder e ckuploadify di ffField (temi default e restricted) non hanno più un backend e il caricamento file che ci passa sopra non funziona. Chi li usa deve passare a kcfinder/kcuploadify o all'upload del CMS;
    • themes/library/tiny_mce/plugins/filemanager/: il file manager MoxieCode, con autenticatori d'esempio per Joomla, Mambo, PHPNuke, WordPress e un auth_example.php raggiungibili dal web;
    • themes/library/highcharts/exporting-server/: il server di esportazione dei grafici.
  • library/security/bootstrap.php (nuovo): helper per l'input non fidato riflesso in output — pm_safe_dest() (open redirect), pm_js_value()/pm_js_attr() (XSS in JavaScript), pm_html(), pm_safe_token(). Non è ancora caricato da nessuno: l'aggancio in hook.php e i punti che lo usano arrivano con l'intervento successivo. ⚠️ Prima di caricarlo va resa configurabile la lista dei domini ammessi di pm_redirect_allowed_domains(), che oggi contiene quelli di paginemediche: un redirect assoluto verso il dominio del sito verrebbe scartato (i percorsi relativi passano).

Documentazione 3 voci

  • Manuale allineato al lavoro su notifiche, SMS e 2FA: 06 riscritto nelle sezioni 1, 3 e 4 (driver del Notifier, servizi e campi, OneSignal v16, JoeSMTP), 08 §5bis (secondo fattore), 10 e la mappa delle capacità.
  • Manuale allineato al lavoro sulla lingua: 12 §Multilingua (resolver e ordine di risoluzione), 06 §2 (lingua del destinatario), 07 (colonne di preferenza, migration solo-dati), 01, 08, indice. 14: regole della mappa e limiti del controllo.
  • Manuale 14 §4 riscritto: la sezione "deploy senza ZIP" descriveva la procedura manuale (elencare i path e farli caricare a mano), ora documenta bin/deploy.sh — configurazione, opzioni, cosa non viaggia e perché, cache, smoke test, cosa resta a mano. Checklist di messa in linea aggiornata di conseguenza.

1.3.0

18 set 2026

Aggiunto 2 voci

  • Il manuale (docs/manuale/) viaggia nello ZIP (build-zip.sh), come istantanea della versione: ogni capitolo porta in testa versione e data del pacchetto, docs/manuale/VERSIONE.txt dichiara da quale build arriva, i file sono in sola lettura. Sul sito installato resta il manuale della versione installata anche quando il CMS va avanti; l'aggiornamento successivo porta il suo. Un docs/.htaccess (Require all denied) lo tiene fuori dal web: descrive l'interno della piattaforma e si consulta dallo ZIP o via FTP/pannello.
  • Controllo automatico "manuale da aggiornare", solo nel repository principale (.githooks/manuale-check.sh). Confronta i file modificati con i percorsi che ogni capitolo cita e segnala i capitoli toccati ma non aggiornati: la mappa file → capitolo si ricava dal manuale stesso, senza elenchi da mantenere. Scatta a fine turno di Claude Code (hook Stop in .claude/settings.json, che fa aggiornare il capitolo prima di chiudere) e al commit (hook git pre-commit, attivo con git config core.hooksPath .githooks; avvisa senza bloccare, salvo MANUALE_STRICT=1). .githooks/ e .claude/ non entrano nel pacchetto.

Documentazione 1 voce

  • docs/manuale/14-ambienti-e-deploy.md §5: il manuale nel pacchetto, l'istantanea immutabile, il controllo di aggiornamento; checklist di messa in linea con la voce sul manuale.

1.2.2

18 set 2026

Sicurezza 1 voce

  • Esecuzione di codice PHP arbitrario dai parametri di ricerca per luogo (ffl, pci, pcn, ppi, ppn, pps, pri, prn, psi, psn, pss). vgCommon::getRequest() scriveva il valore in arrivo dalla request dentro un eval() — ?ffl=<codice php> su una qualsiasi pagina pubblica primaria eseguiva quel codice, senza autenticazione (i parametri sono attivati dal kernel su ogni pagina primaria non riservata). Ora il percorso di destinazione (["filter"]["place"]["city"]["ID"]) viene risolto per chiavi con preg_match_all e l'assegnazione avviene per riferimento: il valore non viene mai interpretato come codice, e sono accettati solo valori scalari. Effetto collaterale: la ricerca per luogo con valori testuali (?pcn=roma) torna a funzionare — sotto PHP 8 l'eval falliva con Error: Undefined constant "roma".

Corretto 2 voci

  • 500 su URL malformati costruiti dai bot (TypeError: urlencode(): Argument #1 ($string) must be of type string, array given, vendor/wolfgan/vgCommon.php). Quando uno scanner inviava un parametro con valore array e nome "sporco" (es. ?<?php $env[...]=...), la costruzione della query dei parametri scartati chiamava urlencode() su un array: sotto PHP 8 è un fatal, quindi la pagina rispondeva 500 e l'errore finiva su Sentry. Ora i valori array vengono serializzati con http_build_query().
  • Sito bianco (500) subito dopo l'installazione, con Error: Undefined constant "DOMAIN_PROD". Le costanti di dominio venivano definite solo se l'host della richiesta coincideva esattamente col dominio scritto nel wizard: bastava il www. di differenza perché ogni pagina pubblica andasse in errore fatale. Ora hook.php riconosce il dominio ignorando www. e porta, e definisce comunque DOMAIN_PROD, WWW_LINK, WWW_LINK_ABSOLUTE e LOCAL_DOMAIN; la regola che mette noindex fuori produzione (library/gallery/common/set_header_page.php) non legge più costanti nude. Di riflesso, un sito di staging servito su un host diverso da quello dichiarato ora viene davvero marcato noindex,follow.

Modificato 1 voce

  • Il pacchetto non contiene più script shell: build-zip.sh (strumento di build, inutile sul server perché lavora su git ls-files) e i .sh residui dentro vendor/, library/ e themes/library/ vengono esclusi dallo ZIP. Un .sh eseguibile in document root era solo superficie d'attacco in più. La build lo segnala nella verifica finale ("script shell nel pacchetto").

Documentazione 1 voce

  • Nuovo manuale della piattaforma in docs/manuale/ (15 documenti): cosa il sistema permette e come si fa, capitolo per capitolo — ciclo di una richiesta e routing, pagine/template/applet, servizi HTTP e webhook, API interna e pubblica, cron/job/worker, email-notifiche-SMS-push, dati e modello dei contenuti, auth e permessi, backend e sezioni ffGrid/ffRecord, moduli e servizi di terze parti, media e file, cache, osservabilità e CLI, ambienti e deploy. L'indice (docs/manuale/00-INDICE.md) contiene una mappa delle capacità con lo stato di ciascuna (in esercizio / da configurare / impalcatura upstream) e l'elenco delle regole che non si negoziano. Copre sottosistemi finora non documentati nel repo: bus dei servizi /srv/request, classe Jobs (coda e chiamate asincrone), Notifier (notifiche, push OneSignal, SMS Twilio), Storage multi-driver, showfiles e i modi immagine, $schema["request"] come whitelist dei parametri, risalita del router al posto del 404. Parte del contenuto è stata recuperata dai progetti gemelli sullo stesso stack (JoeSING, JoeQUIZ, JoeSMTP), dove meccanismi generali del CMS erano documentati solo nel progetto che li aveva usati per primo.

1.2.1

16 set 2026

Corretto 1 voce

  • Ogni pagina rispondeva 500 su installazione nuova: Error: Undefined constant "FF_PHP_EXT" (index.php, library/gallery/common/content_i18n.php). Il caricamento del manifest degli slug localizzati usava FF_PHP_EXT, costante definita da ff/main.php — che a quel punto non è ancora caricato, perché il framework entra più avanti da cm/main.php. In sviluppo il difetto restava invisibile: il server PHP interno passa da router.php, che carica ff/main.php prima di index.php. Sotto Apache/PHP-FPM, invece, index.php è il primo file eseguito e in PHP 8 una costante non definita è un errore fatale. Ora il bootstrap usa __DIR__ e l'estensione scritta per esteso, senza dipendere da costanti del framework.

1.2.0

16 set 2026

Aggiunto 7 voci

  • Icona del sito chiesta in installazione, e tutti i formati generati da quell'unica immagine (install/icons.php, nuovo; step Aspetto del wizard). Finora chi installava JoeCMS si teneva la favicon di JoeCMS finché non sostituiva a mano una mezza dozzina di file, ognuno con la sua dimensione e il suo nome. Ora si carica un'immagine quadrata (PNG, JPEG, GIF, WebP, o SVG se il server ha Imagick) e l'installer scrive: favicon.ico — vero ICO multi-dimensione 16/32/48, scritto in PHP senza dipendenze — favicon.png, favicon-16x16.png, favicon-32x32.png, apple-touch-icon.png (180×180 su fondo pieno, perché iOS rende nera la trasparenza), il set PWA iconpreview-NN-NN.png da 36 a 512 px in /media-resource/, l'icona maskable per Android, i riquadri Windows mstile-*.png e l'originale in uploads/loghi/icona-sito.png per rigenerare in seguito. La favicon.svg viene riscritta incapsulando il nuovo PNG: altrimenti vincerebbe lei, che i browser preferiscono il vettoriale.
  • manifest.json e browserconfig.xml creati durante l'installazione, compilati coi dati già raccolti dal wizard: nome e nome breve dell'app, descrizione, lingua predefinita, start_url/scope che tengono conto del site path, colori e l'elenco delle sole icone davvero presenti su disco. Non serve caricarli: un sito appena installato è già installabile come app e mostra il riquadro giusto su Windows. Se non si carica nessuna immagine il set viene comunque generato dall'icona JoeCMS del pacchetto, così il manifest non punta mai a file inesistenti (era il caso del vecchio site.webmanifest, che citava un /icon-192.png mai esistito). Il tema linka manifest.json quando c'è, e aggiunge i meta theme-color, msapplication-config e msapplication-TileColor.
  • Colore tema e colore di sfondo dell'app scelti nello step Aspetto, con i campi che si possono lasciare vuoti: in quel caso il colore tema viene ricavato dall'immagine (colore dominante, scartando trasparenze, bianchi e neri). Finiscono in manifest.json, in browserconfig.xml e nelle costanti JC_THEME_COLOR/JC_BG_COLOR di config.remote.php.
  • Pagine di errore 404 e 500 di marca (cm/errori.php, cm/extras/404.html, cm/extras/500.html). Prima il CMS rispondeva male tutte e due le volte che conta: il 404 del kernel era un <h1> senza pagina intorno, quello di Apache (ErrorDocument → cm/error.php) usciva con corpo vuoto, e un errore fatale — con display_errors a 0, come dev'essere in produzione — dava pagina bianca. Ora le tre porte convergono su una funzione sola, cms_error_document(), e le pagine sono card JoeCMS con CSS in linea: nessuna dipendenza di rete, perché una pagina di errore deve comparire anche quando il resto non risponde. Un sito che parte da JoeCMS le ha subito, e le sostituisce mettendo le proprie in conf/cm/extras/ (quel percorso vince sempre su cm/extras/).
  • Gli errori fatali e le eccezioni non catturate diventano una 500 leggibile (cms_error_handler_register(), agganciata in index.php subito dopo CMS_START). La pagina non mostra mai messaggio, file o riga: mostra un riferimento di dieci caratteri che finisce anche in error_log accanto all'errore vero e alla URL, così una segnalazione si ritrova con un grep. Se l'output era bufferizzato viene buttato (niente pagina troncata); se era già stato inviato non si stampa nulla. Le richieste sotto /srv/, /rt/, /api/ e le XHR ricevono JSON, non HTML. Con __debug__ o display_errors acceso l'impianto si fa da parte: in sviluppo l'errore va letto. Registrato prima di Sentry di proposito: così Sentry incapsula i nostri handler invece di sostituirli, e lo shutdown handler non chiama exit per non impedire l'invio dell'evento.
  • Questo changelog, ricostruito da git e dalle sessioni di lavoro, e distribuito dentro il pacchetto: CHANGELOG.md è l'unico markdown che sopravvive alle esclusioni di build-zip.sh, così chi installa vede cosa cambia tra una versione e l'altra.
  • build-zip.sh avvisa se manca la sezione della versione in build e verifica a fine build che il changelog sia finito nello zip.

Corretto 7 voci

  • Cookie di sessione: doppio cookie omonimo, login impossibile (vendor/wolfgan/auth/services/session.php). session_start() veniva chiamato prima di impostare i parametri del cookie, quindi PHP emetteva un cookie host-only e senza flag; subito dopo l'applicazione ne emetteva un secondo, con lo stesso nome ma Domain=.dominio. Il browser li conservava entrambi e li inviava insieme: in $_COOKIE ne sopravviveva uno solo, spesso quello sbagliato, e la sessione risultava sempre invalida — l'unico rimedio era cancellare i cookie a mano. Ora i parametri si impostano una volta sola prima di aprire la sessione, e il cookie emesso è uno.
  • Il logout non cancellava i cookie: cookie_destroy() usava lifetime (0) come scadenza, cioè scriveva un cookie di sessione invece di cancellarlo, e provava solo il dominio HTTP_HOST, che non tocca i cookie host-only. Ora la scadenza è nel passato e si cancellano entrambe le forme.
  • secure non è più cablato a true: si deduce dalla connessione (MOD_AUTH_COOKIE_SECURE per forzarlo). In HTTP il cookie veniva scartato dal browser e in sviluppo il login non reggeva.
  • SameSite passa da None a Lax (MOD_AUTH_COOKIE_SAMESITE per tornare a None, che resta necessario solo se il sito viene incorporato in un iframe di terze parti). None esponeva il cookie di sessione a ogni richiesta cross-site.
  • Niente attributo Domain su localhost e sugli indirizzi IP: i browser scartano il cookie e la sessione non reggeva in sviluppo.
  • session_regenerate_id(true) veniva invocata dopo session_destroy(), senza sessione attiva: non rigenerava nulla. Ora sta dopo session_start().
  • build-zip.sh: l'esclusione dei markdown era case-sensitive e lasciava passare i .MD dei vendor (es. library/algoliasearch-client/DOCKER_README.MD).

Modificato 1 voce

  • SESSION_NAME è derivato dal dominio, non più fisso: PHPSESS_[terzo][secondo][AAAAMM], con il terzo livello omesso quando è www (quiz.esempio.com → PHPSESS_quizesempio202609). Serve perché due installazioni sotto lo stesso dominio padre condividono i cookie: con lo stesso nome le sessioni si scavalcano. Anno e mese sono quelli dell'installazione e restano congelati nella costante — ricalcolarli a ogni richiesta scollegherebbe tutti a ogni cambio di mese. Nuova funzione jc_session_name() in install/lib.php; il vecchio installer usa installer_session_name() in conf/gallery/install/common.php.

1.1.0

29 ago 2026 Schema DB → 3

Aggiunto 5 voci

  • build-zip.sh — build del pacchetto d'installazione (joecms-<versione>.zip, ~77 MB). Impacchetta i file tracciati da git nello stato del working tree, esclude i config d'ambiente (restano i .dist), l'.htaccess di sviluppo, i *.md di root, i source map e le directory di test/doc/example dei vendor; svuota cache/ e di uploads/ tiene solo loghi. Verifica da sé che non finiscano segreti nel pacchetto e che seed e installer siano presenti.
  • Sitemap — generatore proprio (modules/cms-common/models/Sitemap.php, conf/gallery/sitemap/, configurazione per sito in themes/site/conf/sitemap.php). Documentata in GUIDA_SITEMAP.md.
  • Strumenti di amministrazione come servizio (conf/gallery/services/admin.tools/): barra di amministrazione e guide di allineamento diventano due interruttori in /restricted/services/admin.tools, spenti di default e per dominio.
  • Guida al CMS generata dall'installer (install/guide.php), prodotta in tutte le lingue attive dell'installazione.
  • Documentazione: PANORAMICA_JOECMS.md (com'è fatto e cosa resta aperto), IGIENE_SEGRETI.md, GUIDA_SITEMAP.md.

Modificato 4 voci

  • Igiene dei segreti: i config d'ambiente (config.local.php, config.remote*.php) sono stati sfilati dal repository; in git resta solo config.remote.php.dist. L'installer rigenera il config reale al primo avvio, con chmod 0640.
  • robots.txt generato: esclusi anche /search/, /area-utente/, /srv/; confermata la regola per i crawler AI (indicizzazione sì, addestramento no).
  • Contenuti multilingua (content_i18n.php, process/language.php), toolbar admin lato JS, frame di amministrazione, tipografia del tema site.
  • Patch di compatibilità sui vendor: google-api-php-client, wolfgan/* (Auth, Storage, Filemanager, vgCommon), ffDb_Sql_mysqli, ffDb_MongoDB.

Schema 1 voce

  • JC_SCHEMA_VERSION 2 → 3 (modifiche a database.sql).

1.0.6

29 lug 2026

Modificato 4 voci

  • VGallery Next: editor dei nodi riscritto e alleggerito (conf/gallery/manage/vgallery-next/), contratto del form (FormContract) esteso; la scrittura continua a passare per il percorso originale via $_REQUEST.
  • Tema vgnext: theme_settings.xml e foglio di stile dei form (vgnext-form.css) dedicati.
  • Motore lingue (process/language.php) e cache di sistema (system/cache.php) rivisti; aggancio in system/init.php.
  • Header del sito e passi dell'installer (install/index.php, view.php).

1.0.5

28 lug 2026

Aggiunto 2 voci

  • Guida interna al CMS prodotta a fine installazione.
  • Settaggi specifici per dominio: le opzioni non sono più globali ma legate al dominio servito.

1.0.3

27 lug 2026

Aggiunto 7 voci

  • Gestione utenti e gruppi in /restricted/users e /restricted/groups (prima erano pagine vuote): liste e form di modifica su access_users / anagrafica.
  • VGallery Next — nuova area admin per i nodi (conf/gallery/manage/vgallery-next/) con repository, layout ed editor propri; piano in VGALLERY_NEXT_PIANO.md.
  • Barra di amministrazione sul front-end e guide di allineamento.
  • Registrazione migrata a widget (modules/auth/contents/registration/), con l'account gestito dal backend; il vecchio contents/registrazione/ è stato rimosso e le pagine rinominate in registration.
  • Gestione lingue nel wizard e nel backend; pagine di autenticazione tradotte e redirect di lingua via cookie.
  • Seed del database e conf/gallery/config.php allineato.
  • Integrazione Sentry (bootstrap + selftest).

Corretto 4 voci

  • [LANGUAGE_SWITCHER] stampato letterale sulle pagine front-end (es. /login).
  • TRACE_VISITOR non definito → fatal a runtime durante il wizard.
  • /restricted/{tags,place,resources}: errore 500 sulla tabella utenti.
  • Tab non funzionanti nei popup del backend e dialog invisibile sul campo actex (Struttura).

1.0.0

26 lug 2026

Aggiunto 8 voci

  • Installer automatico stile WordPress (install/): wizard, generazione del config, install.lock, auto-disabilitazione, install/cleanup.php che cancella /install a fine installazione. Piano in INSTALLER_PIANO.md.
  • Versionamento: JC_VERSION e JC_SCHEMA_VERSION, scritte nel config generato.
  • Branding JoeCMS: identità, logo, palette.
  • Servizio API di autenticazione (api/1.0): client credentials → Bearer token, con gli helper joecms_api_* in hook.php.
  • Autenticazione completa lato sito: registrazione, login, recupero password, attivazione.
  • Multilingua, banner cookie, nuovi header e footer, nuova homepage, nuovi servizi.
  • Previewer delle email e invio con logo inline (cid:, mai URL).
  • Indicizzazione AI: llms.txt, versione Markdown dei contenuti, regole robots per i bot AI (GUIDA_INDICIZZAZIONE_AI.md).

Rimosso 1 voce

  • Tutto il residuo del progetto legacy da cui nasce il codice: oltre un centinaio di conf/packages/*.xml (applet e configurazioni di medici-online / liveinhealth), servizi non più usati, riferimenti a domini e percorsi del vecchio ambiente, password in chiaro nei sorgenti.

Pre-1.0

2026-04-29 → 2026-07-20 · migrazione PHP 7 → PHP 8
Fine della storia. Tutto è cominciato da qui.