Conservate una cronologia illimitata dei layout su GitHub

L'app conserva le ultime 25 versioni di ogni layout di email. Collegando GitHub, ogni versione viene salvata anche in un repository di vostra scelta, così la cronologia dei vostri layout è illimitata: potete vedere chi ha apportato quali modifiche, ripristinare qualsiasi versione e conservare una copia dei vostri layout al di fuori dell'app.

Collegare GitHub

1. Nell'app, apra la sezione "Sviluppatore" e la scheda "Connessioni".
2. Sotto GitHub, faccia clic su “Connetti GitHub”. GitHub si aprirà in una nuova scheda.
3. Installi l'app sul Suo account GitHub o sulla Sua organizzazione e scelga quali repository possa utilizzare. Si consiglia di utilizzare un repository privato. Se non ne possiede ancora uno, lo crei prima su github.com/new.
4. Una volta tornati nell'app, selezionate il repository nella sezione "Repository" e fate clic su "Utilizza questo repository".

L'app salva immediatamente nel repository tutti i layout già in vostro possesso, quindi esegue il commit di ogni nuova versione non appena salvate.

Cosa contiene il repository

Un file per ogni layout nella cartella email-layouts, denominato in base all’ID del layout; ad esempio, email-layouts/cmu3010yo01e4yn0wdjmh7xab.json. Il file contiene il nome del layout, l’oggetto, il testo di anteprima, il contenuto o il design visivo e tutte le traduzioni. Ogni salvataggio effettuato nell’app, tramite l’API, dall’intelligenza artificiale o tramite un ripristino, costituisce un commit con un messaggio del tipo Update "Order confirmation" (editor, v12).

L'eliminazione di un layout nell'app comporta la cancellazione del relativo file; i commit precedenti ne conservano la cronologia.

Ripristinare una versione precedente

Apra il layout e faccia clic su “Cronologia delle versioni”. Sotto le versioni più recenti conservate nell’app, la sezione “Versioni precedenti su GitHub” elenca tutti i commit del layout. Faccia clic su “Visualizza” per visualizzarne un’anteprima e su “Ripristina questa versione” per ripristinarla. Il ripristino viene salvato come nuova versione, pertanto è possibile annullarlo.

Modificare un layout su GitHub

Modifichi un file del layout nel repository e lo salvi nel ramo collegato: l'app aggiorna il layout in pochi secondi. Il file viene verificato come se fosse stato salvato nell'app: il codice Liquid deve essere valido, i link e i colori devono essere corretti e i file devono essere caricati sul Suo negozio. Un file che non supera la verifica viene ignorato e il layout rimane invariato.

Un file non può creare un nuovo layout e l'eliminazione di un file non comporta l'eliminazione di un layout; pertanto, un commit errato non compromette mai l'invio di un'e-mail già in corso.

Disconnettersi

Sviluppatore > Connessioni > GitHub > Disconnetti GitHub: questa operazione elimina la connessione e revoca l'accesso all'app. Il repository e la sua cronologia rimangono nel Suo account GitHub.

Tramite l'API

GET /api/v1/email-templates/:id/versions/github elenca le versioni su GitHub, mentre POST /api/v1/email-templates/:id/versions/github/:sha/restore ne ripristina una. Gli strumenti MCP sono disponibili all'indirizzo list_template_versions, insieme a github: true e restore_template_github_version.