E EmDash CMS Everything Guides, use cases, plugins, templates
Español

Cambiar a un nuevo dominio

En esta página

La Site URL de Settings > General es la dirección pública del sitio. La usan los enlaces de los correos y de los plugins, los sitemaps, robots.txt, los enlaces hreflang, las URL de imágenes sociales y los enlaces canónicos definidos en el panel de SEO. Cámbiala con el cuadro de diálogo Change domain, que comprueba que el nuevo dominio sirve el sitio antes de hacer el cambio.

Solo los administradores pueden cambiar el dominio.

Antes de empezar

Primero apunta el nuevo dominio al sitio. EmDash comprueba el dominio mientras hace el cambio, así que el dominio ya debe servir el sitio por https://.

  • Cloudflare Workers: en el panel de Cloudflare, abre tu Worker en Workers & Pages, ve a la pestaña Domains y añade el dominio. Consulta Dominios personalizados para ver la configuración de Wrangler.
  • Node.js y otros hosts: crea el registro DNS y el certificado del dominio, y enrútalo al mismo servidor que sirve la dirección actual.

Abre https://<nuevo dominio>/_emdash/admin en un navegador. Si aparece la página de inicio de sesión de EmDash, el dominio está listo.

Si el sitio define siteUrl, EMDASH_SITE_URL o SITE_URL, los enlaces de los correos y de los plugins usan esa dirección en lugar de la Site URL, y Settings > General la menciona. Cambia la configuración y vuelve a desplegar para que esos enlaces también se muden.

Cambiar el dominio

  1. Abre Settings > General y selecciona Change domain junto a Site URL.

  2. Introduce el nuevo dominio, por ejemplo www.example.com. También sirve un origen completo como https://www.example.com. No se aceptan rutas ni puertos.

  3. Selecciona Check and switch.

    EmDash solicita un código de un solo uso a https://www.example.com/_emdash/api/site/domain-proof. Cuando el código coincide, guarda https://www.example.com como Site URL y cierra el cuadro de diálogo.

Los cambios sin guardar de Settings > General permanecen en el formulario después del cambio. Guárdalos como de costumbre.

Cuándo se aplica la nueva dirección

  • Correos: los correos de inicio de sesión, invitación, registro propio, recuperación y notificación de comentarios enlazan a la nueva dirección de inmediato.
  • Plugins: ctx.site.url cambia después de reiniciar el servidor o, en Cloudflare Workers, cuando se inician nuevos isolates.
  • Sitemaps y robots.txt: los navegadores y las cachés compartidas pueden conservar las versiones antiguas hasta una hora (sitemaps) o un día (robots.txt).

La dirección antigua sigue sirviendo el sitio hasta que la elimines de tu host. Para enviar a los visitantes de la dirección antigua a la nueva, añade una redirección en tu host o en tu proveedor de DNS.

Iniciar sesión después del cambio

Una passkey solo funciona en la dirección donde se creó. Después del cambio, las passkeys creadas en la dirección antigua no funcionan en la nueva. Traslada tu propio inicio de sesión a la nueva dirección mientras sigues con la sesión iniciada en la antigua:

  1. En Settings > General, selecciona Continue on www.example.com debajo de Site URL. El botón aparece cuando has iniciado sesión en una dirección distinta de la Site URL. Cuando siteUrl está configurada, se compara con esa dirección.

  2. Selecciona Continue en la página de inicio de sesión que se abre en la nueva dirección. El enlace funciona una sola vez y caduca a los 5 minutos.

  3. Settings > Security se abre con el formulario de passkey. Selecciona Register Passkey para crear una passkey para la nueva dirección.

Esto funciona sin correo electrónico. Los demás usuarios pueden iniciar sesión en la nueva dirección con un magic link cuando el correo está configurado, y luego añadir una passkey allí. Hasta entonces, siguen iniciando sesión en la dirección antigua mientras esta siga sirviendo el sitio.

Avisar a los demás usuarios

Cuando el correo electrónico está configurado y los usuarios inician sesión con passkeys, los administradores pueden decirle a cada uno de los demás usuarios dónde iniciar sesión ahora:

  1. En Settings > General, selecciona Email users debajo de Site URL.

  2. Selecciona Send emails.

Todos los usuarios cuya cuenta no esté deshabilitada, excepto tú, reciben un correo que indica que el sitio se ha mudado a la siteUrl configurada, o a la Site URL si no hay ninguna, con un botón hacia la página de inicio de sesión de esa dirección. El correo no inicia la sesión de nadie. Explica que las passkeys de la dirección antigua no funcionan allí y que los usuarios primero inician sesión con un enlace por correo. Después, un mensaje indica cuántos correos se enviaron y cuántos rechazó el proveedor de correo. Los correos se pueden enviar 3 veces por hora por sitio.

Si falla la comprobación

El cuadro de diálogo muestra por qué falló la comprobación:

  • www.example.com does not resolve to a public address: el dominio aún no tiene un registro DNS público o apunta a una red privada. Termina la configuración de DNS e inténtalo de nuevo.
  • Could not reach https://www.example.com: la solicitud agotó el tiempo de espera o la conexión falló, por ejemplo porque el certificado aún no está listo. Espera unos minutos e inténtalo de nuevo.
  • https://example.com redirects to https://www.example.com. Enter that address instead.: el dominio redirige. Introduce la dirección a la que redirige.
  • https://www.example.com does not serve this site yet: el dominio responde, pero no con este sitio. Puede que todavía apunte a un host anterior, o que delante haya una página de inicio de sesión como Cloudflare Access. En Cloudflare, añade el dominio en la pestaña Domains del Worker como Custom Domain. Una ruta no sirve para la comprobación: Cloudflare no ejecuta un Worker para las solicitudes que el Worker envía a su propia ruta en la misma zona.

Usar una dirección sin comprobación

Cuando la comprobación falla, el cuadro de diálogo ofrece Use … anyway. Guarda la dirección sin comprobarla. Úsalo cuando no se pueda acceder al sitio desde internet, por ejemplo durante el desarrollo local en http://localhost:4321 o en un dominio de staging protegido con inicio de sesión.

Los sitemaps y los metadatos de búsqueda usan la dirección guardada tal como se introdujo, incluida una ruta como https://example.com/blog. Los correos y los plugins solo usan su origen, y solo cuando usa https:// o el host es localhost, 127.0.0.1 o [::1]. En caso contrario, siguen usando la dirección con la que se configuró el sitio.

Revisa la dirección con cuidado antes de seleccionarla. Nada confirma que llegue al sitio.