Gem ubegrænset layout-historik på GitHub

Appen gemmer de 25 nyeste versioner af hvert e-mail-layout. Forbind med GitHub, så gemmes hver version også i et repository, du selv vælger, så din layout-historik er ubegrænset: Se, hvem der har ændret hvad, gendan enhver version, og opbevar en kopi af dine layouts uden for appen.

Forbind til GitHub

1. Åbn »Udvikler« og fanen »Forbindelser« i appen.
2. Klik på »Forbind GitHub« under GitHub. GitHub åbnes i en ny fane.
3. Installer appen på din GitHub-konto eller -organisation, og vælg, hvilke repositorier den må bruge. Det anbefales at bruge et privat repositorium. Hvis du ikke har et endnu, skal du først oprette det på github.com/new.
4. Gå tilbage til appen, vælg repositoriet under »Repository«, og klik på »Brug dette repository«.

Appen gemmer straks alle de layouts, du allerede har, i repositoriet og foretager derefter et commit for hver ny version, når du gemmer.

Hvad findes der i arkivet?

Der skal være én fil pr. layout i mappen »email-layouts«, opkaldt efter layoutets id, f.eks. »email-layouts/cmu3010yo01e4yn0wdjmh7xab.json«. Filen indeholder layoutets navn, emne, forhåndsvisningstekst, indhold eller visuelt design samt alle oversættelser. Hver gang der gemmes i appen - enten via API’en, ved hjælp af AI eller ved en gendannelse - udgør dette én commit med en besked som f.eks. »Update "Order confirmation" (editor, v12)«.

Når man sletter et layout i appen, slettes filen; de tidligere commits bevarer dog historikken.

Gendan en ældre version

Åbn layoutet, og klik på »Versionshistorik«. Under de nyeste versioner, der er gemt i appen, viser »Ældre versioner på GitHub« en liste over alle commit’er for layoutet. Klik på »Vis« for at få et eksempel på en version, og klik på »Gendan denne version« for at genindsætte den. Gendannelsen gemmes som en ny version, så den kan fortrydes.

Rediger et layout på GitHub

Rediger en layoutfil i arkivet, og commit den til den tilknyttede gren: appen opdaterer layoutet inden for få sekunder. Filen kontrolleres på samme måde som ved en gemning i appen: Liquid-koden skal være gyldig, links og farver skal være sikre, og filerne skal være uploadet til din butik. En fil, der ikke består kontrollen, ignoreres, og layoutet forbliver uændret.

En fil kan ikke oprette et nyt layout, og sletning af en fil sletter ikke et layout, så en fejlagtig commit ødelægger aldrig en e-mail, der er ved at blive sendt.

Afbryd forbindelsen

Udvikler > Forbindelser > GitHub > Afbryd forbindelse til GitHub fjerner forbindelsen og appens adgang. Repositoriet og dets historik forbliver på din GitHub-konto.

Via API’et

GET /api/v1/email-templates/:id/versions/github viser en liste over versionerne på GitHub, og POST /api/v1/email-templates/:id/versions/github/:sha/restore gendanner en af dem. MCP-værktøjerne findes på list_template_versions sammen med github: true og restore_template_github_version.