Saltar al contenido principal

Cambiar de dominio

A veces necesitas cambiar el dominio del sitio: pasas de un subdominio de pruebas al dominio final, cambias de .cl a .com, unificas dominios. El framework tiene mecanismos para que sea indoloro.

Los tres escenarios​

1. Migración a otro servidor con nuevo dominio​

Este es el caso más común. Se cubre con el sistema de Empaquetado: al restaurar el paquete en el servidor nuevo con el dominio nuevo, el framework reescribe todas las URLs automáticamente.

2. Cambio de dominio en el mismo servidor​

Si sigues en el mismo servidor pero cambia el dominio:

  1. Actualiza el DNS de sitio-nuevo.com para que apunte al servidor.
  2. Si usas una sola dirección (todo bajo midominio.cl), actualiza la config del servidor web.
  3. Si usas tres direcciones separadas (midominio.cl, app.midominio.cl, miapi.midominio.cl), crea los subdominios equivalentes en el nuevo dominio y apúntalos.
  4. Purga la caché en Configuración → Apariencia.

Muchas URLs internas se reescriben automáticamente al detectar el cambio.

3. Multi-dominio sirviendo el mismo sitio​

Ver Empaquetar y desplegar → Cada parte en su propia dirección.

Qué se reescribe automáticamente​

Cuando restauras un paquete o cambias de dominio, el framework reemplaza el dominio viejo por el nuevo en:

  • URLs de páginas guardadas en la base de datos.
  • URLs de imágenes en campos multimedia.
  • Enlaces embebidos en descripciones y contenido HTML.
  • Menús y navegación.
  • Configuraciones que referencian URLs propias.
  • La carpeta desde la que se servía la instalación anterior. Si el sitio vivía en midominio.cl/pruebas/sistema/ y ahora vive en la raíz de midominio.cl, las fotos guardadas por los módulos —platos de la carta, fichas de propiedades, ítems de inventario, avatares— llevaban esa carpeta escrita dentro y también se corrige.
Si ya migraste y las fotos salen rotas

No hace falta volver a restaurar el paquete. Abre Configuración → Estado del Sistema: la tarjeta Direcciones de los archivos dice dónde se están buscando las fotos y las corrige con un botón. Ver Problemas frecuentes del sitio público.

Qué NO se reescribe automáticamente​

  • URLs hardcodeadas en tu HTML de páginas si escribiste el dominio completo en vez de rutas relativas.
  • Enlaces en emails que ya se enviaron.
  • URLs guardadas en sistemas externos (Google Analytics, Facebook Ads, Payku webhook).
  • Configuraciones de plugins externos que apuntan a tu URL (revisa Payku, license-server, cualquier integración).

Antes de cambiar​

  • Respalda todo. Empaqueta o hace backup completo.
  • Verifica el DNS del dominio nuevo.
  • Certificado SSL para el dominio nuevo activo.
  • Si es multi-host, crea los subdominios en el hosting antes.

Después de cambiar​

  • Verifica que el CMS abre en el dominio nuevo.
  • Prueba login, crear registro, enviar formulario.
  • Revisa páginas públicas — que las imágenes carguen, los enlaces funcionen.
  • Purga la caché desde Configuración → Apariencia.
  • Actualiza Google Search Console (agrega el nuevo dominio).
  • Configura redirección 301 del dominio viejo al nuevo (para no perder tráfico y SEO).
  • Actualiza el webhook de Payku si aplica.

Redirección 301 (para conservar SEO)​

Si el dominio viejo tenía tráfico y posicionamiento, configura una redirección 301 permanente al nuevo. En Apache:

RewriteEngine On
RewriteCond %{HTTP_HOST} ^sitio-viejo\.com$ [OR]
RewriteCond %{HTTP_HOST} ^www\.sitio-viejo\.com$
RewriteRule (.*)$ https://sitio-nuevo.com/$1 [R=301,L]

Elige uno: con www o sin www​

Para el navegador misitio.cl y www.misitio.cl son dos sitios distintos, aunque muestren lo mismo. Si los dos responden, quien entre por el que no es el tuyo recibe una página rota: sin tipografías, sin colores, sin menú desplegable y sin las etiquetas de Google — porque el sistema sólo permite cargar archivos del mismo dominio por el que se entró, y los tuyos están guardados con el otro.

Es de los errores más caros que existen: si un anuncio de Google Ads apunta a la dirección equivocada, estás pagando por visitas que llegan a un sitio roto y que además no se pueden medir.

Cómo revisarlo: abre tu sitio de las dos formas, con www y sin www. Si las dos abren y una se ve distinta, tienes el problema.

Cómo arreglarlo: pídele a quien administra tu hosting que redirija una a la otra. En Apache, para dejar www como la buena:

RewriteEngine On
RewriteCond %{HTTP_HOST} ^misitio\.cl$ [NC]
RewriteRule (.*)$ https://www.misitio.cl/$1 [R=301,L]
Revisa también tus anuncios

La dirección final de cada anuncio de Google Ads, cada campaña de correo y cada enlace en redes tiene que usar la forma elegida.

¿Qué sigue?​