Processus de mise à jour

Ce document décrit le processus recommandé pour mettre à jour l'extension ADP Car Market Hub sur un site WordPress de production. Suivre un processus de mise à jour structuré réduit le risque de perte de données, de modifications de configuration ou de régressions sur l'interface publique.

Quand utiliser ce document

Consultez ce document chaque fois qu'une nouvelle version de l'extension est disponible et que vous devez l'appliquer à un site en production. Lisez-le également avant toute mise à jour planifiée du cœur de WordPress qui pourrait affecter la compatibilité de l'extension.

Aperçu

Les mises à jour de l'extension peuvent inclure des corrections de bogues, des correctifs de sécurité, de nouvelles fonctionnalités ou des modifications du schéma de la base de données. L'extension gère automatiquement les migrations de schéma de base de données lors de l'activation et lors de plugins_loaded, mais un test sur un environnement de préproduction avant le déploiement en production est fortement recommandé pour les changements de version majeurs.

Le processus général est le suivant : examiner les notes de version → effectuer une sauvegarde → tester en préproduction → appliquer en production → vérifier le fonctionnement.

Configuration requise

• Accès administrateur à l'administration WordPress sur l'environnement de préproduction et sur l'environnement de production.
• Une sauvegarde complète récente de la base de données de production et du répertoire des téléversements (voir Sauvegarde et restauration).
• Un environnement de préproduction qui reflète le site de production. Si aucun environnement de préproduction n'existe, effectuez une sauvegarde complète avant la mise à jour et soyez prêt à effectuer une restauration.
• L'habilitation manage_as24_imports sur le compte effectuant la mise à jour.

Instructions étape par étape

Étape 1 : Examiner les notes de version

1. Lisez les notes de version de la nouvelle version (voir Notes de version).
2. Identifiez les changements majeurs, les migrations de base de données ou les étapes de configuration répertoriés dans les notes de version.
3. Notez toute nouvelle exigence concernant la version de PHP ou de WordPress. L'extension nécessite PHP 8.1 ou version ultérieure et WordPress 6.2 ou version ultérieure à compter de la version 1.0.0. Vérifiez l'en-tête du fichier de l'extension ou readme.txt pour connaître les exigences actuellement déclarées.

Étape 2 : Effectuer une sauvegarde complète

1. Sauvegardez la base de données de production et le répertoire wp-content/uploads/ avant d'apporter des modifications.
2. Notez la version actuelle de l'extension afin de pouvoir y revenir si nécessaire.
3. Stockez la sauvegarde dans un emplacement accessible même si l'administration WordPress devient indisponible (par exemple, une sauvegarde au niveau de l'hébergement ou un téléchargement local).

Étape 3 : Tester la mise à jour en préproduction

1. Appliquez la nouvelle version de l'extension sur le site de préproduction.
2. Si le site de préproduction ne reflète pas l'état actuel de la production, restaurez une sauvegarde de production récente sur la préproduction avant d'appliquer la mise à jour.
3. Après la mise à jour en préproduction, vérifiez les points suivants : - Les pages d'administration de l'extension se chargent sans erreurs PHP ni écrans blancs. - L'onglet Santé ne présente aucun nouveau problème critique. - L'état de la connexion API est Connecté dans l'onglet Système et aide. - Une importation manuelle se termine avec succès (utilisez le bouton Déclencher l'importation maintenant dans Automatisation). - Les fiches de véhicules importées s'affichent correctement sur les pages d'archives et les pages de véhicules individuels de l'interface publique. - Le formulaire de contact pour les leads est soumis avec succès et envoie un e-mail de notification. - Les événements de suivi analytique sont enregistrés (si l'analyse est activée).
4. Si des problèmes sont constatés en préproduction, ne passez pas à la production. Signalez le problème et attendez un correctif ou des conseils.

Étape 4 : Appliquer la mise à jour en production

Option A : Mise à jour via l'administration WordPress

1. Connectez-vous à l'administration WordPress de production.
2. Accédez à Tableau de bord → Mises à jour (ou Extensions → Extensions installées).
3. Localisez ADP Car Market Hub dans la liste des mises à jour et cliquez sur Mettre à jour.
4. WordPress désactivera l'extension, remplacera les fichiers de l'extension et la réactivera. Le crochet d'activation de l'extension exécute automatiquement les migrations de schéma et d'options.

Option B : Mise à jour manuelle des fichiers

1. Mettez le site en mode maintenance si votre flux de travail l'exige.
2. Téléchargez le package de la nouvelle version de l'extension.
3. Via SFTP ou le gestionnaire de fichiers de votre hébergement, remplacez le contenu de wp-content/plugins/adp-car-market-hub/ par les fichiers de la nouvelle version.
4. Le crochet plugins_loaded de l'extension déclenchera les migrations de schéma lors du traitement de la prochaine requête WordPress.

Étape 5 : Vérifier la mise à jour en production

1. Ouvrez ADP Car Market Hub → Système et aide et confirmez que l'état de la connexion API est Connecté.
2. Consultez l'onglet Tableau de bord et confirmez que le nombre de véhicules et les informations sur la dernière exécution sont présents.
3. Ouvrez l'onglet Journaux et confirmez qu'il n'y a pas de nouvelles erreurs liées à la mise à jour.
4. Accédez à la page d'archive des véhicules sur l'interface publique et confirmez que les fiches se chargent correctement.
5. Si le numéro de version de l'extension est affiché quelque part dans l'administration (par exemple, l'onglet Santé ou Support), confirmez qu'il indique la nouvelle version.
6. Déclenchez une importation manuelle depuis l'onglet Importations et limites et confirmez qu'elle se termine sans erreur.

Étape 6 : Surveiller pendant 24 à 48 heures

1. Après la mise à jour en production, effectuez les vérifications quotidiennes standard (voir Utilisation quotidienne) pendant les un à deux jours suivants.
2. Surveillez l'apparition de nouvelles erreurs dans l'onglet Journaux.
3. Confirmez que les importations planifiées continuent de s'exécuter à l'heure.

Référence de configuration

Notes opérationnelles

• L'extension utilise les crochets plugins_loaded et admin_init pour vérifier et appliquer les migrations de schéma de base de données. Les mises à niveau de schéma s'exécutent automatiquement et ne nécessitent pas d'exécution SQL manuelle.
• L'extension enregistre une habilitation personnalisée (manage_as24_imports) lors de l'activation. Si cette habilitation est manquante après une mise à jour, désactivez et réactivez l'extension pour déclencher l'enregistrement de l'habilitation.
• L'extension stocke une version de base de données dans la table des options WordPress (as24ci_db_version). L'extension lit cette valeur et applique toutes les migrations en attente lorsqu'elle détecte une incompatibilité de version.
• Les surcharges de modèles personnalisés stockées en dehors du répertoire de l'extension (par exemple, dans un thème enfant) ne sont pas affectées par les mises à jour de l'extension. Cependant, si la mise à jour modifie la structure des modèles, vos modèles personnalisés devront peut-être être mis à jour pour correspondre.
• La file d'attente des images, les transients de verrouillage d'importation et le jeton d'accès mis en cache ne sont pas affectés par les mises à jour de l'extension. Les exécutions d'importation en cours devraient se terminer normalement.

Restauration

Si la mise à jour en production cause des problèmes et qu'une restauration est nécessaire :

1. Restaurez la sauvegarde de la base de données effectuée à l'étape 2.
2. Restaurez les fichiers de l'extension précédente à partir de la sauvegarde ou en téléchargeant la version précédente.
3. La version précédente de l'extension détectera l'état restauré de la base de données et les données seront cohérentes.
4. Recherchez la cause de l'échec avant de tenter à nouveau la mise à jour.

Dépannage

Documents connexes

• Sauvegarde et restauration
• Maintenance mensuelle
• Journalisation et surveillance