URL's in Zendesk Help Center automatisch naar kleine letters forceren

Jordy Veldhuis
Jordy Veldhuis
  • Bijgewerkt

Wanneer je artikelen publiceert in het Zendesk Help Center, kunnen URL's soms hoofdletters bevatten. Hoewel dit technisch gezien werkt, is het voor SEO, consistentie en deelbaarheid vaak beter om altijd kleine letters (lowercase) te gebruiken.

Met onderstaande JavaScript wordt de URL van een helpcenter-artikel automatisch omgezet naar kleine letters, zonder dat de pagina opnieuw wordt geladen.

Waarom URL's in kleine letters gebruiken?

Het gebruik van uitsluitend kleine letters in URL's heeft verschillende voordelen:

  • Consistente en nette URL-structuur
  • Minder kans op dubbele URL-varianten
  • Betere leesbaarheid voor bezoekers
  • Voorkomt problemen wanneer URL's handmatig worden gedeeld of gekopieerd
  • Draagt bij aan een overzichtelijkere SEO-structuur

Let op: deze oplossing past alleen de URL in de adresbalk aan. De pagina wordt niet opnieuw geladen en de oorspronkelijke URL blijft gewoon werken.

JavaScript om URL's naar lowercase te forceren

Plaats onderstaande code in de JavaScript van je Zendesk Guide-thema.

// Geforceerd kleine letters (lowercase) voor artikel-URL's
(function() {

  if (window.location.pathname.includes('/articles/')) {

    var currentPath = window.location.pathname;

    if (currentPath !== currentPath.toLowerCase()) {

      // Verander de URL in de adresbalk geruisloos naar kleine letters,
      // inclusief zoekparameters en hashtags
      var newUrl = currentPath.toLowerCase() + window.location.search + window.location.hash;

      window.history.replaceState(null, null, newUrl);

    }

  }

})();

Waar plaats je deze code?

  1. Open Zendesk Guide.
  2. Ga naar Guide Admin.
  3. Open het actieve thema.
  4. Kies Code bewerken.
  5. Open het bestand script.js of document_head.hbs, afhankelijk van waar je eigen JavaScript beheert.
  6. Plak de code onderaan het bestand.
  7. Publiceer het thema.

Hoe werkt deze oplossing?

De code controleert of de huidige pagina een artikelpagina is (/articles/).

Vervolgens wordt gecontroleerd of de URL hoofdletters bevat. Is dat het geval, dan wordt alleen de URL in de browser aangepast naar kleine letters met behulp van:

window.history.replaceState()

Hierdoor:

  • wordt de pagina niet opnieuw geladen;
  • blijven eventuele queryparameters (?) behouden;
  • blijven ankers (#) behouden;
  • ziet de bezoeker altijd een nette lowercase URL.

Heeft dit invloed op SEO?

Deze oplossing is vooral bedoeld voor consistentie van de weergegeven URL.

Omdat alleen de browsergeschiedenis wordt aangepast, verandert de daadwerkelijke route van Zendesk niet. Voor de meeste Help Centers is dit voldoende om bezoekers altijd een uniforme URL te tonen.

Wil je volledige canonicalisatie voor zoekmachines, dan zul je daarnaast ook moeten controleren hoe Zendesk de canonical URL van artikelen genereert.