Excluir localización de enlaces

Por defecto, Universally reescribe los enlaces internos en las páginas traducidas para que apunten a la versión traducida. Por ejemplo, un enlace a /about en una página en francés se convierte en /fr/about. Esto asegura que los visitantes permanezcan en su idioma mientras navegan.

La localización de enlaces se aplica a:

• Todos los enlaces <a href> que apuntan a páginas en el mismo dominio
• URLs canónicas (<link rel="canonical">)
• URLs de Open Graph (og:url, og:image, og:video, etc.)
• URLs de Twitter Card (twitter:image, twitter:player, etc.)

Usa Excluir localización de enlaces para evitar que se reescriban enlaces específicos. El campo se encuentra en la pantalla Reglas de traducción del proyecto. Ingresa un patrón de URL por línea.

Cuándo Usar

Algunos enlaces nunca deben tener un prefijo de idioma agregado:

• Descargas de archivos: /downloads/report.pdf no debe convertirse en /fr/downloads/report.pdf
• Puntos de conexión de API: /api/v1/data debe permanecer como está
• Páginas de administrador: los enlaces /wp-admin/ no deben ser localizados
• Recursos estáticos: /wp-content/uploads/image.jpg no debe tener prefijo
• Retrollamadas de servicios externos: URLs de retorno de pago o autenticación
• Fuentes RSS: puntos de conexión /feed/

Sintaxis de Patrones

Un patrón se compara de una de dos maneras, dependiendo de si contiene un *.

Sin *, es una coincidencia de subcadena. Si la URL contiene el patrón en cualquier lugar, el enlace se deja como está.

/wp-content/
/wp-admin/
/api/
/downloads/
/feed/

El patrón /wp-content/ coincide con cualquier URL que contenga esa cadena:

• /wp-content/uploads/photo.jpg: excluido
• /wp-content/themes/style.css: excluido
• /about-wp-content/: también excluido (coincidencia de subcadena)

Con *, es una coincidencia de comodín, anclada en ambos extremos. * representa cualquier carácter. Un patrón que termina en * está abierto; de lo contrario, toda la ruta debe coincidir.

/api/*
*.pdf
/uploads/*.jpg

• /api/* coincide con /api/v1/data y /api/, pero no con /public/api/v1
• *.pdf coincide con cualquier ruta que termine en .pdf
• /uploads/*.jpg coincide con /uploads/2026/photo.jpg

Los patrones de comodín son la forma de expresar "cada PDF" o "todo bajo /api/" con precisión. Nota la diferencia con la forma de subcadena: debido a que un patrón de comodín está anclado, no coincide en cualquier lugar de la ruta.

Ejemplos

Sitios de WordPress

/wp-content/
/wp-admin/
/wp-includes/
/wp-login.php
/wp-signup.php
/wp-activate.php
/xmlrpc.php
/wp-cron.php
/wp-json/
/feed/
/comments/feed/

Nota: Estos se configuran automáticamente para sitios de WordPress. Solo necesitas agregar patrones personalizados.

Comercio electrónico

/cart/add
/checkout/
/webhook/
/downloads/

General

/api/
/assets/
/static/
/uploads/
/_next/

Cómo Funciona Internamente

Cuando Universally procesa una página traducida, reescribe las URLs de dos maneras dependiendo de tu estructura de URL:

Modo de subdirectorio (predeterminado)

Los enlaces tienen el código de idioma como prefijo:

• /about → /fr/about
• /blog/post → /fr/blog/post

Modo de subdominio

Donde un proyecto sirve idiomas en subdominios, el host se cambia en lugar de la ruta:

• https://example.com/about → https://fr.example.com/about

Los subdominios de idioma están en beta cerrada. Consulte Subdominios y subdirectorios.

Los patrones excluidos omiten esta reescritura por completo. La URL original se conserva tal cual.

Cosas a tener en cuenta

• Los enlaces externos (dominio diferente) nunca se localizan independientemente de esta configuración.
• Los enlaces que solo son anclas (#section) nunca se localizan.
• Un enlace que lleva un atributo hreflang nunca se localiza, sin necesidad de configuración.
• Un selector de exclusión CSS solo detiene la localización cuando coincide con el enlace en sí. Un enlace anidado dentro de un contenedor excluido todavía recibe el prefijo de idioma: su texto permanece en el idioma de origen, pero su href se reescribe. Para mantener un enlace específico sin cambios, agregue su ruta aquí o coloque hreflang en el enlace.