Contenu

Mise à jour automatique

PrestaShop s'est vu adjoindre un outil de mise à jour automatique dans les versions 1.4.4 et 1.4.4.1, qui est ensuite devenu un module pouvant fonctionner avec les versions plus anciennes (à partir de la 1.3) et les plus récente (dont la 1.5).

Elle permet aux propriétaires de boutiques de sauvegarder et mettre à jour leur site en quelques clics, et ce sans connaissance technique.

Télécharger et installer le module 1-Click Upgrade

Suivez simplement le processus normal d'installation d'un module PrestaShop :

1. Téléchargez le module 1-Click Upgrade depuis PrestaShop Addons : http://addons.prestashop.com/fr/outils-administration-modules-prestashop/5496-autoupgrade.html sur votre ordinateur.
2. Dans le back-office de PrestaShop, allons dans l'onglet "Modules".
3. Cliquez sur le bouton "Ajouter un module", situé en haut à droit de la liste des modules disponibles.

   Si vous mettez à jour à partir de la version 1.4, cliquez sur le lien "Ajouter un module depuis mon ordinateur", situé en haut à gauche.

4. Dans le formulaire qui s'ouvre, cliquez sur le bouton "Naviguer...", puis trouver et sélectionner le fichier Zip du module qui vous venez de télécharger.
5. Cliquez sur le bouton "Mettre ce module en ligne". PrestaShop enverra le module sur votre serveur, le décompressera, et placera ses fichiers dans le dossier /modules.

Le module est maintenant disponible dans votre liste de modules, mais il vous faut encore l'installer :

1. Dans la page des modules, trouvez le module 1-Click Upgrade : saisissez "1-Click Upgrade" ou "autoupgrade" dans le moteur de recherche de modules (pas dans le moteur de recherche global situé en haut de l'écran). Un lien direct vers le module devrait apparaître dès les premières lettres. Cliquez-le.
2. PrestaShop affiche ensuite le module que vous venez d'installer dans la liste principale.
3. Cliquez sur le bouton "Installer" du module.

Le module est maintenant prêt à être configuré et utilisé.

L'écran de configuration

L'écran de configuration du module s'ouvre à partir de la liste de modules, en cliquant sur le lien "Configuration" du module.

Cet écran vous présente une série de section, vous donnant accès et des informations, des outils et de réglages.

Mise à jour

Cette section compare votre version de PrestaShop avec la dernière en date. Vous pouvez d'un coup d'oeil si vous avez besoin de faire une mise à jour ou non. Si vous savez qu'une nouvelle version plus récente que celle présentée est disponible, vous pouvez déclencher une nouvelle vérification de version en cliquant sur le bouton "Vérifier si une nouvelle version est disponible".

Si vous voulez faire la comparaison avec une version autre que la dernière stable (par exemple un béta, une RC ou toute autre version instable), cliquez sur le bouton "Plus d'options". Cela ouvrira une nouvelle section, nommée "Mode expert", où vous pouvez choisir le canal de distribution à partir duquel vous voulez faire la mise à jour.

Mode expert

Cette section vous permet de cibler exactement vers quelle version vous souhaitez mettre à jour votre installation actuelle de PrestaShop.

Les options sont :

• Channel. Choisissez le canal de distribution que vous souhaitez utiliser. La sélection recommandée est "Versions mineures", ce qui signifie "n'importe quelle version stable plus récente que celle actuellement installée". Les autres options sont :
  • Versions majeures. Seules les versions majeures au-dessus de la vôtre : 1.4, 1.5, etc.
  • Versions candidates. Ces versions sont jugées suffisamment stables pour être testées par le public, mais pas suffisamment testées pour devenir une version stable.
  • Versions bétas, Version alphas. Ce sont des versions en cours de développement. À utiliser à vos risques et périls.
  • Versions privées. Ponctuellement, les développeurs de PrestaShop mettent en ligne une version de test privée. Si vous disposez de la bonne adresse et de la clé hash, vous pouvez mettre à jour vers cette version en utilisant ce canal. Si vous cochez la case "Autoriser les mise à jour majeures", vous indiquez que vous ne souhaitez faire de mise à jour que s'il s'agit d'une version majeure.
  • Archive locale. À utiliser si vous avez téléchargé la version vers laquelle vous voulez faire la mise à jour, et que vous l'avez mise en ligne telle quelle dans le dossier /admin/autoupgrade/download.
  • Répertoire local. À utiliser si vous avez téléchargé la version vers laquelle vous voulez faire la mise à jour, que vous l'avez décompressée et que vous avez mis son contenu en ligne dans le dossier /admin/autoupgrade/latest/prestashop. Ce dossier /prestashop doit provenir directement de l'archive que vous avez téléchargée.
• Branche. Indique si quoi que ce soit est disponible dans le canal choisi.
• Nom. Le nom de la dernière version dans le canal choisi.
• URL. L'URL de la dernière version dans le canal choisi.
• MD5. Le hash de vérification de la dernière version dans le canal choisi.

Contrôles

La section "Contrôles" vous donne de précieuses informations sur votre installation actuelle de PrestaShop, et la manière dont elle pourrait fonctionner avec l'outil de mise à jour. Vous devez vous assurer que les différents points de contrôle sont validés avant de lancer la mise à jour.

• Version du module à jour (version). Indique s'il vous faut mettre à jour le module de mise à jour. Si vous venez de le télécharger, il est probable que vous avez la toute dernière version.
  Si vous ne disposez effectivement pas de la dernière version du module, un bouton apparaîtra, nommé "Installer la dernière version en cliquant sur 'Ajouter depuis mon ordinateur'". En le cliquant, vous arriverez à la page "Modules". De là, cliquez sur le lien "Ajouter un module depuis mon ordinateur" pour afficher le formulaire pré-rempli. Cliquez sur le bouton "Téléchargez ce module" pour lancer sa mise à jour. Enfin, retournez sur la page de configuration du module 1-Click Upgrade pour continuer vos vérification d'avant la mise à jour.
• Dossier racine récursivement autorisé en écriture. Indique si les permissions de lecture/écriture sont bien en place. Si ce n'est pas le cas, vous devrez les corriger, à l'aide d'un client FTP tel que FileZilla.
  Vous trouverez plus d'information sur le CHMOD dans la section "Compatibilité système et configuration système" du Guide de démarrage.
• Boutique désactivée. Indique si la boutique est active en monde de maintenance. Vous devez mettre votre boutique en maintenance durant l'intégralité du processus (sauvegarde des fichiers et de la base de données, mise à jour automatique, vérification), ce afin d'éviter que vous clients ne perdent leur commande... et que vous perdiez des clients. Le module ne désactive pas votre boutique pour vous, mais vous donne un lien menant à la page des préférences de la boutique :
  • PrestaShop 1.4 : désactivez la boutique dans l'onglet "Préférences".
  • PrestaShop 1.5 : désactivez la boutique dans la page "Maintenance" du menu "Préférences".
• Cache désactivé. Indique si le cache de votre boutique est activé ou non. Vous devez le désactiver pour l'intégralité du processus. Le module ne le fera pas à votre place.
  • PrestaShop 1.4 : désactivez le cache dans la page "Performances", sous l'onglet "Préférences".
  • PrestaShop 1.5 : désactivez le cache dans la page "Performance" du menu "Paramètres avancés".
• Temps d'exécution PHP désactivée. La mise à jour automatique peut se révéler être un processus long, car il nécessite le téléchargement de l'archive depuis prestashop.com, sa décompression sur le serveur, le remplacement des fichiers actuels, puis le déclenchement de la mise à jour elle-même. De fait, les réglages de PHP peuvent être trop stricts, et empêcher complètement la mise à jour, au pire en plein milieu de celle-ci. Avec ce champ, PrestaShop vous indique si les réglages sont suffisants. Idéalement, vous devriez voir une coche verte.
• Options choisie. Avant de lancer la mise à jour, vous devez vous assurer de bien comprendre les réglages. Les sections "Options de sauvegarde" et "Options de mise à jour", placées en bas de la page, vous donnent des réglages plus précis, et si ceux-ci ne sont pas enregistrés, le boutons vous enverra sur ces sections.

Tous les indicateurs doivent être au vert pour que la mise à jour puisse fonctionner. Autrement, le bouton de mise à jour n'apparaîtra pas.

Comparaison des versions

Pour les plus curieux d'entre vous, cette section affiche le nombre de différences entre votre version actuelle et la version du canal choisi.

Dans le cas où vous avez fait des modifications aux fichiers mêmes de PrestaShop au lieu de passer par de codes d'override, cette liste peut vous aider à savoir si vos modifications sont en sécurité ou non.
Dans tous les cas, vous pouvez pérenniser vos modifications en les plaçant dans des fichiers d'override. Lisez la documentation pour les développeurs si vous désirez plus d'information.

Restaurer

Voir ci-dessous.

Options de sauvegarde

Ces options vous permettent de mieux contrôler le processus de sauvegarde :

• Sauvegarder mes fichiers et ma base de données. Ceci n'est en fait pas une option : vous devez sauvegarder vos fichiers, et le prendre s'en chargera pour vous.
• Sauvegarder mes images. Vous devriez également laisser le module s'occuper de vos images, afin de pouvoir faire une réinstallation propre après avoir remis en ligne vos fichiers.

Options de mise à jour

Ces options vous permettez de mieux contrôler le processus de mise à jour :

• Conserver le thème original. Le processus de mise à jour supprime le thème par défaut et le remplace par sa dernière version. Si vous avez fait des modifications directement dans le demain, vous pouvez les protéger en choisissant "Oui".
  Pour rappel, il n'est pas recommandé de modifier le thème par défaut! Vous devriez en faire une copie, et faire vos modifications dans cette copie.
• Conserver le dossier mail. Une mise à jour peut apporter son lot de modèles d'e-mail. Par défaut, la mise à jour remplace les modèles existants par ceux de la version plus récente, et ajoute les nouveaux modèles. Si vous avez personnalisé vos modèles, nous vous recommandons de les conserver. Vous devrez alors personnaliser vos nouveaux modèles afin de correspondre au style global de votre boutique.
• Désactiver les modules personnalisés. Nous vous recommandons de choisir "Oui" pour cette option, car certain module peuvent se révéler récalcitrants durant le processus de mise à jour.
• Mode manuel. Activé, cette option fait en sorte que le module fasse une pause à chaque étape, et attende votre confirmation.
• Performance serveur. Certains hébergeurs mutualisés ne proposent que des serveurs à faible performance, ce qui peut gêner votre processus de mise à jour, voire le faire rater. "Basse" est sélectionné par défaut, mais si vous êtes certain d'avoir un serveur puissance, vous pouvez monter à "Moyenne", voire "Haute".

Le processus de mise à jour

Une fois tous les indicateurs au vert, le bouton de mise à jour apparaît dans la section "Mise à jour", accompagné d'une indication de la version de Smarty que vous utilisez, l'adresse web à partir de laquelle la nouvelle version sera téléchargée.

Cliquez sur "Mettre PrestaShop à jour maintenant !" pour lancer le processus.

Une fois le processus lancé, la page de configuration est remplacée par deux sections : "Journal d'activité" et "Restaurer".

Le journal d'activité vous donne une liste détaillée de ce que l'outil de mise à jour est en train de faire, dans une section que vous pouvez faire défiler:

• Fichiers supprimés : seuls les fichiers d'exemple sont supprimés, tel que les classes d'override vides et les contrôleurs.
• Nom de l'archive de sauvegarde : le nom suit la convention auto-backupfiles_Vversioninitiale_date-heure-hash.zip
• Fichiers ajoutés à l'archive de sauvegarde : tous les fichiers restants de votre installation actuelle sont placés dans l'archive Zip.
• Tables de la base de données ajoutées à l'archive de sauvegarde : vos fichiers sont importants, mais l'intégralité de votre catalogue est stocké dans votre base de données, et il est donc important de la conservé dans la même archive.
• Fichiers supprimés : principalement des modules, contrôleurs, classes, et fichiers CSS et JavaScript. Maintenant que vos fichiers ont été sauvegardés dans l'archive de sauvegarde, ils peuvent être supprimés en toute sécurité.
• Fichiers copiés depuis la nouvelle archive : tous les fichiers actuels sont remplacés par ceux de la nouvelle version.
• Fusion des fichiers de traduction.
• Création, effacement, modification et mise à jour des tables de la base de données.
• Vidage des dossiers temporaires : s'il le peut, l'outil de mise à jour essayera d'effacer le contenu du dossier de cache.

Le journal d'activité mentionne de nombreux fichiers tout du long du processus. Vous n'avez pas à lire toutes ces notifications, elles ne sont là que pour vous aider en cas d'erreur.

Vous saurez que le processus est terminé quand apparaîtra en vert le message "Mise à jour terminée. Vous devez maintenant vérifier que votre boutique est toujours fonctionnelle (affichage du thème, test de commande en tant que client, ...)", accompagné d'une dernière entrée en journal : "Fin du processus".
L'outil de mise à jour vous indique par ailleurs que vous devez réactiver votre boutique, mais avant cela, faites en sorte de vérifier que tout fonctionne correctement dans votre back-office : pas d'erreur, tous les produits et catégories sont en place avec leurs images et fichiers attachés, etc. Tant que vous n'avez pas fait cette vérification, il vaut mieux ne pas rouvrir l'accès à votre site.

Une fois que vous vous êtes assuré que votre installation de PrestaShop fonctionne correctement, vous pouvez réactiver la boutique à l'aide de l'option dans la page "Maintenance" du menu "Préférences", puis faites des tests sur votre front-office : parcourez les produits, triez-les, essayez d'en acheter un, etc. Bref, lancez-vous dans un processus complet d'achat, afin de vous assurer que vous n'allez pas perdre des ventes.

Tout fonctionne-t-il correctement ? Félicitations, vous disposez désormais d'une installation de PrestaShop à jour !

Restaurer

Malheureusement, toutes les mises à jour ne se terminent pas par un succès – et c'est bien pourquoi vous devriez toujours faire une sauvegarde de vos données et fichiers, et pourquoi PrestaShop réalise une sauvegarde supplémentaire sur lesdits fichiers et données lui-même (sur laquelle vous ne devriez pas forcément compter, évidemment. Faites vos propres sauvegardes).

Les sauvegardes de PrestaShop sont stockées sur votre serveur, et s'il se trouve que votre mise à jour s'est mal déroulée, vous pouvez les retrouver dans la section "Restaurer" de la page de configuration du module de mise à jour.
Les fichiers de sauvegarde sont créés dès que le processus de sauvegarde est lancé, et sont disponibles aussitôt, dans la liste "Choisissez votre sauvegarde".
Choisissez la plus récente. La date et l'heure de la création du fichier de sauvegarde sont directement dans son nom : Vversion-date-heure-hasard, par exemple "V1.4.9.0_20120907-114024-f85f41a" pour une sauvegarde d'une installation précédente de PrestaShop 1.4.9, réalisée le 7 septembre 2012 à 11 h 40 min 24 s.

Le bouton "Restaurer" déclenche deux actions :

• Prend les fichiers de la dernière sauvegarde, et les réinstalle en lieu en place des fichiers de l'installation actuelle.
• Prend les données de la dernière sauvegarde, et les réinstalle en lieu et place de celles de la base de données actuelle.

Sélectionnez l'archive de sauvegarde vers laquelle vous souhaitez revenir, et cliquez sur le bouton "Restaurer". Comme pour le processus de mise à jour, l'interface entière disparaît pour ne laisser que le "Journal des activités" et la section "Restaurer". Vous pouvez suivre le processus de restauration en parcourant le journal. Une fois la mise à jour terminée, rechargez la page pour vérifier que tout est bien revenu à sa place.