Er zijn twee manieren om naar Mozilla Support-artikelen te verwijzen. Welke methode u gebruikt hangt af van waarvandaan u verwijst. Als dit vanuit de chrome van Firefox of Firefox voor Android is, zult u de “in-product”-methode willen gebruiken. Als u vanaf een webtoepassing verwijst, gebruikt u de URL minus de locale-string. Ze werken als volgt.
Inhoudsopgave
In-product-koppelingen naar SUMO aanmaken
Doelen voor knoppen of koppelingen binnen de browserchrome dienen dit patroon te volgen:
https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC
Voorbeelden:
- https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/prefs-privacy
- https://support.mozilla.org/1/firefox/13.0a2/Darwin/en-US/36eol
Het laatste gedeelte van de URL, het onderwerp, kan een willekeurige string zijn.
Koppelingen vanuit Firefox voor Android dienen /1/mobile
te gebruiken om het product te onderscheiden.
De tuple (product, versie, os, locale, onderwerp) bepaalt waar de gebruiker daadwerkelijk naartoe gaat. Hierdoor kan het SUMO-team het doel van de knop Help wijzigen zonder dat koppelingen/knoppen in Firefox niet meer werken. We hebben specifieke doelen voor alle onderwerpwaarden, en soms kunnen we gebruikers van OS X of Windows ten behoeve van de meest relevante artikelen uitsplitsen, of die met oude/specifieke versies van Firefox, etc.
Verwijzen naar SUMO vanaf een webtoepassing
Als deze inhoud via het web wordt aangeboden en niet met de browser wordt geleverd, hoeft u de in-product-koppelingen niet te gebruiken (en zou u dat niet moeten doen).
Alles wat u moet doen is de URL gebruiken zonder de locale-string. SUMO zal de gebruiker automatisch naar de versie van de pagina in de eigen taal sturen.
Dus, als voorbeeld, om naar het artikel Firefox bijwerken naar de meest recente versie te verwijzen:
Gebruik
- https://support.mozilla.org/kb/update-firefox-latest-version
Gebruik geen
- https://support.mozilla.org/en-US/kb/update-firefox-latest-version
Verwijzen vanaf een andere locatie
Als u niet vanuit Firefox of een website verwijst (misschien een app, product, e-mail etc.), wilt u waarschijnlijk de URL (zonder de locale-string) gebruiken en de bron identificeren.
Voorbeeld:
- https://support.mozilla.org/kb/update-firefox-latest-version?utm_source=naamvanbron
Vragen?
Als u vragen hebt of het uiteindelijke doel van de in-product-koppeling moet instellen, neem dan contact op met Michael Verdi - mverdi at mozilla.com of verdi op IRC.