Mettere WordPress in modalità manutenzione

La modalità manutenzione di WordPress è uno stato in cui il sito mostra ai visitatori un messaggio temporaneo invece delle pagine normali, mentre tu lavori. WordPress la attiva da solo durante gli aggiornamenti; per altri interventi usi un plugin o una pagina servita dal server. Per la SEO la pagina deve rispondere con codice HTTP 503, meglio con l’intestazione Retry-After.

Qui vedi quando serve davvero, come si attiva (e cosa è documentato ufficialmente e cosa no), perché il codice di risposta conta, quanto tenerla e quali alternative esistono. È un capitolo della guida per creare un sito web, dopo come creare un sito con WordPress.

Cos’è la modalità manutenzione#

È una pagina temporanea che sostituisce il sito per i visitatori mentre l’aggiornamento o la modifica è in corso. Serve a due cose: evitare che le persone vedano il sito a metà, con errori o pagine rotte, e impedire che qualcuno invii ordini o moduli mentre il database è in cambiamento.

WordPress ha una modalità manutenzione integrata, usata quando aggiorna core, temi e plugin: la funzione WP_Upgrader::maintenance_mode() crea il file all’inizio dell’aggiornamento e lo cancella alla fine. Secondo la documentazione per sviluppatori, WordPress controlla se nella cartella principale esiste un file chiamato .maintenance: la modalità è attiva solo se il file è stato creato da meno di 10 minuti, altrimenti viene considerata terminata. È un meccanismo pensato per aggiornamenti brevi, non per chiudere il sito per giorni.

Il messaggio che compare è quello predefinito di WordPress. Come descrive la funzione wp_maintenance(), se nella cartella wp-content esiste un file maintenance.php viene caricato al posto del messaggio standard, e in assenza WordPress risponde con un titolo “Maintenance”, codice HTTP 503 e intestazione Retry-After di 600 secondi.

Quando usarla#

• Aggiornamenti di core, temi e plugin: ci pensa WordPress, per pochi istanti.
• Interventi sul database o migrazioni: importazioni massicce, cambio di dominio, passaggio a un nuovo server.
• Cambi importanti di struttura che lasciano il sito incoerente per un po’.
• Negozi online: durante modifiche a catalogo, prezzi o pagamenti, per non ricevere ordini con dati sbagliati.

Non serve per correggere un refuso o aggiungere una pagina: quelle modifiche si fanno a sito acceso. Né per un sito ancora in costruzione, per cui conviene un ambiente separato (vedi più sotto).

Come attivarla#

Con WordPress, durante gli aggiornamenti#

Non devi fare nulla: quando lanci un aggiornamento WordPress crea il file .maintenance e lo toglie a fine operazione. Se il sito resta bloccato su “Briefly unavailable for scheduled maintenance” perché l’aggiornamento è stato interrotto, il file può essere rimasto nella cartella principale. Per la regola dei 10 minuti dovrebbe cessare da solo; se non succede, puoi cancellarlo via SFTP o dal file manager dell’hosting (è un file nascosto, perciò attiva la visualizzazione dei file nascosti) e poi rilanciare l’aggiornamento dopo aver controllato che non sia rimasto a metà.

Con un plugin dedicato#

Per interventi programmati esistono diversi plugin di manutenzione nel repository ufficiale. Cosa guardare nella scelta:

• se invia davvero un codice 503 (alcuni mostrano la pagina con codice 200: lo verifichi come spiegato sotto);
• se permette l’intestazione Retry-After;
• se lascia entrare gli amministratori mentre i visitatori vedono la pagina;
• se è aggiornato, leggero e compatibile con la tua versione di WordPress.

Attiva il plugin, controlla da una finestra in incognito cosa vede il visitatore, lavora, poi disattivalo e ricontrolla. Non lasciarlo attivo “per sicurezza”.

Con una pagina servita dal server#

Per un intervento di qualche ora, o per essere sicuri del codice di risposta, puoi far rispondere direttamente il server (Apache, Nginx) con un 503 e una pagina HTML statica. Un esempio per Nginx, da adattare e provare in un ambiente di test:

# tutte le richieste rispondono 503 con la pagina di manutenzione
error_page 503 /manutenzione.html;

location / {
    return 503;
}

# la pagina di manutenzione mantiene il codice 503;
# "always" serve perché add_header di norma non vale per le risposte di errore
location = /manutenzione.html {
    root /var/www/manutenzione;
    add_header Retry-After 3600 always;
    internal;
}

# il robots.txt resta raggiungibile con codice 200 (file statico)
location = /robots.txt {
    root /var/www/manutenzione;
}

Questo è un esempio generico di configurazione, non una procedura ufficiale di WordPress: va inserito nel blocco server del sito, al posto delle regole normali, solo per la durata dell’intervento. Se non conosci la configurazione del server, chiedi all’assistenza dell’hosting o a chi gestisce il sito: un errore può mettere offline tutto.

Il codice 503 e Retry-After: perché contano per la SEO#

Un sito in manutenzione che risponde “200 OK” con una pagina che dice “torniamo presto” sembra a Google un sito che ha cambiato tutti i contenuti con un unico messaggio. Il codice giusto dice ai crawler: “problema temporaneo, riprova più tardi”. Nella pagina di Google Search Central su come mettere in pausa un’attività online si legge che:

• spegnere del tutto il sito è sconsigliato e, se proprio serve, solo per periodi molto brevi: “al massimo qualche giorno”;
• per uno o due giorni va bene una pagina informativa con codice HTTP 503; per periodi più lunghi Google suggerisce una home page indicizzabile con codice 200 come segnaposto;
• conviene inviare un’intestazione Retry-After con una data o una durata stimata, e verificare il 503 in locale con curl o uno strumento simile;
• il file robots.txt non deve rispondere 503, perché blocca la scansione di tutto il sito;
• vanno evitati 403, 404 e 410, il noindex e l’intestazione X-Robots-Tag, che fanno uscire gli URL dalla Ricerca, e il blocco totale della scansione nel robots.txt;
• la pagina dovrebbe essere leggera (HTML statico, CSS inline) e dire quando il sito tornerà e come contattarti;
• mentre le pagine rispondono 503, Google non può aggiornare titoli, descrizioni e dati strutturati.

La pagina sulla gestione degli errori HTTP e di rete aggiunge che gli errori 5xx, 503 compreso, portano i crawler di Google a rallentare temporaneamente la scansione; quando il sito torna a rispondere con un 2xx, la velocità di scansione riprende gradualmente. Gli URL già indicizzati restano nell’indice durante gli errori del server, ma se questi durano troppo possono essere eliminati col tempo.

Per controllare cosa risponde il sito, apri il terminale e lancia curl -I https://tuosito.it/: la prima riga deve mostrare 503 e, se l’hai impostato, deve esserci la riga Retry-After. Controlla anche /robots.txt, che deve continuare a rispondere 200.

Quanto tenerla#

Il meno possibile: minuti per un aggiornamento, qualche ora per una migrazione. Google indica 1-2 giorni come limite per una pagina con 503. Se serve di più, non spegnere il sito: lavora su una copia (staging) e pubblica tutto insieme, oppure lascia online il sito con funzioni limitate, come suggerisce Google.

Nella pagina scrivi il motivo, l’orario previsto di ritorno e un contatto. Alla fine controlla subito home, pagine principali, modulo di contatto e Search Console per eventuali errori di scansione.

Alternative alla modalità manutenzione#

• Staging: una copia del sito su un indirizzo separato, dove provi aggiornamenti e modifiche, poi porti in produzione solo quelle che funzionano. È la soluzione migliore per i siti con traffico o con un negozio, e molti hosting la offrono con un clic. Tieni la copia fuori dai motori di ricerca.
• Aggiornare in orari tranquilli, quando il traffico è minimo.
• Backup prima di tutto: se l’aggiornamento rompe qualcosa, torni indietro senza tenere il sito chiuso a lungo.
• Limitare le funzioni (ad esempio disattivare il carrello) lasciando il resto consultabile, quando la pausa riguarda solo una parte.

Se non vuoi gestire tutto questo, la manutenzione dei siti WordPress comprende aggiornamenti, backup e controlli. Se invece il sito si è bloccato dopo un attacco, leggi sicurezza e manutenzione dei siti.

Il tuo sito è rimasto bloccato in manutenzione o vuoi capire se è visibile a Google? Richiedi l’audit SEO gratuito o scrivici.