Usando las URLs amigables

Las URLs amigables (FURL) reemplazan direcciones como index.php?id=42 por rutas legibles basadas en alias de recursos, como /about/ o /blog/my-post.

Necesitas dos cosas:

1. Reglas de reescritura en el servidor web que envíen rutas desconocidas a index.php
2. URLs amigables activadas en MODX

1. Configura tu servidor web¶

MODX Cloud: las reglas de reescritura ya están — omite este paso.

Otros servidores: elige tu guía:

• Apache (la mayoría del hosting compartido; usa ht.access → .htaccess)
• IIS (web.config + URL Rewrite)
• nginx
• lighttpd

Mientras la reescritura no funcione, activar las URLs amigables en MODX dará 404 en las rutas limpias.

2. Activa las URLs amigables en MODX¶

En el Manager, abre System Settings (icono de engranaje, navegación superior).

Filtra por clave friendly (o Área: Friendly URL) y establece al menos:

Opcional: friendly_urls_strict devuelve 404 para alias desconocidos en lugar de recurrir al pagetitle.

Con Use Friendly Alias Path en No, los recursos se comportan como si estuvieran en la raíz del sitio, ignorando las carpetas padre.

La configuración relacionada use_frozen_parent_uris (por defecto No) hace que las URI de los recursos hijos sean relativas a la URI congelada de su padre en lugar de su alias actual — útil cuando los padres cambian a menudo.

Los recursos contenedor (carpetas) usan el ajuste container_suffix (por defecto /) en lugar de friendly_url_prefix / friendly_url_suffix, eliminados a favor de los Content Types. Solo aplica a carpetas cuyo content type es HTML.

Para títulos no latinos, configura la transliteración de alias (friendly_alias_translit: none (por defecto), iconv, iconv_ascii o una tabla con nombre): Transliteración de alias.

3. Añade un base href en tus Plantillas¶

Pon esto en el <head> de cada Plantilla que sirva HTML:

<base href="[[!++site_url]]" />

Las URL relativas de recursos resuelven así desde la raíz del sitio, incluso en rutas anidadas.

4. Borra la caché del sitio¶

Al guardar estos ajustes MODX reconstruye los URI y recarga la configuración automáticamente. Si el frontend sigue sirviendo enlaces o páginas obsoletas, borra la caché desde el Manager (o elimina core/cache/) — también tras editar alias o Plantillas.

Construyendo enlaces¶

Prefiere los tag de enlace para que las URL sigan siendo correctas al mover recursos:

<a href="[[~1]]" title="Some title">Some Page</a>

Ver Recursos para la sintaxis de los tag de enlace.

Opcional: redirecciones www y HTTPS¶

Cuando las FURL funcionen, elige un host canónico (www o dominio sin www) y HTTP o HTTPS — los nombres de host duplicados causan problemas de sesiones y SEO.

En Apache, el archivo ht.access incluye ejemplos de reglas comentados: descomenta el bloque que necesites y reemplaza el dominio. Ver la guía de Apache.

En nginx, coloca la lógica equivalente return 301 en los bloques server correspondientes.

En IIS, añade reglas de redirección equivalentes en web.config (ver la guía de IIS).

Relacionado¶

• Transliteración de alias
• friendly_urls_strict
• Requisitos del servidor
• Content Types

Solución de problemas: 404 en rutas bonitas¶

• Las rutas bonitas devuelven 404 pero index.php?id=42 funciona → faltan las reglas de reescritura o no corresponden a tu servidor — vuelve al paso 1.
• CSS/JS se rompieron al activar FURL → añade <base href> a tus plantillas (paso 3).
• Los enlaces no cambiaron al activar friendly_urls → vacía la caché (paso 4); los recursos ya guardados mantienen su alias hasta que los edites.
• Las peticiones a archivos de core/ devuelven 404 → es lo esperado; core/ debe seguir bloqueado (Endurecer MODX).