Erstellt:
Wenn Entwickler oder Produktmanager von einem Produkt (wie Firefox) aus auf einen SUMO-Support-Artikel verlinken, sollten sie immer eine stabile URL und nicht den direkten Link zum Artikel verwenden. Direkte Links ändern sich, wenn der Titel oder der Slug des Artikels aktualisiert wird, was dazu führen kann, dass Links innerhalb des Produkts nicht mehr funktionieren. Stabile Links schützen davor und stellen sicher, dass Nutzer immer auf der richtigen Seite landen.
Dieser Artikel erklärt, warum stabile Links wichtig sind, wie sie für verschiedene Plattformen formatiert werden und wie man sie über das Kitsune-Dashboard einrichtet.
Inhaltsverzeichnis
Warum stabile Links wichtig sind
Die Verwendung direkter Links zu Support-Artikeln (wie https://support.mozilla.org/en-US/kb/example-article) kann zu Problemen führen:
- Sie können leicht ungültig werden: Artikel-URLs ändern sich, wenn sich der Titel ändert, es sei denn, der Bearbeiter behält den Slug manuell bei.
- Sie sind nicht lokalisierbar: Direkte Links enthalten eine fest kodierte Sprache, was für internationale Nutzer nicht ideal ist.
- Sie sind schwieriger zu verwalten: Wir können sie nicht global aktualisieren, wenn sie direkt im Produkt verwendet werden.
Im Gegensatz dazu sind stabile Links:
- bleiben konsistent, auch wenn sich die Artikel-URL ändert
- erkennen automatisch die richtige Locale (Sprachversion)
- können bei Bedarf zentral umgeleitet oder aktualisiert werden
Linkformat für produktinterne Support-Artikel
Verwenden Sie ein standardisiertes Format, um stabile Support-Links für Desktop- und Mobilprodukte zu erstellen:
Hinweise:
-
%VERSION%,%OS%und%LOCALE%werden automatisch vom Produkt ausgefüllt. - Das SUMO-Team erstellt die Felder
<slug>und<product>. - Ersetzen Sie
<slug>durch den von Ihnen erstellten einzigartigen Slug.
Dieses Format stellt sicher, dass Nutzer zum richtigen lokalisierten Artikel weitergeleitet werden.
Beispiel:https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/recommendations-firefox-new-tab
So richten Sie einen stabilen, produktinternen Link in Kitsune ein
Um eine stabile Weiterleitung zu erstellen, folgen Sie diesen Schritten im Kitsune-Admin-Dashboard.
- Melden Sie sich im Kitsune-Admin-Dashboard an.
- Klicken Sie unter INPRODUCT auf Redirects.
- Klicken Sie oben rechts auf .
- Füllen Sie die erforderlichen Felder Product, Topic und Target aus, wie im nachstehenden Abschnitt Weiterleitungsfelder beschrieben.
- Klicken Sie auf .
- Teilen Sie den fertigen stabilen Link mit dem Entwickler oder Produktmanager und verwenden Sie dabei das produktinterne Format:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/<slug>
Weiterleitungsfelder
| Feld | Beschreibung |
|---|---|
| Product | Verwenden Sie firefox für Desktop oder mobile für Firefox-Mobilprodukte.
|
| Topic (Slug) |
Geben Sie eine kurze, eindeutige Kennung für den Artikel ein. Diese wird Teil des stabilen Links.
Hinweis: Der Slug muss nicht mit der tatsächlichen URL des Zielartikels übereinstimmen. Wählen Sie einen aussagekräftigen und für die Produktnutzung konsistenten Slug.
|
| Target |
Der Pfad zum Support-Artikel, zu dem Sie weiterleiten möchten. Geben Sie nur den Teil ab Beispiel:
Hinweis: Sie können einen Anker (z. B.
kb/customize-items-on-firefox-new-tab-page#w_weather) einfügen, um auf einen bestimmten Abschnitt zu verlinken. Anker funktionieren nur in der englischen Version und werden in anderen Locales (Sprachversionen) möglicherweise nicht aufgelöst. |
Tipps
- Stabile Links gewährleisten die Lokalisierung: Nutzer werden automatisch zu ihrer bevorzugten Sprache weitergeleitet, sofern diese verfügbar ist.
- Sie können stabile Weiterleitungen später über die Kitsune-Admin-Oberfläche aktualisieren oder löschen.
- Verwenden Sie diese Methode immer dann, wenn Sie von folgenden Stellen aus verlinken:
- „Mehr erfahren“-Nachrichten innerhalb des Produkts
- Onboarding-Prozessen
- Fehler- oder Warnmeldungen
- kontextbezogenen Hilfemodulen
