Universally Dokumentation

Schritt-für-Schritt-Anleitungen, mehrsprachige SEO-Tipps und Best Practices, die Ihnen helfen, Ihre WordPress-Website zu übersetzen und zu skalieren.

Link-Lokalisierung ausschließen

Standardmäßig schreibt Universally interne Links auf übersetzten Seiten um, sodass sie auf die übersetzte Version verweisen. Zum Beispiel wird ein Link zu /about auf einer französischen Seite zu /fr/about. Dies stellt sicher, dass Besucher während der Navigation in ihrer Sprache bleiben.

Link-Lokalisierung gilt für:

  • Alle <a href>-Links, die auf Seiten auf derselben Domain verweisen
  • Kanonische URLs (<link rel="canonical">)
  • Open Graph URLs (og:url, og:image, og:video, etc.)
  • Twitter Card URLs (twitter:image, twitter:player, etc.)

Verwenden Sie Link-Lokalisierung ausschließen, um zu verhindern, dass bestimmte Links umgeschrieben werden. Das Feld befindet sich auf dem Bildschirm Übersetzungsregeln des Projekts. Geben Sie ein URL-Muster pro Zeile ein.

Wann verwenden

Einige Links sollten niemals mit einem Sprachpräfix versehen werden:

  • Dateidownloads: /downloads/report.pdf sollte nicht zu /fr/downloads/report.pdf werden
  • API-Endpunkte: /api/v1/data muss unverändert bleiben
  • Admin-Seiten: /wp-admin/-Links sollten nicht lokalisiert werden
  • Statische Assets: /wp-content/uploads/image.jpg sollte kein Präfix erhalten
  • Callbacks von externen Diensten: Zahlungs- oder Autorisierungs-Rückruf-URLs
  • RSS-Feeds: /feed/-Endpunkte

Muster-Syntax

Ein Muster wird auf eine von zwei Arten abgeglichen, je nachdem, ob es ein * enthält.

Ohne * ist es eine Teilzeichenfolgenübereinstimmung. Wenn die URL das Muster irgendwo enthält, wird der Link unverändert gelassen.

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

Das Muster /wp-content/ passt zu jeder URL, die diese Zeichenfolge enthält:

  • /wp-content/uploads/photo.jpg: ausgeschlossen
  • /wp-content/themes/style.css: ausgeschlossen
  • /about-wp-content/: ebenfalls ausgeschlossen (Teilzeichenfolgenübereinstimmung)

Mit * ist es eine Wildcard-Übereinstimmung, die an beiden Enden verankert ist. * steht für beliebige Zeichen. Ein Muster, das mit * endet, ist offen; andernfalls muss der gesamte Pfad übereinstimmen.

/api/*
*.pdf
/uploads/*.jpg
  • /api/* passt zu /api/v1/data und /api/, aber nicht zu /public/api/v1
  • *.pdf passt zu jedem Pfad, der mit .pdf endet
  • /uploads/*.jpg passt zu /uploads/2026/photo.jpg

Wildcard-Muster sind der Weg, um „jede PDF-Datei“ oder „alles unter /api/“ präzise auszudrücken. Beachten Sie den Unterschied zur Teilzeichenfolgenform: Da ein Wildcard-Muster verankert ist, passt es nicht einfach irgendwo im Pfad.

Beispiele

WordPress-Seiten

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

Hinweis: Diese werden für WordPress-Websites automatisch konfiguriert. Sie müssen nur benutzerdefinierte Muster hinzufügen.

E-Commerce

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

Allgemein

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

Wie es intern funktioniert

Wenn Universally eine übersetzte Seite verarbeitet, schreibt es URLs auf zwei Arten um, abhängig von Ihrer URL-Struktur:

Unterverzeichnis-Modus (Standard)

Links werden mit dem Sprachcode präfixiert:

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

Subdomain-Modus

Wenn ein Projekt Sprachen auf Subdomains bedient, wird stattdessen der Host geändert und nicht der Pfad:

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

Sprach-Subdomains befinden sich in einer geschlossenen Beta. Siehe Subdomains und Unterverzeichnisse.

Ausgeschlossene Muster umgehen diese Umschreibung vollständig. Die ursprüngliche URL bleibt unverändert.

Wichtige Hinweise

  • Externe Links (andere Domain) werden unabhängig von dieser Einstellung niemals lokalisiert
  • Nur-Anker-Links (#section) werden niemals lokalisiert
  • Ein Link mit einem hreflang-Attribut wird niemals lokalisiert, ohne dass eine Konfiguration erforderlich ist.
  • Ein CSS-Ausschlussselektor stoppt die Lokalisierung nur, wenn er mit dem Link selbst übereinstimmt. Ein Link, der in einem ausgeschlossenen Container verschachtelt ist, erhält trotzdem das Sprachpräfix: Sein Text bleibt in der Quellsprache, aber sein href wird umgeschrieben. Um einen bestimmten Link unverändert zu lassen, fügen Sie hier seinen Pfad hinzu oder setzen Sie hreflang für den Link.
War das hilfreich?