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.