Een handleiding voor het verwijzen naar ondersteuningsartikelen

Contributors Contributors Laatst bijgewerkt: 3 weken, 6 dagen ago

Het doorverwijzen naar Mozilla Support-artikelen is cruciaal voor het geven van directe toegang naar de benodigde hulp aan onze gebruikers. Er zijn twee primaire manieren om deze doorverwijzingen te maken, en de methode die u kiest hangt af van waarvandaan u verwijst. Deze handleiding leidt u door beide methodes, om ervoor te zorgen dat u effectief kunt doorverwijzen, waardoor u gebruikers helpt naadloos de juiste ondersteuningsinhoud te vinden.

In-product-koppelingen naar SUMO

Voor koppelingen die binnen de browserinterface van Firefox of Firefox voor Android worden geplaatst, dient u een specifieke URL-structuur te gebruiken. Deze structuur stelt het CX Content Team in staat om het doel van de koppeling aan te passen zonder functionaliteit in Firefox te verstoren. We hebben specifieke doelen vastgesteld voor diverse onderwerpen, waardoor we gebruikers door kunnen sturen naar de meest relevante artikelen op basis van factoren zoals hun besturingssysteem of Firefox-versie. Deze flexibiliteit betekent dat updates of wijzigingen rechtstreeks in Kitsune kunnen worden aangebracht, zonder de noodzaak om wijzigingen in de code van Firefox aan te brengen.

Hieronder vindt u de opmaak voor het maken van in-product-koppelingen naar SUMO-artikelen:

https://support.mozilla.org/1/firefox/%VERSION%/%OS%/%LOCALE%/TOPIC

Noot: de secties %VERSION%/%OS%/%LOCALE%/ zijn plaatshouders. Engineers zijn ervoor verantwoordelijk deze dynamisch te vullen in de broncode.

Voorbeeld:

https://support.mozilla.org/1/firefox/13.0a2/Darwin/nl/prefs-privacy

In deze structuur:

  • verwijst %VERSION% naar de Firefox-versie.
  • stelt %OS% het besturingssysteem van de gebruiker voor.
  • specificeert %LOCALE% de taal- en regio-instellingen van de gebruiker.
  • beschrijft TOPIC het onderwerp van het ondersteuningsartikel, en dit kan elk tekstfragment zijn.

Koppelingen specifiek voor Firefox voor Android dienen /1/mobile in de URL te bevatten om deze te onderscheiden van koppelingen die zijn bedoeld voor de desktopversie.

Noot: als een SUMO-plaatshouder wordt aangemaakt om een in-product-koppeling te testen, dient de plaatshouder te zijn gepubliceerd en bewaard onder administration om deze correct te laten werken. Als de inhoud eenmaal voltooid is en klaar is om te worden gepubliceerd, dient het artikel uit administration te worden verplaatst om deze zichtbaar voor eindgebruikers te maken.
Het aanmaken van in-product-koppelingen dient te worden gecoördineerd via een Content Request Bugzilla-ticket, die wordt beheerd door het CX Content Team. Probeer niet zelf deze koppelingen handmatig aan te maken, aangezien ze in Kitsune moeten worden ingesteld voordat ze goed kunnen werken.

Vermijd doorverwijzingen naar ankers

Doorverwijzingen naar specifieke ankers binnen artikelen zijn kwetsbaar en kunnen eenvoudig defect raken als de paginastructuur wijzigt. Verwijs, om verbroken koppelingen te vermijden, altijd naar de hoofdpagina van het artikel. Dit zorgt ervoor dat uw koppeling geldig blijft en gebruikers de benodigde informatie kunnen benaderen, ongeacht updates van de interne secties van het artikel.

Webeigenschapkoppelingen naar SUMO

Als u koppelingen maakt vanuit webeigenschappen buiten Firefox, laat dan het locale-deel van de URL weg. Hierdoor kan het SUMO-systeem automatisch de taal detecteren en de gebruiker doorsturen naar de juiste taalversie van het artikel, op basis van hun browserinstellingen.

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-release
  • Gebruik niet https://support.mozilla.org/en-US/kb/update-firefox-latest-release

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

Een ingekorte mzl.la-koppeling aanmaken

Lees How to obtain a shortened mzl.la link om te zien hoe u een ingekorte mzl.la-koppeling aanmaakt.

Vragen?

Als u een in-product-koppeling wilt instellen, vul dan een Content Request Bugzilla-ticket in. U kunt vragen stellen in deze ondersteuningsdiscussie.

Meer info

Deze aardige mensen hebben geholpen bij het schrijven van dit artikel:

Illustration of hands

Vrijwilliger worden

Laat uw expertise groeien en deel deze met anderen. Beantwoord vragen en verbeter onze kennisbank.

Meer info