Excluir localização de links

Por padrão, o Universally reescreve links internos em páginas traduzidas para apontar para a versão traduzida. Por exemplo, um link para /about em uma página em francês se torna /fr/about. Isso garante que os visitantes permaneçam em seu idioma durante a navegação.

A localização de links se aplica a:

• Todos os links <a href> apontando para páginas no mesmo domínio
• URLs canônicas (<link rel="canonical">)
• URLs do Open Graph (og:url, og:image, og:video, etc.)
• URLs do Twitter Card (twitter:image, twitter:player, etc.)

Use Excluir Localização de Links para impedir que links específicos sejam reescritos. O campo está na tela Regras de Tradução do projeto. Insira um padrão de URL por linha.

Quando Usar

Alguns links nunca devem ter um prefixo de idioma adicionado:

• Downloads de arquivos: /downloads/report.pdf não deve se tornar /fr/downloads/report.pdf
• Endpoints de API: /api/v1/data deve permanecer como está
• Páginas de administração: links /wp-admin/ não devem ser localizados
• Recursos estáticos: /wp-content/uploads/image.jpg não deve ter prefixo
• Callbacks de serviços externos: URLs de retorno de pagamento ou autenticação
• Feeds RSS: endpoints /feed/

Sintaxe de Padrão

Um padrão é correspondido de uma das duas maneiras, dependendo se ele contém um *.

Sem *, é uma correspondência de substring. Se a URL contiver o padrão em qualquer lugar, o link é deixado como está.

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

O padrão /wp-content/ corresponde a qualquer URL que contenha essa string:

• /wp-content/uploads/photo.jpg: excluído
• /wp-content/themes/style.css: excluído
• /about-wp-content/: também excluído (correspondência de substring)

Com *, é uma correspondência de curinga, ancorada em ambas as extremidades. * representa quaisquer caracteres. Um padrão que termina em * está em aberto; caso contrário, todo o caminho deve corresponder.

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

• /api/* corresponde a /api/v1/data e /api/, mas não a /public/api/v1
• *.pdf corresponde a qualquer caminho que termine em .pdf
• /uploads/*.jpg corresponde a /uploads/2026/photo.jpg

Padrões de curinga são a maneira de expressar "todo PDF" ou "tudo em /api/" com precisão. Observe a diferença da forma de substring: como um padrão de curinga é ancorado, ele não corresponde apenas em qualquer lugar do caminho.

Exemplos

Sites 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/

Observação: Estes são configurados automaticamente para sites WordPress. Você só precisa adicionar padrões personalizados.

E-commerce

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

Geral

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

Como Funciona Internamente

Quando o Universally processa uma página traduzida, ele reescreve URLs de duas maneiras, dependendo da sua estrutura de URL:

Modo de subdiretório (padrão)

Links são prefixados com o código do idioma:

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

Modo de subdomínio

Onde um projeto atende idiomas em subdomínios, o host é alterado em vez do caminho:

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

Os subdomínios de idioma estão em beta fechado. Veja Subdomínios e subdiretórios.

Padrões excluídos ignoram completamente essa reescrita. A URL original é preservada como está.

Pontos a observar

• Links externos (domínio diferente) nunca são localizados, independentemente desta configuração
• Links apenas de âncora (#section) nunca são localizados
• Um link que carrega um atributo hreflang nunca é localizado, sem necessidade de configuração
• Um seletor de exclusão CSS apenas impede a localização quando ele corresponde ao próprio link. Um link aninhado dentro de um contêiner excluído ainda recebe o prefixo de idioma: seu texto permanece no idioma de origem, mas seu href é reescrito. Para manter um link específico intocado, adicione seu caminho aqui ou coloque hreflang no link