Om een meer samenhangende ervaring voor uw gebruikers te bieden, biedt FastComments een oplossing voor e-mailaanpassing zodat de e-mails die naar uw klanten worden gestuurd, door FastComments, kunnen aansluiten bij uw huisstijl.
In deze documentatie behandelen we de functies van deze oplossing, de sjabloontaal, lokalisatie, en meer.
Sjablonen maken 
Het beheerdersgedeelte voor het aanmaken van sjablonen is te vinden via Aanpassen -> E-mailsjablonen.
Hier zie je een lijst van de verschillende soorten e-mails die door het platform worden verzonden, met een beschrijving voor elk sjabloon waarin wordt uitgelegd wanneer het wordt gebruikt.
Bijvoorbeeld kunnen we de Commenter Comment Notification e-mail aanpassen, die Sent when a commenter has a reply to their comment.
Als je op Create Template klikt, worden wijzigingen niet onmiddellijk toegepast. Je kunt de editor
voor het standaardtemplate openen en met de preview spelen, en er is geen effect
totdat je op Save klikt.
Sjabloontaal
FastComments E-mailsjablonen gebruiken de EJS-sjabloontaal.
Voorbeeldsyntaxis is <%= object.someValue %> om variabelen weer te geven, en voorwaardelijke instructies kunnen als volgt worden geschreven:
<% if (some_condition) { %>
<div>Some content.</div>
<% } else { %>
<div>Some other content.</div>
<% } %>Ruwe HTML weergeven, bijvoorbeeld voor de inhoud van een opmerking, gebeurt als volgt: <%- comment.commentHTML %>. Let op het - in plaats van =.
Raadpleeg de bovenstaande link voor meer documentatie over de syntaxis.
Lokalisatie en aangepaste tekst
FastComments is een gelokaliseerd platform. Al onze widgets, e-mails en meldingen zijn gelokaliseerd.
Gelokaliseerd betekent dat we een andere taal, en opmaak, tonen, gebaseerd op de locatie van de gebruiker en de voorkeurstaal. We bepalen dit op basis van de informatie die de browser van de gebruiker ons verstrekt.
We kunnen de tekst in de e-mail aanpassen door naar het Translations tabblad te gaan, een Locale
te selecteren en de tekst te bewerken. Tekst die is gewijzigd ten opzichte van de standaard wordt in de UI omlijnd. Je mag
tussen locales wisselen en aan het einde opslaan, zonder wijzigingen te verliezen.
Gelokaliseerde tekst wordt benaderd via het TEXT object, bijvoorbeeld: <%= TEXT.INTRO %>.
SSO-opmerking
Voor SSO-integraties, als locale niet is opgegeven, wordt deze elke keer bijgewerkt wanneer de gebruiker
het commentaar-widget opent met een andere locale. Dit betekent dat hun taalvoorkeur
automatisch wordt bijgewerkt, en toekomstige e-mails in die locale worden verzonden.
Dit kan ook handmatig worden ingesteld door locale op te geven in de SSO-payload.
Sjablonen per domein
Templates kunnen worden ingesteld als globaal - over uw hele tenant voor dat type template, of
per-domein. In het tabblad Settings selecteer het gewenste domein.
Let op dat als u meerdere templates voor hetzelfde domein instelt, alleen de eerste tijdens runtime wordt gekozen. De lijst met templates waarschuwt u wanneer deze situatie zich voordoet.
Gegevens en variabelen
Elke template werkt binnen een andere context, wat betekent dat er andere gegevens beschikbaar zijn.
Een snelle manier om in één oogopslag te zien welke gegevens beschikbaar zijn is het controleren van de testgegevens
die voor de template zijn verstrekt. Wanneer je een template bewerkt, klik op het tabblad Test Data om
een JSON-structuur te zien.
We kunnen de testgegevens in dit gebied ook aanpassen, om te zien hoe onze template eruitziet
in verschillende situaties. De testgegevens kunnen met de knop Reset worden teruggezet naar de standaardinstelling.
Weergavefouten
Omdat e-mailsjablonen variabelen en logica ondersteunen, is het mogelijk sjablonen te maken die niet gerenderd worden, of soms niet gerenderd worden.
Dit kan erg frustrerend zijn om te diagnosticeren en te debuggen, vooral als het een intermitterend probleem is, of als het alleen voorkomt wanneer de gegevens er op een bepaalde manier uitzien.
Om te helpen, FastComments Email Templates heeft een paar functies:
- Als het sjabloon niet kan worden voorvertoond, kan het niet worden opgeslagen. Er wordt een foutmelding weergegeven.
- Renderfouten van sjablonen worden bijgehouden en gerapporteerd in de beheer-UI.
De tweede bullet beschrijft renderfouten die in productie optreden. Dat wil zeggen, je maakt een sjabloon dat in de voorbeeldweergave goed werkt - maar later om een of andere reden faalt. Bijvoorbeeld, als we dit in ons sjabloon hebben:
<% if (comment.commenterEmail.includes('test') { %>Dit kan soms falen als anoniem reageren is ingeschakeld, omdat e-mail niet altijd beschikbaar zal zijn. Dus hoe komen we daar achter?
Het antwoord is dat fouten op twee plaatsen worden weergegeven. Ten eerste toont de sjabloonlijst zelf een aantal renderfouten bij elk sjabloon.
Vervolgens, wanneer je een sjabloon bekijkt, zien we per fout een telling van het aantal keren dat het sjabloon niet kon worden gerenderd.
Een resetknop bevindt zich naast elke fout en de bijbehorende telling, zodat we de teller kunnen resetten nadat we het probleem hebben opgelost.
Wijzigingen toepassen
Het aanmaken en bewerken van e-mailsjablonen is onmiddellijk. Dit betekent, op het moment dat je op de knop Save drukt, het
platform zal beginnen met het gebruiken van de nieuwste versie van die e-mail.