E-mails en sjablonen

Tabbr verstuurt e-mails op twee manieren: met de hand, door wie mag e-mailen (E-mail versturen), en automatisch vanuit een script, met een sjabloon. Alles staat onder Instellingen › Messaging.

Instellingen

Instelling	Betekenis
E-mail actief	Zet het versturen aan of uit.
Standaard from adres bij e-mails	Het afzenderadres. Dit adres moet geverifieerd zijn om te kunnen versturen.
Override e-mail ontvangers	Om te testen: alle e-mails gaan tijdelijk naar de adressen die je opgeeft in plaats van naar de echte ontvangers.
Wie mag e-mails versturen?	Een filter op personen: wie het e-mailscherm krijgt.
Templates	De sjablonen (zie hieronder).
Pushberichten	Pushmeldingen aan- of uitzetten.

Veilig testen

Zet Override e-mail ontvangers aan met je eigen adres voor je een nieuwe automatische e-mail uitprobeert. Zo krijgt niemand per ongeluk een halve testmail.

Een sjabloon maken

1. Open Templates en klik op toevoegen.
2. Geef het een Naam — scripts verwijzen ernaar, bv. Aanmelding activiteit.
3. Vul het Onderwerp en de Inhoud in (met opmaak).
4. Kies de Voorkeur default: Opt-out, Opt-in of Altijd (zie hieronder).
5. Voeg de Variabelen toe die je in het onderwerp of de inhoud gebruikt.
6. Probeer het met Stuur een test e-mail en bewaar.

jouwclub.tabbr.be/admin/settings

Variabelen

Een variabele heeft een naam, een omschrijving en een Berekening: een script waarvan de laatste expressie de waarde is. Het record waarvoor de e-mail vertrekt, heet naar zijn entiteit (bv. signup). In het onderwerp en de inhoud zet je de variabele met <tabbr:var name="…"/>.

Onderwerp

Je bent aangemeld op <tabbr:var name="dag"/>

Variabele 'dag'

let date = new Date(signup.activity.date)
date.toLocaleDateString('nl-BE', { weekday: 'long', day: 'numeric', month: 'numeric', year: 'numeric' })

Variabele 'voornaam'

signup.owner.firstname

Een getal maak je op met format, bv. <tabbr:var name="saldo" format="#,##0.00"/>.

Voorkeur van de ontvanger

Voorkeur default	Wie krijgt de e-mail?
Opt-out	Iedereen, tenzij de ontvanger zich uitschrijft.
Opt-in	Alleen wie zich ervoor inschrijft.
Altijd	Iedereen; de ontvanger kan hem niet weigeren. Gebruik dit alleen voor wat echt moet (een betaling, een reservatie).

Leden kiezen hun voorkeuren op hun profiel (E-mail & Berichten) of via de link onderaan elke e-mail.

Versturen vanuit een script

In een hook op aanmeldingen

function onCreate() {
  sendEmailByTemplate('Aanmelding activiteit', signup.owner, signup)
}

Functie	Wat ze doet
sendEmailByTemplate(sjabloon, persoon, record?)	Naar een persoon, volgens zijn voorkeur. Het record vult de variabelen.
sendEmailByTemplateToExternalUser(sjabloon, naam, e-mail, record?)	Naar iemand zonder account, bv. een gast.
mailUtils.newMail()…send()	Een e-mail zonder sjabloon, volledig in het script — zie de script-referentie.

E-mails vertrekken pas nadat het bewaren gelukt is: mislukt het bewaren, dan vertrekt er niets.

Typische sjablonen

• welkomstmail — vanuit een actie op een nieuw lid;
• Aanmelding activiteit en Herinnering aanmelding — vanuit een hook en een job;
• Reservering initiatievlucht — voor een gast, met sendEmailByTemplateToExternalUser;
• ARC van toestel verloopt binnenkort — vanuit een job, naar de eigenaars;
• Aankoop via webshop — een bevestiging van een bestelling.