Speichern Sie einen unbegrenzten Layout-Verlauf auf GitHub

Die App speichert die 25 neuesten Versionen jedes E-Mail-Layouts. Verbinden Sie GitHub, und jede Version wird zusätzlich in einem Repository Ihrer Wahl gespeichert, sodass Ihr Layout-Verlauf unbegrenzt ist: Sehen Sie nach, wer welche Änderungen vorgenommen hat, stellen Sie jede beliebige Version wieder her und bewahren Sie eine Kopie Ihrer Layouts außerhalb der App auf.

GitHub verbinden

1. Öffnen Sie in der App den Bereich „Entwickler“ und anschließend die Registerkarte „Verbindungen“.
2. Klicken Sie unter „GitHub“ auf „GitHub verbinden“. GitHub wird in einem neuen Tab geöffnet.
3. Installieren Sie die App in Ihrem GitHub-Konto oder Ihrer Organisation und wählen Sie aus, auf welche Repositorys sie zugreifen darf. Es wird ein privates Repository empfohlen. Falls Sie noch keines haben, erstellen Sie es bitte zunächst unter , github.com/new oder.
4. Kehren Sie zur App zurück, wählen Sie unter „Repository“ das gewünschte Repository aus und klicken Sie auf „Dieses Repository verwenden“.

Die App speichert jedes Ihrer bestehenden Layouts sofort im Repository und führt anschließend bei jedem Speichervorgang ein Commit für die jeweilige neue Version durch.

Was befindet sich im Repository?

Pro Layout befindet sich eine Datei im Ordner email-layouts, die nach der ID des Layouts benannt ist, zum Beispiel email-layouts/cmu3010yo01e4yn0wdjmh7xab.json. Diese Datei enthält den Namen des Layouts, das Thema, den Vorschautext, den Inhalt oder das visuelle Design sowie alle Übersetzungen. Jedes Speichern in der App - sei es über die API, durch die KI oder durch eine Wiederherstellung - entspricht einem Commit mit einer Meldung wie beispielsweise Update "Order confirmation" (editor, v12).

Wenn Sie ein Layout in der App löschen, wird die zugehörige Datei gelöscht; die früheren Commits bleiben jedoch erhalten.

Eine ältere Version wiederherstellen

Öffnen Sie das Layout und klicken Sie auf „Versionsverlauf“. Unterhalb der neuesten in der App gespeicherten Versionen werden unter „Ältere Versionen auf GitHub“ alle Commits des Layouts aufgelistet. Klicken Sie auf „Anzeigen“, um eine Vorschau einer Version anzuzeigen, oder auf** „Diese Version wiederherstellen“**, um sie wiederherzustellen. Die Wiederherstellung wird als neue Version gespeichert, sodass sie rückgängig gemacht werden kann.

Ein Layout in GitHub bearbeiten

Ändern Sie die Layout-Datei im Repository und führen Sie ein Commit in den verbundenen Zweig durch: Die App aktualisiert das Layout innerhalb von Sekunden. Die Datei wird wie bei einem Speichervorgang in der App überprüft: Liquid muss gültig sein, Links und Farben müssen korrekt sein und die Dateien müssen in Ihren Shop hochgeladen sein. Eine Datei, die die Überprüfung nicht besteht, wird ignoriert, und das Layout bleibt unverändert.

Eine Datei kann kein neues Layout erstellen, und das Löschen einer Datei führt nicht zum Löschen eines Layouts; daher führt ein versehentliches Commit niemals dazu, dass eine E-Mail, die gerade versendet wird, beschädigt wird.

Trennen

Entwickler > Verbindungen > GitHub > Verbindung zu GitHub trennen: Dadurch wird die Verbindung getrennt und der Zugriff der App aufgehoben. Das Repository und dessen Historie verbleiben in Ihrem GitHub-Konto.

Über die API

GET /api/v1/email-templates/:id/versions/github Auf GitHub sind die Versionen aufgelistet, und unter POST /api/v1/email-templates/:id/versions/github/:sha/restore lässt sich eine davon wiederherstellen. Die MCP-Tools finden Sie unter list_template_versions sowie unter github: true und restore_template_github_version.