FastComments E-posta Şablonları, EJS şablon dili kullanır.

Değişkenleri yazdırmak için örnek sözdizimi <%= object.someValue %> şeklindedir ve koşullu ifadeler şu şekilde yapılabilir:

<% if (some_condition) { %>
    <div>Some content.</div>
<% } else { %>
    <div>Some other content.</div>
<% } %>

Yorum içeriği gibi ham HTML yazdırmak şu şekilde yapılır: <%- comment.commentHTML %>. Dikkat edin, - = yerine kullanılır.

Sözdizimi ile ilgili daha fazla belge için yukarıdaki bağlantıya bakın.

FastComments yerelleştirilmiş bir platformdur. Tüm widget'larımız, e-postalarımız ve bildirimlerimiz yerelleştirilmiştir.

Yerelleştirilmiş olması, kullanıcının konumuna ve tercih ettiği dile göre farklı bir dil ve biçimlendirme gösterdiğimiz anlamına gelir. Bunu kullanıcının tarayıcısının sağladığı bilgilere dayanarak belirleriz.

E-postadaki metni özelleştirmek için Translations sekmesine gidip bir Locale seçebilir ve metni düzenleyebilirsiniz. Varsayılandan farklı olan metin kullanıcı arayüzünde vurgulanır. İsterseniz yerel ayarlar arasında geçiş yapabilir ve sonunda kaydederek değişiklikleri kaybetmezsiniz.

Yerelleştirilmiş metne TEXT nesnesi üzerinden erişilir, örneğin: <%= TEXT.INTRO %>.

SSO Notu

SSO entegrasyonlarında, locale belirtilmemişse, kullanıcı farklı bir locale ile yorum bileşenine eriştiği her seferinde bu değer güncellenecektir. Bu, onların dil tercihinin otomatik olarak güncellendiği ve gelecek e-postaların o locale ile gönderileceği anlamına gelir.

Bu ayrıca SSO payload'unda locale sağlayarak elle de ayarlanabilir.

Şablonlar küresel olarak — söz konusu şablon türü için tüm tenantınızda — veya alan bazında (per-domain). Settings sekmesinde istediğiniz alanı seçin.

Aynı alan için birden fazla şablon oluşturursanız, çalışma zamanında yalnızca ilk şablon seçileceğini unutmayın. Şablonlar listesi bu durum oluştuğunda sizi uyarır.

Her şablon farklı bir bağlamda çalışır, yani mevcut veriler farklıdır.

Mevcut verilerin neler olduğunu hızlıca görmek için en pratik yol, şablona sağlanan test verilerini kontrol etmektir. Bu veriler şablon için sağlanmıştır. Bir şablonu düzenlerken, Test Data sekmesine tıklayarak bir JSON yapısını görebilirsiniz.

Ayrıca bu alanda test verilerini özelleştirerek şablonumuzun farklı durumlarda nasıl göründüğünü görebiliriz. Test verileri Reset düğmesiyle varsayılanlara sıfırlanabilir.

E-posta şablonları değişkenleri ve mantığı desteklediği için, render edilemeyen veya bazen render olmayan şablonlar oluşturmak mümkündür.

Bu, özellikle ara sıra ortaya çıkan bir sorun ise veya yalnızca veriler belirli bir şekilde olduğunda meydana geliyorsa, teşhis etmek ve hata ayıklamak açısından çok sinir bozucu olabilir.

Yardımcı olmak için, FastComments E-posta Şablonları birkaç özellikle gelir:

1. Şablon önizlemesi başarısız olursa, kaydedilemez. Bir hata mesajı gösterilir.
2. Şablon render hataları yönetici arayüzünde izlenir ve raporlanır.

İkinci madde, üretimde meydana gelen render hatalarını tanımlar. Yani, önizlemesi düzgün olan bir şablon oluşturursunuz - ancak daha sonra bir sebepten dolayı başarısız olur. Örneğin, şablonumuzda şunun gibi bir şey varsa:

<% if (comment.commenterEmail.includes('test') { %>

Bu, anonim yorum yapma etkinleştirilmişse bazen başarısız olabilir, çünkü e-posta her zaman mevcut olmayacaktır. Peki bunu nasıl öğreniriz?

Cevap, hataların iki yerde ortaya çıkarılmasıdır. İlk olarak, şablon listesinin kendisi her şablonla birlikte bir render hata sayısı gösterir.

Daha sonra, bir şablonu görüntülerken, şablonun render olamama sayısının her hata için bir sayısını görebiliriz.

Her hatanın ve onun sayısının yanında bir sıfırlama düğmesi bulunur, böylece bir sorunu çözdükten sonra sayacı sıfırlayabiliriz.

E-posta şablonlarını oluşturma ve düzenleme anında gerçekleşir. Bu, Save düğmesine bastığınız anda, platform o e-postanın en son sürümünü kullanmaya başlayacaktır.