Escludi localizzazione link

Per impostazione predefinita, Universally riscrive i link interni nelle pagine tradotte per puntare alla versione tradotta. Ad esempio, un link a /about in una pagina francese diventa /fr/about. Questo garantisce che i visitatori rimangano nella loro lingua durante la navigazione.

La localizzazione dei link si applica a:

• Tutti i link <a href> che puntano a pagine sullo stesso dominio
• URL canonici (<link rel="canonical">)
• URL Open Graph (og:url, og:image, og:video, ecc.)
• URL Twitter Card (twitter:image, twitter:player, ecc.)

Usa Escludi localizzazione link per impedire la riscrittura di link specifici. Il campo si trova nella schermata Regole di traduzione del progetto. Inserisci un pattern di URL per riga.

Quando Usare

Alcuni link non dovrebbero mai avere un prefisso linguistico aggiunto:

• Download di file: /downloads/report.pdf non dovrebbe diventare /fr/downloads/report.pdf
• Endpoint API: /api/v1/data deve rimanere invariato
• Pagine di amministrazione: i link /wp-admin/ non dovrebbero essere localizzati
• Asset statici: /wp-content/uploads/image.jpg non dovrebbe essere prefissato
• Callback di servizi esterni: URL di ritorno per pagamenti o autenticazione
• Feed RSS: endpoint /feed/

Sintassi dei Pattern

Un pattern viene confrontato in uno dei due modi, a seconda che contenga o meno un *.

Senza *, si tratta di una corrispondenza di sottostringa. Se l'URL contiene il pattern ovunque, il link viene lasciato invariato.

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

Il pattern /wp-content/ corrisponde a qualsiasi URL che contenga quella stringa:

• /wp-content/uploads/photo.jpg: escluso
• /wp-content/themes/style.css: escluso
• /about-wp-content/: escluso anche (corrispondenza di sottostringa)

Con *, si tratta di una corrispondenza jolly, ancorata ad entrambe le estremità. * rappresenta qualsiasi carattere. Un pattern che termina con * è aperto; altrimenti, l'intero percorso deve corrispondere.

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

• /api/* corrisponde a /api/v1/data e /api/, ma non a /public/api/v1
• *.pdf corrisponde a qualsiasi percorso che termina con .pdf
• /uploads/*.jpg corrisponde a /uploads/2026/photo.jpg

I pattern jolly sono il modo per esprimere "ogni PDF" o "tutto sotto /api/" con precisione. Nota la differenza dalla forma di sottostringa: poiché un pattern jolly è ancorato, non corrisponde solo in un punto qualsiasi del percorso.

Esempi

Siti 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: Questi sono configurati automaticamente per i siti WordPress. Devi solo aggiungere pattern personalizzati.

E-commerce

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

Generale

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

Come Funziona Internamente

Quando Universally elabora una pagina tradotta, riscrive gli URL in due modi a seconda della struttura dei tuoi URL:

Modalità sottodirectory (predefinita)

I link vengono preceduti dal codice della lingua:

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

Modalità sottodominio

Dove un progetto serve le lingue su sottodomini, l'host viene modificato invece del percorso:

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

I sottodomini linguistici sono in beta chiusa. Vedi Sottodomini e sottodirectory.

I pattern esclusi ignorano completamente questa riscrittura. L'URL originale viene preservato così com'è.

Cose da notare

• I link esterni (dominio diverso) non vengono mai localizzati indipendentemente da questa impostazione
• I link solo ancora (#sezione) non vengono mai localizzati
• Un link che trasporta un attributo hreflang non viene mai localizzato, senza alcuna configurazione necessaria
• Un selettore di esclusione CSS interrompe la localizzazione solo quando corrisponde al link stesso. Un link annidato all'interno di un contenitore escluso riceve comunque il prefisso della lingua: il suo testo rimane nella lingua di origine, ma il suo href viene riscritto. Per mantenere un link specifico intatto, aggiungi il suo percorso qui o metti hreflang sul link