Sauvegarde automatique des injections de code Squarespace vers GitHub - Workflow n8n

Développeurs et concepteurs Squarespace qui dépendent des injections de code personnalisées.
Utilisateurs ayant besoin d'un contrôle de version pour les configurations critiques du site.
Toute personne recherchant une reprise après sinistre fiable et automatisée pour le code de son site.
Utilisateurs experts de n8n à la recherche d'exemples avancés d'utilisation du framework de nœuds n8n avec du script personnalisé.

La maintenance des injections de code personnalisées sur des plateformes comme Squarespace est essentielle, mais ces modifications manquent souvent de contrôle de version natif, ce qui pose un risque lors des mises à jour ou des migrations de site. Ce puissant workflow n8n résout ce problème en offrant une solution de sauvegarde automatisée et planifiée directement vers GitHub. Ce modèle n8n spécifique utilise des requêtes HTTP pour extraire le code pertinent, et un script de nœud n8n personnalisé (Cheerio) pour nettoyer méticuleusement les données HTML, garantissant que seul votre code injecté, et non la structure par défaut de la plateforme, est enregistré. En configurant ce workflow n8n, vous aurez l'esprit tranquille sachant que vos en-têtes et pieds de page personnalisés sont stockés en toute sécurité et versionnés toutes les deux heures via un déclencheur n8n fiable.

Cette automatisation commence par un déclencheur n8n planifié, configuré pour s'exécuter toutes les deux heures. Alternativement, elle peut être lancée manuellement via le nœud n8n « On clicking execute » (Lors du clic sur exécuter).

1. Récupération des données : Le nœud n8n Get Squarespace data (Requête HTTP) interroge l'URL Squarespace spécifiée en utilisant le format page-context pour récupérer la configuration actuelle du site, y compris les points d'injection d'en-tête et de pied de page.


2. Séparation des données et métadonnées : Les données sont divisées en deux flux : un pour les en-têtes et un pour les pieds de page, en utilisant des nœuds n8n de type 'Set' (Get Header Injection et Get Footer Injection). Ces nœuds extraient et définissent également des métadonnées importantes comme le nom de domaine et un horodatage.


3. Nettoyage du code : Les nœuds n8n Clean up Footers et Clean up Headers utilisent du JavaScript personnalisé avec Cheerio pour supprimer les éléments standard du framework Squarespace, ne laissant que le code injecté véritablement personnalisé.


4. Préparation pour GitHub : Le nœud n8n Merge Injections recombine les deux éléments nettoyés (données d'en-tête et de pied de page). Le nœud n8n Globals applique ensuite les paramètres du dépôt GitHub définis par l'utilisateur (propriétaire, nom, chemin).


5. Stockage GitHub : Le nœud n8n Loop Over Items traite les données d'en-tête et de pied de page individuellement. Le premier nœud n8n GitHub (Edit Injection data) tente de mettre à jour le fichier existant. Si cette action échoue (ce qui se produit si le fichier n'existe pas encore, indiqué par le nœud n8n If vérifiant une erreur de type 'not found'), le flux passe au nœud n8n Create Injection data, assurant que le fichier est créé pour la première fois. Cette logique conditionnelle garantit soit une mise à jour, soit une création, maintenant ainsi un historique de sauvegarde cohérent.

Pour déployer ce workflow n8n efficacement, suivez ces étapes :

1. Importation : Copiez le JSON du workflow n8n fourni et collez-le dans votre instance n8n.


2. URL Squarespace : Localisez le nœud n8n Get Squarespace data et mettez à jour le paramètre URL avec le domaine principal de votre site Squarespace.


3. Identifiants GitHub : Configurez l'identifiant d'API GitHub requis par les nœuds n8n Edit Injection data et Create Injection data. Ceci nécessite un Jeton d'Accès Personnel avec des droits d'écriture sur le dépôt.


4. Définir le chemin du dépôt : Ouvrez le nœud n8n Globals et mettez à jour les paramètres suivants :

1. Activation : Assurez-vous que le déclencheur n8n Schedule Trigger est actif pour activer les sauvegardes automatiques.

Ce workflow n8n avancé repose sur plusieurs types de nœuds n8n spécifiques :

Schedule Trigger (Déclencheur Planifié) : Sert de déclencheur principal pour n8n, initiant le processus de sauvegarde toutes les deux heures. Nœud n8n très fiable pour les tâches récurrentes.
HTTP Request (Get Squarespace data) : Récupère les données brutes du contexte de page Squarespace. Configuration clé : utilise le paramètre de requête ?format=page-context.
Set (Get Header/Footer Injection & Globals) : Utilisé principalement pour la manipulation des données. Les nœuds d'injection extraient le contenu brut et créent les métadonnées de support (ID, domaine). Le nœud n8n Globals centralise les détails de configuration GitHub.
Code (Clean up Footers/Headers) : Critique pour l'assainissement des données. Ces implémentations de nœuds n8n de script personnalisé utilisent la bibliothèque cheerio pour analyser le HTML et supprimer le code standard ajouté par Squarespace, isolant uniquement le code injecté personnalisé.
Merge : Combine les flux de données séparés (en-tête et pied de page) en un flux d'entrée unique pour le traitement ultérieur.
Loop Over Items (Split In Batches) : Assure que le fichier d'en-tête et le fichier de pied de page sont traités séquentiellement et indépendamment par le nœud n8n GitHub.

• GitHub (Edit/Create Injection data) : Gère le stockage réel. L'opération Edit tente de mettre à jour le fichier ; si elle échoue, le nœud n8n If dirige l'exécution vers l'opération Create, facilitant un contrôle de version transparent dans le dépôt GitHub.