FastComments.com


Да би пружио кохерентније искуство вашој бази корисника, FastComments нуди решење за прилагођавање е-порука, тако да е-поруке које FastComments шаље вашим купцима могу одговарати вашем бренду.

У овој документацији покрићемо функције овог решења, језик шаблона, локализацију и још много тога.


Језик шаблона Internal Link

FastComments Email Templates користи EJS језик шаблона.

Пример синтаксе је <%= object.someValue %> за испис променљивих, а условне наредбе могу се писати на следећи начин:

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

Испис чистог HTML-а, као што је садржај коментара, ради се овако: <%- comment.commentHTML %>. Обратите пажњу на - уместо =.

Погледајте горе наведени линк за додатну документацију о синтакси.


Локализација и прилагођени текст Internal Link

FastComments је локализована платформа. Сви наши виџети, имејлови и обавештења су локализовани.

Локализација значи да приказујемо различит језик и форматирање у зависности од локације корисника и преферираног језика. Ово утврђујемо на основу информација које нам прегледач корисника пружа.

Текст у имејлу можемо прилагодити тако што ћемо отићи на картицу Translations, изабрати Locale и уредити текст. Текст који је промењен у односу на подразумевани биће означен у корисничком интерфејсу. Можете мењати локале и сачувати на крају, без губитка измена.

До локализованог текста се приступа преко објекта TEXT, на пример: <%= TEXT.INTRO %>.

Напомена о SSO

За SSO интеграције, ако није наведен locale, он ће се ажурирати сваки пут када корисник приступи виџету за коментаре са другом локалом. То значи да ће њихова преференција језика бити аутоматски ажурирана, и будући имејлови ће бити послати у тој локали.

Ово се такође може подесити ручно тако што ћете проследити locale у SSO payload-у.

Шаблони по домену Internal Link

Шаблони се могу подесити да буду глобални - у оквиру целог вашег тенанта за ту врсту шаблона, или по домену. У картици Settings изаберите жељени домен.

Имајте у виду да ако подесите више шаблона за исти домен, само први се бира у време извршавања. Листа шаблона ће вас упозорити када дође до ове ситуације.

Подаци и променљиве Internal Link

Сваки шаблон ради у другом контексту, што значи да су доступни различити подаци.

На први поглед, најлакши начин да видите које су информације доступне јесте да проверите тест податке обезбеђене за шаблон. При уређивању шаблона, кликните на картицу Test Data да бисте видели JSON структуру.

Такође можемо прилагодити тест податке у овом одељку, да бисмо видели како наш шаблон изгледа у различитим ситуацијама. Тест подаци се могу вратити на подразумеване вредности помоћу дугмета Reset.

Грешке при рендеровању Internal Link


Пошто имејл шаблони подржавају променљиве и логику, могуће је направити шаблоне који не успевају да се рендерују, или понекад не успевају да се рендерују.

Ово може бити јако фрустрирајуће за дијагностику и отклањање грешака, посебно ако је проблем интермитентан, или ако се јавља само када подаци изгледају на одређен начин.

Да би помогло, FastComments Email Templates има неколико функција:

  1. Ако шаблон не успе да се прегледа, он не може бити сачуван. Биће приказана порука о грешци.
  2. Неуспеси при рендеровању шаблона се прате и приказују у админ интерфејсу.

Друга тачка описује неуспехе при рендеровању који се дешавају у продукцији. Тако да, направите шаблон који се у прегледу правилно приказује - али касније из неког разлога не успева. На пример, ако у нашем шаблону имамо ово:

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

Ово понекад може пропасти ако је омогућено анонимно коментарисање, јер имејл неће увек бити доступан. Како да за то сазнамо?

Одговор је да се грешке приказују на два места. Прво, сама листа шаблона показује бројач грешака при рендеровању уз сваки шаблон.

Затим, када прегледамо шаблон можемо видети, за сваку грешку посебно, број пута колико шаблон није успео да се рендерује.

Дугме за ресетовање се налази поред сваке грешке, и њеног бројача, тако да можемо ресетовати бројач након што смо решили проблем.


Примена промена Internal Link

Креирање и уређивање шаблона е-поште се примењује одмах. То значи, чим притиснете дугме Save, платформа ће почети да користи најновију верзију те е-поште.