E-mail sablonok

A plugin a kommunikációhoz email sablonokat használ, amelyben lehetőség van több nyelvi sablon egyidejű használatára. Ezek közül azt tölti be, amelyik az aktuális nyelvnek megfelelő.

Az email sablonokat a plugin elsőként az oldal által használt (child) témában, a book-an-appointment/emails/<nyelv>/ mappában keresi. Ha itt megtalálható, akkor innen fogja használni, ha pedig nem, akkor a plugin mappájában a templates/emails/<nyelv>/ mappában keresi a sablont.

Figyelem! Egy esetleges frissítés, a plugin mappájában lévő (esetleg módosított) sablont felül fogja írni. Célszerű a plugin mappájából a (child) téma „book-an-appointment” mappájába átmásolni a sablonokat, majd azokat szerkeszteni a kívánt módon.

A sablonok alapvetően HTML formátumú állományok, amelyekben a változók egyszerű behelyettesítésévél hozza létre a plugin az email tartalmát. Azonban van lehetőség a sablonokban némi vezérlésre:

• <!-- include [fájl_neve_és_kiterjesztése] -->
  A hivatkozás helyére – ugyanabból a mappából – a fájl_neve_és_kiterjesztése fájlt tölti be. (Az alapértelmezett sablonban a levél fejléce és lábléce van ilyen módon beolvasva.)

• <!-- if phone -->
  	Ha létezik a phone változó és annak értéke nem üres
  <!-- else phone -->
  	egyébként
  <!-- endif phone -->

A sablon működés közben egyszerűen kicseréli a hivatkozott tartalmat a változó értékére.
Pl.: <input name="phone" value="(10) 555-1234" /> esetében a az alábbi sablon részlet:
<div>Az Ön telefonszáma: <!-- phone --></div> az alábbiakat írja a sablonba:
<div>Az Ön telefonszáma: (10) 555-1234</div>

Ha a változó értéke tömb, akkor a helyére nem a tömb értékét írja be, hanem a változó_neve.html sablont tölti be ugyanabból a mappából és abban helyettesíti be minden elemre a tömb értékeit. (Az alapértelmezett sablonban pl. a days változó viselkedik így.)

Sablonok és használatuk

• header.html – Email fejléce
• footer.html – Email lábléce
• confirmation-user.html – Foglalás megerősítése felhasználó által
• confirmation-info-admin.html – Értesítés adminisztrátor számára, megerősített foglalásról
• accept-admin.html – Foglalás adminisztrátor általi visszaigazolása
• cancelled-from-user.html – Értesítés adminisztrátor számára, felhasználó által törölt foglalásról
• cancelled-admin.html – Értesítés felhasználó számára, adminisztrátor által törölt foglalásról
• event.html – Email mellékleteként küldött ICS fájl sablonja

A sablonokban használható, alapértelmezett hivatkozások, az alapértelmezett sablonokban láthatóak.