A Site URL em Settings > General é o endereço público do site. Os links em e-mails e plugins, os sitemaps, o robots.txt, os links hreflang, as URLs de imagens sociais e os links canônicos definidos no painel de SEO a utilizam. Altere-a com a caixa de diálogo Change domain, que verifica se o novo domínio serve o site antes de fazer a troca.
Somente administradores podem alterar o domínio.
Antes de começar
Aponte primeiro o novo domínio para o site. O EmDash verifica o domínio durante a troca, então o domínio já precisa servir o site por https://.
- Cloudflare Workers: no painel da Cloudflare, abra seu Worker em Workers & Pages, vá para a aba Domains e adicione o domínio. Consulte Domínios personalizados para ver a configuração do Wrangler.
- Node.js e outros hosts: crie o registro DNS e o certificado do domínio e encaminhe-o para o mesmo servidor que serve o endereço atual.
Abra https://<novo domínio>/_emdash/admin em um navegador. Se a página de login do EmDash aparecer, o domínio está pronto.
Se o site define siteUrl, EMDASH_SITE_URL ou SITE_URL, os links em e-mails e plugins usam esse endereço em vez da Site URL, e Settings > General o indica. Altere a configuração e faça o deploy novamente para mover esses links também.
Alterar o domínio
-
Abra Settings > General e selecione Change domain ao lado de Site URL.
-
Digite o novo domínio, por exemplo
www.example.com. Uma origem completa comohttps://www.example.comtambém funciona. Caminhos e portas não são aceitos. -
Selecione Check and switch.
O EmDash solicita um código de uso único a
https://www.example.com/_emdash/api/site/domain-proof. Quando o código confere, ele armazenahttps://www.example.comcomo a Site URL e fecha a caixa de diálogo.
As alterações não salvas em Settings > General permanecem no formulário após a troca. Salve-as normalmente.
Quando o novo endereço entra em vigor
- E-mails: os e-mails de login, convite, autocadastro, recuperação e notificação de comentários apontam para o novo endereço imediatamente.
- Plugins:
ctx.site.urlmuda depois que o servidor é reiniciado ou, no Cloudflare Workers, quando novos isolates são iniciados. - Sitemaps e
robots.txt: navegadores e caches compartilhados podem manter as versões antigas por até uma hora (sitemaps) ou um dia (robots.txt).
O endereço antigo continua servindo o site até você removê-lo do seu host. Para enviar os visitantes do endereço antigo para o novo, adicione um redirecionamento no seu host ou provedor de DNS.
Entrar depois da mudança
Uma passkey só funciona no endereço em que foi criada. Depois da mudança, as passkeys criadas no endereço antigo não funcionam no novo. Mova o seu próprio login para o novo endereço enquanto ainda estiver conectado no antigo:
-
Em Settings > General, selecione Continue on www.example.com abaixo de Site URL. O botão aparece quando você está conectado em um endereço diferente da Site URL. Quando
siteUrlestá configurada, a comparação é feita com esse endereço. -
Selecione Continue na página de login que abre no novo endereço. O link funciona uma única vez e expira após 5 minutos.
-
Settings > Security abre com o formulário de passkey. Selecione Register Passkey para criar uma passkey para o novo endereço.
Isso funciona sem e-mail. Os outros usuários podem entrar no novo endereço com um magic link quando o e-mail está configurado e, depois, adicionar uma passkey lá. Até então, eles continuam entrando no endereço antigo enquanto ele ainda servir o site.
Avisar os outros usuários
Quando o e-mail está configurado e os usuários entram com passkeys, os administradores podem avisar todos os outros usuários onde entrar agora:
-
Em Settings > General, selecione Email users abaixo de Site URL.
-
Selecione Send emails.
Todo usuário cuja conta não esteja desativada, exceto você, recebe um e-mail informando que o site mudou para a siteUrl configurada, ou para a Site URL quando nenhuma está definida, com um botão para a página de login nesse endereço. O e-mail não conecta ninguém. Ele explica que as passkeys do endereço antigo não funcionam lá e que os usuários entram primeiro com um link enviado por e-mail. Em seguida, uma mensagem mostra quantos e-mails foram enviados e quantos o provedor de e-mail rejeitou. Os e-mails podem ser enviados 3 vezes por hora por site.
Se a verificação falhar
A caixa de diálogo mostra por que a verificação falhou:
www.example.com does not resolve to a public address: o domínio ainda não tem um registro DNS público ou aponta para uma rede privada. Conclua a configuração do DNS e tente novamente.Could not reach https://www.example.com: a requisição expirou ou a conexão falhou, por exemplo porque o certificado ainda não está pronto. Aguarde alguns minutos e tente novamente.https://example.com redirects to https://www.example.com. Enter that address instead.: o domínio redireciona. Digite o endereço para o qual ele redireciona.https://www.example.com does not serve this site yet: o domínio responde, mas não com este site. Ele pode ainda apontar para um host anterior, ou uma página de login como o Cloudflare Access pode estar na frente. No Cloudflare, adicione o domínio na aba Domains do Worker como Custom Domain. Uma rota não funciona para a verificação: o Cloudflare não executa um Worker para requisições que o Worker envia para a própria rota na mesma zona.
Usar um endereço sem a verificação
Quando a verificação falha, a caixa de diálogo oferece Use … anyway. Ela armazena o endereço sem verificá-lo. Use-a quando o site não puder ser alcançado pela internet, por exemplo durante o desenvolvimento local em http://localhost:4321 ou em um domínio de staging protegido por login.
Os sitemaps e os metadados de busca usam o endereço armazenado exatamente como foi digitado, incluindo um caminho como https://example.com/blog. E-mails e plugins usam apenas a origem dele, e somente quando ele usa https:// ou o host é localhost, 127.0.0.1 ou [::1]. Caso contrário, continuam usando o endereço em que o site foi configurado.
Verifique o endereço com cuidado antes de selecioná-lo. Nada confirma que ele chega ao site.