E-Mail-Vorlagen

Die Ressource keenauth_email_template verwaltet den veröffentlichten Inhalt einer anpassbaren E-Mail-Vorlage: eine Familie (zum Beispiel verify_email) in einer Sprache. Sie benötigt den Startup-Tarif oder höher (sonst 403 plan_feature_unavailable).

resource "keenauth_email_template" "verify" {
  family    = "verify_email"
  locale    = "en"
  subject   = "Confirm your email"
  html      = "<p>Confirm your email address: <a href=\"{{ link }}\">Confirm</a></p>"
  text_body = "Confirm your email address: {{ link }}"
  from_name = "Acme"
}

Attribut	Beschreibung
`family`, `locale`	Der Slot. Eine Änderung von einem der beiden verwaltet eine andere Vorlage.
`subject`	Liquid, Klartext, bis zu 200 Zeichen, ohne Zeilenumbrüche.
`html`	Liquid-HTML-Fragment, bis zu 256 KiB.
`text_body`	Liquid-Klartextkörper (erforderlich), bis zu 64 KiB.
`from_name`	Optionaler Anzeigename des Absenders, bis zu 64 Zeichen. Ist er nicht gesetzt, wird der Name der Anwendung oder der Umgebung verwendet.
`overwrite_pending_draft`	Optional, Standard ist `false`. Siehe unten.
`version`, `latest_version`	Nur lesbar. Die veröffentlichte Version und die neueste Version des Slots.

Der Server prüft den Inhalt beim Schreiben und erneut beim Veröffentlichen: Liquid-Sandbox, ausgeglichenes HTML, verbotene Konstrukte sowie das für die Familie erforderliche {{ link }} oder {{ code }} sowohl im HTML als auch im Textkörper.

Wie eine Änderung angewendet wird

PUT schreibt den Inhalt als neue Entwurfsversion. If-Match ist die neueste Version des Slots aus der letzten Lesung ("0" für einen Slot ohne Versionen).
POST …:publish veröffentlicht diese Version. Die vorherige Version wird archiviert und bleibt im Verlauf erhalten (die neuesten 50 Versionen plus die veröffentlichte Version werden aufbewahrt).

Die Ressource liest die veröffentlichte Version. Eine im Dashboard veröffentlichte oder zurückgesetzte Version erscheint beim nächsten plan als Abweichung.

Ausstehende Entwürfe

Ein Entwurf, der neuer ist als die veröffentlichte Version (im Dashboard gespeichert oder durch eine fehlgeschlagene Veröffentlichung hinterlassen), wird niemals stillschweigend überschrieben:

Ein Entwurf mit demselben Inhalt wie Ihre Konfiguration wird veröffentlicht, ohne eine weitere Version zu schreiben. Das wiederholt auch eine fehlgeschlagene Veröffentlichung.
Ein anderer Entwurf lässt die Änderung mit Pending email template draft fehlschlagen. Veröffentlichen oder prüfen Sie ihn im Dashboard, oder setzen Sie overwrite_pending_draft = true, um eine neuere Version darüber zu schreiben. Der alte Entwurf bleibt im Verlauf, kann aber nicht mehr veröffentlicht werden.
plan gibt eine Warnung aus, solange ein ausstehender Entwurf existiert.

Wenn zwischen plan und apply jemand die Vorlage ändert, antwortet die API mit 412, und nichts wird geändert. Führen Sie plan erneut aus.

Anlegen, Import und Löschen

Ein Anlegen übernimmt eine veröffentlichte Vorlage mit demselben Inhalt. Hat der Slot bereits eine veröffentlichte Vorlage mit anderem Inhalt, überschreibt der Provider sie nicht. Importieren Sie sie mit tofu import keenauth_email_template.verify verify_email/en und prüfen Sie den Plan.
Destroy entfernt nur die Ressource aus dem State. Die API kennt kein Löschen, daher bleiben die veröffentlichte Vorlage und ihr Verlauf unverändert. Die Rückkehr zur Systemstandardvorlage ist über die API nicht verfügbar. Um zu ändern, was versendet wird, bearbeiten Sie die Vorlage oder führen Sie keenauth email-templates rollback für eine frühere veröffentlichte Version aus.