FastComments.com

電子郵件範本

為了讓您的使用者基礎獲得更一致的體驗,FastComments 提供了 一套電子郵件自訂解決方案,讓由 FastComments 發送給您客戶的電子郵件 能夠符合您的品牌形象。

在本文件中,我們將說明此解決方案的功能、範本語言、本地化, 以及更多內容。

範本語言 Internal Link

FastComments 電子郵件範本使用 EJS 範本語言。

範例語法為 <%= object.someValue %> 用於輸出變數,條件敘述可以如下撰寫:

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

輸出原始 HTML(例如評論內容)可使用 <%- comment.commentHTML %>。注意這裡使用 - 而非 =。

有關語法的更多文件,請參考上方連結。

在地化與自訂文字 Internal Link

FastComments 是一個本地化的平台。我們所有的元件、電子郵件和通知都已本地化。

本地化意味著我們會根據使用者的位置和偏好的語言,顯示不同的語言和格式。我們根據使用者的瀏覽器提供的資訊來判斷這一點。

我們可以前往 Translations 分頁,選擇一個 Locale 並編輯文字,來自訂電子郵件中的文字。與預設值不同的文字會在 UI 中以框線標示。您可以在不同語系之間切換,最後再儲存,而不會遺失變更。

本地化文字可透過 TEXT 物件存取,例如:<%= TEXT.INTRO %>。

SSO 注意事項

對於 SSO 整合,如果未指定 locale,則每次使用者以不同的語系存取留言元件時,該語系都會被更新。這表示使用者的語言偏好會自動更新,未來的電子郵件將以該語系發送。

也可以透過在 SSO payload 中提供 locale 來手動設定。

依網域的範本 Internal Link

模板可以設定為全域 - 針對該模板類型跨整個租戶,或 按網域設定。在 Settings 標籤中選擇所需的網域。

請注意,如果你在同一個網域設置多個模板,執行時只會採用第一個。 在出現此情況時,模板列表會發出警告。

資料與變數 Internal Link

每個範本在不同的情境中運作,這表示可用的資料不同。

一個快速一目了然的方式來查看可用的資料,是檢查測試資料 為該範本所提供的。編輯範本時,點選 Test Data 分頁即可查看 JSON 結構。

我們也可以在此處自訂測試資料,以查看範本的呈現 在不同情境下。測試資料可以使用 Reset 按鈕重設回預設值。

渲染失敗 Internal Link

由於電子郵件範本支援變數與邏輯,可能會建立出 無法渲染或偶爾渲染失敗的範本。

這種問題在診斷與除錯時會非常令人沮喪,特別是當它是間歇性問題,或 僅在資料呈現特定狀況時才會發生。

為了協助,FastComments 電子郵件範本提供了幾個功能:

  1. 若範本預覽失敗,將無法儲存。並會顯示錯誤訊息。
  2. 範本渲染失敗會在管理介面中被追蹤並報告。

第二點是在描述發生於生產環境的渲染失敗。也就是說,你建立了一個預覽 正常的範本——但之後不知何故會失敗。例如,如果我們在範本中有這段:

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

如果我們啟用了匿名評論,這段有時會失敗,因為 email 並不總是可用。那我們要如何得知這個狀況呢?

答案是錯誤會在兩個地方被揭露。首先,範本清單本身 會在每個範本旁顯示一個渲染錯誤計數。

接著,當檢視範本時,我們可以看到每一個錯誤的計數,顯示該範本 已渲染失敗的次數。

每個錯誤及其計數旁邊都有一個重設按鈕, 以便在我們解決問題後重置計數器。

套用變更 Internal Link

建立與編輯電子郵件範本會立即生效。這表示,當您按下 Save 按鈕的那一刻, 平台就會開始使用該電子郵件的最新版本。