Unbegrenzte Layout-Historie mit GitHub führen

Die App speichert die neuesten 25 Versionen jedes E-Mail-Layouts. Verbinden Sie GitHub, und jede Version wird zusätzlich in einem Repository Ihrer Wahl gespeichert - so ist Ihre Layout-Historie unbegrenzt: Sehen Sie, wer was geändert hat, stellen Sie jede Version wieder her und behalten Sie eine Kopie Ihrer Layouts außerhalb der App.

GitHub verbinden

1. Öffnen Sie in der App Developer und den Tab Connections.
2. Klicken Sie unter GitHub auf Connect GitHub. GitHub öffnet sich in einem neuen Tab.
3. Installieren Sie die App in Ihrem GitHub-Konto oder Ihrer Organisation und wählen Sie aus, welche Repositories sie verwenden darf. Ein privates Repository wird empfohlen. Falls Sie noch keines haben, erstellen Sie zunächst eines auf github.com/new.
4. Wählen Sie anschließend in der App das Repository unter Repository aus und klicken Sie auf Use this repository.

Die App schreibt sofort alle bereits vorhandenen Layouts in das Repository und committet danach jede neue Version, sobald Sie speichern.

Inhalt des Repositorys

Eine Datei pro Layout im Ordner email-layouts, benannt nach der ID des Layouts, zum Beispiel email-layouts/cmu3010yo01e4yn0wdjmh7xab.json. Sie enthält den Namen, den Betreff, den Vorschautext, den Inhalt bzw. das visuelle Design des Layouts sowie alle Übersetzungen. Jedes Speichern in der App, über die API, durch KI oder durch eine Wiederherstellung erzeugt einen Commit mit einer Nachricht wie Update "Order confirmation" (editor, v12).

Löschen Sie ein Layout in der App, wird auch die zugehörige Datei gelöscht; die vorherigen Commits behalten die Historie.

Eine ältere Version wiederherstellen

Öffnen Sie das Layout und klicken Sie auf Version history. Unterhalb der neuesten, in der App gespeicherten Versionen listet Older versions on GitHub jeden Commit des Layouts auf. Klicken Sie auf View, um eine Version in der Vorschau anzuzeigen, und auf Restore this version, um sie wiederherzustellen. Die Wiederherstellung wird als neue Version gespeichert und kann daher rückgängig gemacht werden.

Ein Layout in GitHub bearbeiten

Ändern Sie die Datei eines Layouts im Repository und committen Sie sie in den verbundenen Branch: Die App aktualisiert das Layout innerhalb von Sekunden. Die Datei wird wie beim Speichern in der App geprüft: Liquid muss gültig sein, Links und Farben müssen sicher sein, und Dateien müssen in Ihren Store hochgeladen sein. Eine Datei, die die Prüfung nicht besteht, wird ignoriert, und das Layout bleibt unverändert.

Eine Datei kann kein neues Layout erstellen, und das Löschen einer Datei löscht kein Layout - ein fehlerhafter Commit kann also niemals eine E-Mail beschädigen, die gerade versendet wird.

Verbindung trennen

Developer > Connections > GitHub > Disconnect GitHub entfernt die Verbindung und den Zugriff der App. Das Repository und seine Historie bleiben in Ihrem GitHub-Konto erhalten.

Über die API

GET /api/v1/email-templates/:id/versions/github listet die Versionen auf GitHub auf, und POST /api/v1/email-templates/:id/versions/github/:sha/restore stellt eine davon wieder her. Die MCP-Tools sind list_template_versions mit github: true und restore_template_github_version.