SafeCore PRO
Documentation

Qu'est-ce que SafeCore PRO ?

SafeCore PRO est un plugin WordPress qui protège votre site contre les mises à jour catastrophiques. Avant chaque mise à jour de plugin ou de thème, SafeCore crée automatiquement un snapshot complet (archive ZIP du dossier + export des options WordPress). Si la mise à jour provoque un crash ou une erreur fatale, SafeCore détecte le problème et effectue un rollback automatique — sans aucune intervention de votre part.

Prérequis

• WordPress 5.6 ou supérieur
• PHP 7.4 ou supérieur
• Extension PHP ZipArchive activée
• Droits d'écriture sur wp-content/plugins/safecore/data/
• cURL activé (pour les notifications Slack) Optionnel

Installation

1. 1Téléchargez le fichier safecore.zip depuis votre espace client.
2. 2Dans votre back-office WordPress, allez dans Extensions → Ajouter une extension.
3. 3Cliquez sur Téléverser une extension, sélectionnez le fichier ZIP et installez.
4. 4Activez l'extension. SafeCore s'installe aussi automatiquement comme MU-Plugin pour garantir un chargement prioritaire.

Activation de la licence

1. 1Une fois activé, rendez-vous dans SafeCore → Paramètres dans le menu d'administration.
2. 2Collez votre clé de licence (disponible dans votre tableau de bord client) dans le champ Clé de licence.
3. 3Cliquez sur Activer. SafeCore contacte le serveur de licences et confirme l'activation.

Le pipeline de mise à jour

Lorsque vous cliquez sur "Mettre à jour" pour un plugin ou un thème, SafeCore intercepte l'action avant que WordPress n'exécute la mise à jour native. Voici les 4 étapes :

Interception JavaScript

SafeCore injecte un script JavaScript sur les pages d'administration des extensions et des thèmes. Ce script écoute en capture tous les clics sur les boutons de mise à jour. Lorsqu'un clic est détecté, SafeCore affiche son modal Sentinel, empêche WordPress d'exécuter la mise à jour directement, et lance son propre pipeline AJAX.

Mises à jour groupées natives

Pour les mises à jour groupées lancées depuis le tableau de bord WordPress (sans passer par le modal SafeCore), le plugin se connecte aux hooks natifs upgrader_pre_install et upgrader_process_complete pour créer les snapshots et effectuer les vérifications.

Contenu d'un snapshot

Un snapshot SafeCore contient deux éléments :

• Archive ZIP du dossier complet du plugin ou du thème mis à jour.
• Export JSON des options WordPress (wp_options) liées au plugin.

Les snapshots sont stockés dans plugins/safecore/data/, protégés par un fichier .htaccess qui bloque tout accès HTTP direct.

Limite et rotation

SafeCore conserve un maximum de 5 snapshots. Au-delà, le plus ancien est automatiquement supprimé pour libérer de l'espace. La taille d'un snapshot dépend du plugin ou thème sauvegardé.

Télécharger un snapshot

Depuis l'onglet Historique du tableau de bord SafeCore, chaque entrée de snapshot affiche un bouton de téléchargement. Le fichier ZIP est servi via un handler AJAX sécurisé (nonce + vérification de capacité administrateur).

Snapshot manuel

Vous pouvez créer un snapshot manuel à tout moment depuis l'onglet Historique, sans déclencher de mise à jour.

Accédez aux paramètres depuis SafeCore → Paramètres dans le menu WordPress.

Mode de récupération

Définit l'action automatique de SafeCore lorsqu'une mise à jour provoque un crash.

• Rollback — SafeCore restaure automatiquement la version précédente du plugin ou du thème à partir du snapshot. Mode recommandé.
• Isolation — SafeCore désactive le composant défaillant en le renommant temporairement, sans toucher la base de données. Mécanisme de dernier recours si aucun snapshot n'est disponible.

URL de santé

URL que SafeCore interroge après chaque mise à jour pour vérifier que le site fonctionne. Par défaut : la page d'accueil du site. Vous pouvez définir une URL personnalisée (ex : une page de test dédiée retournant HTTP 200).

Notifications email

En cas de crash détecté, SafeCore envoie un email d'alerte à l'adresse administrateur du site. L'email contient : le nom du plugin/thème concerné, le message d'erreur, et l'action de récupération effectuée (rollback ou isolation).

Webhook Slack

Collez l'URL de votre Incoming Webhook Slack pour recevoir des alertes instantanées. SafeCore envoie un payload au format Slack Block Kit incluant le site, le plugin, l'erreur et le statut de récupération.

White-label

Rollback automatique

Lorsqu'une mise à jour provoque un health check échoué (HTTP non-200, timeout, ou erreur fatale PHP), SafeCore déclenche immédiatement la restauration du snapshot. La mise à jour défaillante est écrasée par l'archive sauvegardée. L'opération est quasi instantanée.

Rollback manuel

Depuis l'onglet Historique, chaque snapshot est accompagné d'un bouton Restaurer. Ce bouton effectue le même processus de rollback que l'automatique, mais déclenché manuellement à tout moment.

Isolation de plugin

Lorsque SafeCore détecte un plugin défaillant mais ne peut pas effectuer un rollback propre (ex : le plugin est nouveau, pas encore en snapshot), il peut isoler le plugin en le renommant temporairement pour le désactiver sans passer par la base de données — un mécanisme de dernier recours qui fonctionne même si WordPress ne démarre plus.

Script de récupération standalone

SafeCore déploie un script PHP autonome à l'adresse wp-content/safecore/recovery-{hash}.php. Ce script fonctionne sans WordPress — il peut restaurer un snapshot même si votre site est complètement cassé et affiche une page blanche. L'URL exacte est affichée dans votre tableau de bord SafeCore.

wp-content/safecore/recovery-{hash}.php

Fatal Error Handler

SafeCore installe un handler d'erreurs fatales PHP personnalisé (wp-content/fatal-error-handler.php) qui intercepte les erreurs fatales avant que WordPress ne les traite. Cela permet à SafeCore de déclencher un rollback même si PHP crashe avant de terminer le chargement de WordPress.

wp-content/fatal-error-handler.php

L'onglet Historique du tableau de bord SafeCore affiche un journal complet de toutes les opérations effectuées.

Contenu d'une entrée

• Plugin / Thème — Nom et slug de l'élément mis à jour.
• Action — Type d'opération : snapshot, update, rollback, isolation.
• Statut — Succès, Rollback effectué, ou Isolé.
• Date & Heure — Horodatage précis de l'opération.
• Taille — Taille du snapshot en Mo.

Stockage

L'historique est stocké au format JSON dans plugins/safecore/data/history.json. Il n'est pas écrit en base de données pour éviter les conflits avec les opérations de restauration.

plugins/safecore/data/history.json

Alertes email

Un email est automatiquement envoyé à l'administrateur WordPress lors d'un crash détecté. Le contenu inclut :

• Nom et URL du site
• Nom et version du plugin/thème défaillant
• Message d'erreur ou code HTTP retourné
• Action effectuée (rollback automatique, isolation)
• Horodatage

Slack / Webhook

SafeCore envoie un payload au format Slack Block Kit vers l'URL webhook configurée. Conçu pour Slack. Tout service acceptant du HTTP POST JSON recevra la notification via le champ text, mais le formatage riche (blocs, champs) est natif Slack uniquement.

Exemple de payload Slack :

{
  "site": "https://yoursite.com",
  "plugin": "woocommerce/woocommerce.php",
  "version_new": "8.4.0",
  "version_old": "8.3.0",
  "status": "rollback",
  "error": "HTTP 500 — Fatal error in class-wc-cart.php",
  "timestamp": "2026-03-13T14:22:05Z"
}