Ogni versione, messa agli atti.

Claude sa quali permessi ha il token di un sito.

• ModificatoInclude il server MCP 1.3.1: sui siti con il plugin 1.7.0, wp_health_check riporta anche gli scope del token usato da quel sito, così il primo controllo dopo aver incollato le istruzioni per l’AI risponde anche a questa domanda.

Il controllo di salute conosce gli scope del token.

• Modificatowp_health_check invia il token della connessione, così un sito con il plugin 1.7.0 o successivo restituisce anche i suoi scopes. I siti più vecchi lo ignorano, e un token non valido riceve comunque la risposta pubblica. Se un sito non riporta gli scope, la risposta lo dice.

Incluso in Xaflo Desktop 2.0.2. Lo zip del plugin 1.7.0 contiene ancora la 1.3.0.

Claude si collega al primo colpo, senza installare altro.

• CorrettoXaflo ora contiene il server MCP per Claude (1.3.0) e lo avvia con un suo Node integrato. Prima Claude doveva eseguire un comando claude-wp-mcp che esisteva solo se Node.js e il pacchetto erano stati installati a parte, quindi su un computer nuovo la connessione si chiudeva subito.
• CorrettoAll’avvio le connessioni esistenti vengono riparate: un sito la cui voce in Claude punta a un comando che il computer non ha, o a una vecchia cartella di Xaflo, passa al server integrato. Si conserva una copia della configurazione di Claude; le voci che funzionano e gli altri server MCP non vengono toccati.
• ModificatoGli snippet per Claude Code, Claude Desktop e ChatGPT usano lo stesso server integrato, con il token solo nelle variabili d’ambiente.

Un nuovo Xaflo Desktop, fatto per il plugin 1.7.0.

• ModificatoNuovo aspetto e struttura più semplice: cinque voci nella barra laterale (Siti, Remoto, Libreria, Licenza, Impostazioni), un selettore del sito in cima, scorciatoie da tastiera (Ctrl+1–5, Ctrl+N, Ctrl+K), e tutto in italiano e in inglese.
• SicurezzaTi chiede sempre conferma prima che un sito cambi qualcosa che la richiede (sovrascrittura, rinomina, eliminazione, caricamento, deploy sopra un plugin esistente): Desktop mostra cosa cambierà, con il riepilogo del sito, e conferma solo quando fai clic. Desktop 1.x ne confermava alcune da solo.
• ModificatoErrori in parole semplici: un rifiuto dice perché (permesso mancante, account non amministratore, IP non consentito, file fuori da uploads, file protetto) e cosa fare.
• ModificatoRemoto ha cinque schede: Plugin, File, Deploy, Manutenzione e Console. Libreria raccoglie prompt e tool in un unico posto con ricerca. Licenza mostra chiaramente se sei su Lite o Pro, in scadenza o scaduto. Le azioni in blocco sono passate in Siti.
• AggiuntoIl Deploy torna a funzionare: lo zip viene inviato al sito stesso (plugin 1.7.0), controllato con il suo checksum, e l’installazione sopra un plugin esistente si conferma una volta per tutti i siti.
• AggiuntoApri wp-admin già collegato, dalla scheda di un sito (serve un token con admin:login sul plugin 1.7.0). Il link monouso si apre nel browser e non viene mai mostrato né salvato.
• AggiuntoIstruzioni per l’AI: un riepilogo del sito pronto da incollare in Claude o ChatGPT, senza alcun token. Un banner di aggiornamento con avanzamento e note di rilascio, e un controllo manuale degli aggiornamenti in Informazioni.
• CorrettoLa versione del plugin torna visibile per ogni sito; eliminare una cartella in File la rimuove con tutto il contenuto dopo una sola conferma; i plugin mostrano un badge quando WordPress conosce una versione più recente.
• SicurezzaElectron da 33 a 45, con la pagina in sandbox. La chiave di licenza salvata non esce più dal processo principale dell’app.

Desktop 2.0 è la versione per Windows. Quella per Linux è ancora la 1.1.1.

84 tool, e conferme che può dare solo una persona.

• SicurezzaIl server non risponde mai alle conferme. Quando un sito chiede conferma (HTTP 428), il tool restituisce cosa cambierebbe e il token di conferma, e non cambia nulla; va avanti solo una seconda chiamata con il token, dopo che l’utente ha detto sì. wp_fs_delete perde l’opzione che rimandava il token da sola.
• ModificatoI tool dei file seguono le regole della 1.7.0 (site:write cambia solo uploads, altrove serve fs:admin, i file protetti non cambiano mai). wp_fs_write, wp_fs_rename, wp_fs_upload e wp_fs_delete accettano confirmation_token; le sovrascritture restituiscono l’id di un backup.
• ModificatoI rifiuti mostrano il codice e il messaggio del plugin, con il passo successivo, invece di un semplice “HTTP 403”. wp_cli_exec accetta un comando identico a una voce della lista consentita, con i valori in args.
• Aggiuntowp_install_plugin_zip con zip_path installa uno .zip locale (al massimo 20 MB, inviato con il suo SHA-256); sostituire un plugin installato chiede conferma. wp_set_settings accetta confirmation_token; wp_list_pages e wp_create_page accettano language.
• ModificatoNon esposto di proposito: il link monouso per entrare in wp-admin, che è una credenziale per una persona, non per un modello. Rimosso: create_if_missing da wp_write_theme_file.

Incluso nel plugin 1.7.0, al posto della 1.0.0-rc15.

Una versione di sicurezza con modifiche incompatibili. Ruota la chiave e rilascia di nuovo i token.

Dopo l’aggiornamento segui Aggiornare alla 1.7.0. Prima le modifiche incompatibili.

• IncompatibileRuota la chiave e rilascia i token (obbligatorio). Le versioni precedenti permettevano a un token amministratore in sola lettura di leggere wp-config.php, che contiene la chiave di firma. Dopo l’aggiornamento usa Ruota chiave in Xaflo → Impostazioni e crea nuovi token: la rotazione invalida tutti quelli vecchi.
• Incompatibilesite:write ora cambia file solo dentro la cartella uploads, e solo di tipo inerte (documenti, immagini, audio, video, archivi). Il resto viene rifiutato con 403 xaflo_fs_outside_uploads, che indica fs:admin.
• IncompatibileNuovo scope pericoloso fs:admin, con site:write e un account amministratore: qualsiasi file sotto la cartella del sito tranne quelli protetti. Ogni sovrascrittura, rinomina, eliminazione e ogni scrittura di file eseguibili o di configurazione del server chiede prima conferma. I token esistenti non lo ricevono.
• IncompatibileLe scritture sul database richiedono InnoDB per le tabelle users, usermeta, options e dei token (altrimenti 409). /db/query viene rifiutato del tutto con le modalità SQL NO_BACKSLASH_ESCAPES o ANSI_QUOTES, con una connessione big5, cp932, gbk, gb18030 o sjis, o quando queste impostazioni non si possono leggere.
• IncompatibileCon params si accettano solo i segnaposto semplici %s, %d e %f; ogni altro % viene rifiutato e va passato come valore.
• IncompatibileUna lista di IP consentiti salvata con la 1.6.0 viene applicata solo dopo averla salvata di nuovo dalle Impostazioni; fino ad allora lo segnala un avviso.
• SicurezzaLettura, elenco e ricerca dei file rifiutano e nascondono i segreti: wp-config, .env, backup, dump SQL, debug.log, .htpasswd e la cartella dei backup del plugin, controllando il percorso richiesto e quello risolto.
• Sicurezza/db/query richiede un amministratore. Gli hash delle password vengono tolti da ogni risultato. Le scritture avvengono in una transazione annullata se sono cambiati utenti, ruoli, token del plugin o opzioni protette (indirizzo del sito, email dell’amministratore, plugin attivi e altro).
• SicurezzaOgni route con token controlla una capability di WordPress; leggere i media richiede media:read. I comandi WP-CLI devono coincidere esattamente con una voce della lista consentita, con le opzioni ammesse per comando.
• SicurezzaIl ripristino di un backup non riporta mai la cartella del bridge, i suoi token o le sue impostazioni. Il registro annota ogni richiesta una volta, rifiuti compresi, con password, chiavi, contenuto dei file e valori SQL oscurati.
• SicurezzaL’aggiornamento automatico accetta un rilascio solo con uno SHA-256 e un download https su xaflo.com. La lista di IP usa l’ultimo passaggio non fidato di X-Forwarded-For e non si fida più di CF-Connecting-IP; anche gli amministratori collegati hanno un limite di frequenza.
• AggiuntoDeploy con caricamento: POST /plugins/install-zip accetta lo zip nella richiesta (zip_base64, filename, sha256), al massimo 20 MB. Un plugin nuovo si installa con una chiamata; sostituirne uno esistente chiede conferma.
• AggiuntoAccesso rapido: nuovo scope pericoloso admin:login e POST /admin/login-link, un link monouso, valido 60 secondi, che fa entrare in wp-admin l’utente del token. Rifiutato senza HTTPS e mentre è attivo un plugin noto di accesso a due fattori.
• ModificatoSchermate di amministrazione ridisegnate con il marchio Xaflo e tradotte completamente in italiano. La schermata Token raggruppa gli scope, avvisa per ognuno di quelli pericolosi e ha un pulsante per copiare; Impostazioni mostra se la lista di IP è applicata.
• Modificato/health restituisce anche plugin_version e, a chi ha un token valido, gli scope di quel token. Il server MCP incluso passa dalla 1.0.0-rc15 alla 1.3.0.

fs:admin, db:write, cli:exec, system:backup, plugin:write e theme:write restano equivalenti a un amministratore. Le conferme proteggono dagli incidenti; non sono una barriera contro chi possiede il token.

Una pagina di manutenzione con il marchio del tuo cliente, non il nostro.

• AggiuntoPagina di manutenzione personalizzabile: titolo, sottotitolo, etichetta, colore d’accento, logo e un piè di pagina “powered by Xaflo” facoltativo, tutto da Xaflo → Maintenance. I campi vuoti usano il nome e il motto del sito, così un sito cliente non porta mai il marchio Xaflo se non lo scegli tu.
• AggiuntoPulsante “Preview page” e GET /maintenance/preview: mostra la pagina 503 con i valori attuali del modulo senza mettere offline il sito.

Correzione del conto alla rovescia.

• CorrettoIl conto alla rovescia della pagina 503 diceva “78 s seconds”.

Le pagine di amministrazione tornano a funzionare con il tuo login, e una nuova pagina 503.

• CorrettoLa pagina Audit Log falliva con “Request failed” e la pagina Maintenance con “Missing authorization header”: /audit, /maintenance e /whoami accettavano solo un JWT. Ora accettano anche l’amministratore collegato (cookie + nonce), come la Dashboard.
• CorrettoIl messaggio di manutenzione viene mostrato come HTML, come promette la pagina di amministrazione (prima veniva sottoposto a escape).
• ModificatoPagina di manutenzione 503 ridisegnata: animata, con un conto alla rovescia basato su Retry-After e ricarica automatica alla scadenza. Rispetta prefers-reduced-motion e non carica risorse esterne.

Le scritture ti dicono quando WordPress ha cambiato il tuo markup.

• AggiuntoLe risposte alle scritture di contenuti riportano content_filtered, content_wrapped e content_changed, così chi chiama sa quando KSES ha alterato il markup invece di scoprirlo sulla pagina pubblicata.
• Aggiuntocontent_format (raw o html) nella creazione e modifica di articoli e pagine. html avvolge il contenuto in un blocco core/html così wpautop non può rompere <script> o <style> in linea.
• AggiuntoDELETE /pages/{id}: nel cestino, o eliminazione definitiva con il token di conferma in due passaggi.
• AggiuntoLa pagina About dell’amministrazione elenca le route REST attive lette dal server, con ricerca e filtri.

HTML grezzo per chi è autorizzato, esattamente come nell’editor a blocchi.

• Correttowp_kses_post() veniva applicato a ogni scrittura di articoli e pagine, togliendo <style> e <script> anche ai token di amministratori. Ora i token legati a un utente con la capability unfiltered_html salvano il markup grezzo; tutti gli altri passano ancora da KSES.
• SicurezzaIl controllo è la capability di WordPress stessa: nessuna nuova opzione e nessuna scorciatoia per i token non amministratori.

Un file explorer remoto e una revisione di sicurezza di tutta l’API.

• AggiuntoEndpoint del file explorer: /fs/mkdir, /fs/rename, /fs/delete (con conferma in due passaggi), /fs/upload, /fs/download e una ricerca ricorsiva per nome, /fs/search.
• SicurezzaProtezione SSRF sui download remoti (media da URL, installazione di plugin da zip), controllata dal gestore e attiva di default.
• SicurezzaCorrezione zip-slip nel ripristino dei backup; il ripristino del database ora è transazionale, quindi un errore non lascia più tabelle ripristinate a metà.
• SicurezzaLe liste di IP consentiti non si possono più aggirare con X-Forwarded-For: gli header inoltrati valgono solo dai proxy fidati, e il registro annota il vero IP del client.
• SicurezzaOra serve un token di conferma per cambiare siteurl, home o admin_email; il limite di frequenza di db:write viene applicato.
• Sicurezzawp-config.php non si può scrivere, rinominare, eliminare o scaricare dal file explorer.
• ModificatoI meta protetti (_wp_*) vengono saltati nelle scritture generiche di meta, con una segnalazione nel registro. SqlGuard blocca i tentativi con SLEEP, BENCHMARK e @@.

I file di ogni sito, e configurazione con un clic per Claude e ChatGPT.

• AggiuntoFile Explorer su ogni sito collegato: caricamento, download, rinomina, eliminazione, ricerca ricorsiva e navigazione a briciole di pane.
• AggiuntoUn pulsante “Setup instructions” per ogni sito con la configurazione MCP pronta da incollare per Claude Code, Claude Desktop e ChatGPT Desktop.
• SicurezzaToken di connessione spostati fuori dagli argomenti del processo (ora nelle variabili d’ambiente), navigazione di Electron bloccata con link esterni verificati, e correzione della doppia inizializzazione dell’updater.

Va usato con il plugin 1.4.0 o successivo, che porta gli endpoint /fs/* usati dal File Explorer.

Una versione per WordPress.org, accanto a quella completa.

• AggiuntoUna variante per la distribuzione su WordPress.org. Definisce XAFLO_WPORG_BUILD, che disattiva le funzioni che il Plugin Review Team di WordPress.org considera non ammesse: esecuzione di WP-CLI, SQL diretto, scritture generiche sul filesystem, modifica dei file di plugin e temi, e installazione, attivazione, creazione o cambio di plugin e temi. Disattivata anche la scrittura del drop-in di manutenzione.
• ModificatoLa versione completa, con tutti gli endpoint, resta disponibile da questo sito come download separato.

Xaflo Desktop su Linux.

• AggiuntoVersione per Linux. L’AppImage funziona in modo portabile su qualsiasi distribuzione con glibc 2.31+ (Ubuntu 20.04+, Fedora 33+, Debian 11+); il .deb si installa nel sistema su Debian, Ubuntu e derivate.
• ModificatoLe stesse funzioni della versione Windows 1.1.1: attivazione della licenza WP Xaflo Pro, Plugin Deployer, gestione file, interruttore di manutenzione e console di debug.log.

Filesystem più protetto e compatibilità con più hosting.

• SicurezzaLista di estensioni consentite su /fs/write: di default solo formati di testo sicuri; .php e file binari richiedono un consenso esplicito del gestore.
• ModificatoSe l’hosting condiviso toglie l’header Authorization, si può usare X-WPCB-Authorization.
• CorrettoPlugin Deployer falliva con TypeError: creds.site.replace.
• CorrettoLa barra laterale mostrava chiavi di traduzione come nav.deployer quando mancava una traduzione; il sito selezionato ora resta tale tra le pagine.

Un’API del filesystem in sandbox, e licenze che si verificano offline.

• AggiuntoEndpoint del filesystem /fs/list, /fs/read, /fs/write, /fs/mkdir e /fs/delete, confinati nella cartella di WordPress con protezione dai percorsi trasversali (contenimento con realpath, rimozione dei byte nulli, rifiuto di ..) e blocco delle scritture su wp-config.php.
• AggiuntoRiconoscimento testo o binario per i file senza estensione come error_log, debug.log e LICENSE.
• AggiuntoPagina Licenza in Xaflo Desktop con conto alla rovescia, link di rinnovo e attivazione incollando il token. I token di licenza sono firmati Ed25519 e verificati in locale dall’app, senza contattare nessun server.

Modalità manutenzione e un pannello di controllo remoto.

• AggiuntoModalità manutenzione: GET, POST e DELETE /maintenance, una pagina 503 curata e una lista di IP che la scavalcano. La pagina Xaflo → Maintenance è generata dal server, quindi funziona anche se l’app di amministrazione non si carica.
• Aggiunto/debug/log: le ultime righe di wp-content/debug.log con filtro per gravità e comando per svuotarlo.
• AggiuntoEndpoint per installare, attivare e disattivare plugin, leggere e scrivere i file dei plugin, e leggere e scrivere i file del tema.
• AggiuntoPagine di Desktop per Plugin, File (browser ed editor dei file del tema), Manutenzione e una Console che segue debug.log; la barra laterale è divisa in Remote, Workshop e System.

Aggiornamenti dalla normale schermata di WordPress.

• AggiuntoCanale di aggiornamento proprio: il plugin legge il manifest su questo sito e propone le nuove versioni nella schermata standard degli aggiornamenti di WordPress, con un link “Check for updates” sulla sua riga in Plugin.
• SicurezzaControllo d’integrità SHA-256 prima di estrarre il pacchetto di aggiornamento.
• AggiuntoPlugin Deployer in Xaflo Desktop: invia uno .zip dal tuo computer a più siti con un clic.

Il lancio di Xaflo.

• AggiuntoPrima versione stabile: token JWT con scope, backup con ripristino in una chiamata e un registro con contenuto e autore di ogni chiamata. Il nome interno wp-claude-bridge è diventato Xaflo WP Connect (la cartella del plugin e il namespace REST conservano il vecchio nome).
• AggiuntoInstaller per Windows che riconosce gli aggiornamenti e conserva impostazioni e token, e aggiornamenti automatici con download differenziali.

Analytics e multilingua.

• AggiuntoEndpoint di analytics: panoramica, contenuti più visti, pagine senza traffico, parole chiave, provenienze, confronto tra periodi e andamento per categoria.
• AggiuntoEndpoint multilingua per lingue, traduzioni e controllo delle stringhe.

Backup e registro delle chiamate.

• AggiuntoBackup su richiesta con wp_backup_create, un registro completo e ripristino con una sola chiamata a wp_backup_restore.

Prima anteprima pubblica.

• AggiuntoIl primo ponte tra Claude Code e WordPress via MCP, con autenticazione JWT. Sola lettura di default.