Automatische Sicherung von Squarespace Code-Injektionen auf GitHub - n8n-Workflow

Squarespace-Entwickler und Designer, die auf benutzerdefinierte Code-Injektionen angewiesen sind.
Benutzer, die eine Versionskontrolle für kritische Website-Konfigurationen benötigen.
Jeder, der eine zuverlässige, automatisierte Notfallwiederherstellung für seinen Website-Code sucht.
n8n Power-User, die nach fortgeschrittenen Beispielen für die Verwendung des n8n-Knoten-Frameworks mit benutzerdefinierten Skripten suchen.

Die Pflege benutzerdefinierter Code-Injektionen auf Plattformen wie Squarespace ist zwar entscheidend, aber diesen Änderungen fehlt es oft an nativer Versionskontrolle, was bei Updates oder Website-Migrationen ein Risiko darstellt. Dieser leistungsstarke n8n-Workflow löst dieses Problem, indem er eine geplante, automatisierte Backup-Lösung direkt nach GitHub bereitstellt. Diese spezielle n8n-Vorlage verwendet HTTP-Anfragen, um den relevanten Code abzurufen, und benutzerdefinierte n8n-Knoten-Skripte (Cheerio), um die HTML-Daten akribisch zu bereinigen und sicherzustellen, dass nur Ihr injizierter Code und nicht der Standard-Code der Plattform gespeichert wird. Durch die Einrichtung dieses n8n-Workflows erhalten Sie die Gewissheit, dass Ihre benutzerdefinierten Header und Footer alle zwei Stunden über einen zuverlässigen n8n-Trigger sicher gespeichert und versionskontrolliert werden.

Diese Automatisierung beginnt mit einem geplanten n8n-Trigger, der so konfiguriert ist, dass er alle zwei Stunden ausgeführt wird. Alternativ kann er manuell über den n8n-Knoten 'On clicking execute' (Bei Ausführung klicken) gestartet werden.

1. Datenabruf: Der n8n-Knoten Get Squarespace data (Squarespace-Daten abrufen) (eine HTTP-Anfrage) fragt die angegebene Squarespace-URL im Format page-context ab, um die aktuelle Website-Konfiguration einschließlich der Injektionspunkte für Header und Footer abzurufen.


2. Datenaufteilung & Metadaten: Die Daten werden mithilfe von 'Set'-n8n-Knoten (Get Header Injection und Get Footer Injection) in zwei Streams aufgeteilt: einen für Header und einen für Footer. Diese Knoten extrahieren und setzen auch wichtige Metadaten wie den Domainnamen und einen Zeitstempel.


3. Code-Bereinigung: Die n8n-Knoten Clean up Footers (Footer bereinigen) und Clean up Headers (Header bereinigen) verwenden benutzerdefinierte JavaScripts mit Cheerio, um Standard-Framework-Elemente von Squarespace zu entfernen und nur den wirklich benutzerdefinierten, injizierten Code zu isolieren.


4. Vorbereitung für GitHub: Der n8n-Knoten Merge Injections (Injektionen zusammenführen) führt die beiden bereinigten Elemente (Header-Daten und Footer-Daten) wieder zusammen. Der Globals-n8n-Knoten wendet dann die benutzerdefinierten GitHub-Repository-Einstellungen (Owner, Name, Pfad) an.


5. GitHub-Speicherung: Der n8n-Knoten Loop Over Items (Über Elemente iterieren) verarbeitet die Header- und Footer-Daten einzeln. Der erste GitHub-n8n-Knoten (Edit Injection data) versucht, die vorhandene Datei zu aktualisieren. Wenn dieser Vorgang fehlschlägt (was passiert, wenn die Datei noch nicht existiert, was durch den If-n8n-Knoten anhand eines 'nicht gefunden'-Fehlers überprüft wird), wird der Ablauf zum n8n-Knoten Create Injection data geleitet, um sicherzustellen, dass die Datei erstmalig erstellt wird. Diese bedingte Logik garantiert entweder ein Update oder eine Erstellung und erhält so eine konsistente Backup-Historie.

Um diesen n8n-Workflow effektiv bereitzustellen, gehen Sie wie folgt vor:

1. Importieren: Kopieren Sie die bereitgestellte n8n-Workflow-JSON und fügen Sie sie in Ihre n8n-Instanz ein.


2. Squarespace-URL: Suchen Sie den n8n-Knoten Get Squarespace data und aktualisieren Sie den URL-Parameter auf die Hauptdomain Ihrer Squarespace-Seite.


3. GitHub-Anmeldeinformationen: Konfigurieren Sie die GitHub-API-Anmeldeinformationen, die von den n8n-Knoten Edit Injection data und Create Injection data benötigt werden. Dies erfordert ein Persönliches Zugriffstoken (Personal Access Token) mit Schreibberechtigungen für das Repository.


4. Repository-Pfad definieren: Öffnen Sie den Globals-n8n-Knoten und aktualisieren Sie die folgenden Einstellungen:

1. Aktivieren: Stellen Sie sicher, dass der Schedule Trigger (Zeitplan-Auslöser) aktiv ist, um automatische Backups zu ermöglichen.

Dieser fortgeschrittene n8n-Workflow stützt sich auf mehrere spezifische n8n-Knotentypen:

Schedule Trigger (Zeitplan-Trigger): Dient als primärer n8n-Auslöser und initiiert den Backup-Prozess alle zwei Stunden. Ein hochzuverlässiger n8n-Knoten für wiederkehrende Aufgaben.
HTTP Request (HTTP-Anfrage) (Get Squarespace data): Ruft die Rohdaten des Squarespace-Seitenkontexts ab. Wichtige Konfiguration: Verwendet den Abfrageparameter ?format=page-context.
Set (Setzen) (Get Header/Footer Injection & Globals): Hauptsächlich für die Datenmanipulation verwendet. Die Injection-Knoten extrahieren den Rohinhalt und erstellen unterstützende Metadaten (ID, Domain). Der Globals-n8n-Knoten zentralisiert die GitHub-Konfigurationsdetails.
Code (Code) (Clean up Footers/Headers): Entscheidend für die Datenhygiene. Diese benutzerdefinierten Skript-Implementierungen im n8n-Knoten verwenden die cheerio-Bibliothek, um den von Squarespace hinzugefügten Standard-Code zu parsen und nur den benutzerdefinierten, injizierten Code zu isolieren.
Merge (Zusammenführen): Kombiniert die separaten Header- und Footer-Datenstreams wieder zu einem einzigen Eingabestrom für die weitere Verarbeitung.
Loop Over Items (Über Elemente iterieren) (Split In Batches): Stellt sicher, dass die Header- und Footer-Datei sequenziell und unabhängig voneinander vom GitHub-n8n-Knoten verarbeitet werden.

• GitHub (Edit/Create Injection data) (GitHub (Injektionsdaten bearbeiten/erstellen)): Kümmert sich um die eigentliche Speicherung. Die Edit-Operation versucht, die Datei zu aktualisieren; wenn dies fehlschlägt, leitet die If-n8n-Knoten die Ausführung zur Create-Operation weiter, was eine nahtlose Versionskontrolle im GitHub-Repository ermöglicht.