La Site URL in Settings > General è l’indirizzo pubblico del sito. La usano i link nelle email e nei plugin, le sitemap, robots.txt, i link hreflang, gli URL delle immagini social e i link canonici impostati nel pannello SEO. Modificala con la finestra Change domain, che verifica che il nuovo dominio serva il sito prima di effettuare il passaggio.
Solo gli amministratori possono cambiare il dominio.
Prima di iniziare
Punta prima il nuovo dominio al sito. EmDash verifica il dominio durante il passaggio, quindi il dominio deve già servire il sito tramite https://.
- Cloudflare Workers: nella dashboard di Cloudflare, apri il tuo Worker in Workers & Pages, vai alla scheda Domains e aggiungi il dominio. Consulta Domini personalizzati per la configurazione di Wrangler.
- Node.js e altri host: crea il record DNS e il certificato per il dominio e instradalo allo stesso server che serve l’indirizzo attuale.
Apri https://<nuovo dominio>/_emdash/admin in un browser. Se compare la pagina di accesso di EmDash, il dominio è pronto.
Se il sito imposta siteUrl, EMDASH_SITE_URL o SITE_URL, i link nelle email e nei plugin usano quell’indirizzo al posto della Site URL, e Settings > General lo indica. Modifica la configurazione e distribuisci di nuovo per spostare anche quei link.
Cambiare il dominio
-
Apri Settings > General e seleziona Change domain accanto a Site URL.
-
Inserisci il nuovo dominio, ad esempio
www.example.com. Funziona anche un’origin completa comehttps://www.example.com. Percorsi e porte non sono accettati. -
Seleziona Check and switch.
EmDash richiede un codice monouso a
https://www.example.com/_emdash/api/site/domain-proof. Quando il codice corrisponde, salvahttps://www.example.comcome Site URL e chiude la finestra.
Le modifiche non salvate in Settings > General restano nel modulo dopo il passaggio. Salvale come al solito.
Quando il nuovo indirizzo diventa effettivo
- Email: le email di accesso, invito, autoregistrazione, recupero e notifica dei commenti puntano subito al nuovo indirizzo.
- Plugin:
ctx.site.urlcambia dopo il riavvio del server oppure, su Cloudflare Workers, all’avvio di nuovi isolate. - Sitemap e
robots.txt: i browser e le cache condivise possono conservare le vecchie versioni fino a un’ora (sitemap) o un giorno (robots.txt).
Il vecchio indirizzo continua a servire il sito finché non lo rimuovi dal tuo host. Per indirizzare i visitatori dal vecchio indirizzo a quello nuovo, aggiungi un reindirizzamento presso il tuo host o il tuo provider DNS.
Accedere dopo il passaggio
Una passkey funziona solo all’indirizzo in cui è stata creata. Dopo il passaggio, le passkey create al vecchio indirizzo non funzionano al nuovo. Sposta il tuo accesso al nuovo indirizzo mentre sei ancora connesso a quello vecchio:
-
In Settings > General, seleziona Continue on www.example.com sotto Site URL. Il pulsante compare quando hai effettuato l’accesso a un indirizzo diverso dalla Site URL. Quando
siteUrlè configurata, il confronto avviene con quell’indirizzo. -
Seleziona Continue nella pagina di accesso che si apre al nuovo indirizzo. Il link funziona una sola volta e scade dopo 5 minuti.
-
Settings > Security si apre con il modulo per la passkey. Seleziona Register Passkey per creare una passkey per il nuovo indirizzo.
Questo funziona anche senza email. Gli altri utenti possono accedere al nuovo indirizzo con un magic link quando l’email è configurata, e poi aggiungere una passkey lì. Fino ad allora continuano ad accedere al vecchio indirizzo finché serve ancora il sito.
Avvisare gli altri utenti
Quando l’email è configurata e gli utenti accedono con le passkey, gli amministratori possono comunicare a tutti gli altri utenti dove accedere ora:
-
In Settings > General, seleziona Email users sotto Site URL.
-
Seleziona Send emails.
Ogni utente il cui account non è disabilitato, escluso te, riceve un’email che indica che il sito si è spostato alla siteUrl configurata, oppure alla Site URL se non ne è impostata nessuna, con un pulsante verso la pagina di accesso a quell’indirizzo. L’email non fa accedere nessuno. Spiega che le passkey del vecchio indirizzo non funzionano lì e che gli utenti accedono prima con un link ricevuto via email. Un messaggio mostra poi quante email sono state inviate e quante sono state rifiutate dal provider email. Le email possono essere inviate 3 volte all’ora per sito.
Se la verifica fallisce
La finestra mostra perché la verifica è fallita:
www.example.com does not resolve to a public address: il dominio non ha ancora un record DNS pubblico oppure punta a una rete privata. Completa la configurazione DNS e riprova.Could not reach https://www.example.com: la richiesta è scaduta o la connessione non è riuscita, ad esempio perché il certificato non è ancora pronto. Attendi qualche minuto e riprova.https://example.com redirects to https://www.example.com. Enter that address instead.: il dominio reindirizza. Inserisci l’indirizzo verso cui reindirizza.https://www.example.com does not serve this site yet: il dominio risponde, ma non con questo sito. Potrebbe puntare ancora a un host precedente, oppure davanti potrebbe esserci una pagina di accesso come Cloudflare Access. Su Cloudflare, aggiungi il dominio nella scheda Domains del Worker come Custom Domain. Una route non funziona per la verifica: Cloudflare non esegue un Worker per le richieste che il Worker invia alla propria route nella stessa zona.
Usare un indirizzo senza verifica
Quando la verifica fallisce, la finestra offre Use … anyway. Salva l’indirizzo senza verificarlo. Usalo quando il sito non è raggiungibile da internet, ad esempio durante lo sviluppo locale su http://localhost:4321 o su un dominio di staging protetto da un accesso.
Le sitemap e i metadati di ricerca usano l’indirizzo salvato così come è stato inserito, compreso un percorso come https://example.com/blog. Le email e i plugin ne usano solo l’origin, e solo quando usa https:// oppure l’host è localhost, 127.0.0.1 o [::1]. Altrimenti continuano a usare l’indirizzo con cui il sito è stato configurato.
Controlla attentamente l’indirizzo prima di selezionarlo. Nulla conferma che raggiunga il sito.