Contenu

Mise à jour manuelle

La mise à jour manuelle est une processus long et détaillé, auquel vous ne devriez faire appel qu'en cas de nécessité – notamment si vous ne pouvez pas faire de mise à jour automatique.

De fait, les mises à jour manuelles sont à réserver aux experts.

L'essentiel

Cette courte section est réservée à ceux qui sont déjà habitués à l'installation d'applications PHP-MySQL sur un serveur. Si le manque de détail vous gêne, vous trouverez des instructions détaillées dans la section suivante.

Les étapes de la mise à jour de PrestaShop :

Enregistrer et sauvegarder la boutique actuellement en ligne
- Désactivez votre boutique (page "Maintenance" du menu "Préférences").
- Sauvegardez vos fichiers sur votre PC, en utilisant votre client FTP.
- Sauvegardez votre base de données (page "Paramètres avancés / Sauvegarde BDD", ou en passant par phpMyAdmin).
- Sauvegardez votre traduction sur mesure ("Export d'une langue" dans la page "Localisation / Traductions").
Se préparer pour la nouvelle version
- Téléchargez et décompressez la dernière version de PrestaShop: http://www.prestashop.com/fr/telechargement.
- Copiez les fichiers que vous avez sauvegardés à l'étape 1 vers le dossier "prestashop" de votre ordinateur.
- Transférer le dossier "prestashop" de votre ordinateur vers votre serveur FTP (en gardant vos fichiers originaux intacts pour l'instant).
- Vérifications à faire avant d'avant d'aller plus loin:
  1. Accédez au dossier /prestashop/ avec votre navigateur web, et vérifiez que tout fonctionne correctement avant de passer à l'étape suivante.
  2. Accédez au back-office.
Lancer la mise à jour
- Lancez le script de mise à jour en y accédant avec votre navigateur. Dans la version 1.5, il est situé à l'adresse /install/upgrade/upgrade.php.
- Vérifiez tous les paramètres avant la mise à jour : suivez les instructions à l'écran et assurez-vous que votre serveur est conforme aux exigences techniques de la nouvelle version.
- Fin de la mise à jour : une fois la mise à jour terminée, supprimez le dossier /prestashop/install et rendez-vous sur votre front-office et votre back-office pour vous assurer que tout fonctionne.
Tests et assurance qualité
- Importez vos traductions (section "Importez un pack de langue manuellement" dans la page "Traduction", dans le menu "Localisation").
- Vérifiez que le nom de domaine principal est correct (page "Préférences / SEO & URLs", section "URL de la boutique").
- Régénérez votre fichier robots.txt (page "Préférences / SEO & URLs", section "Génération du fichier robots.txt").
- Vérifiez que votre thème fonctionne toujours comme prévu. Si ce n'est pas le cas, vous devrez modifier ses fichiers.
- Testez votre boutique en détail : créez des comptes, achetez des produits, annulez des commandes, vérifiez les factures, etc.
Lancez votre boutique mise à jour
- Faites l'échange entre votre boutique mise à jour et votre boutique de production : votre boutique est mise à jour et pleinement fonctionnelle dans le dossier /prestashop, et votre ancienne boutique est désactivée à son URL normale. Elles ont toutes deux le même contenu : produits, pages, images, thème, modules, etc. Il est temps d'échanger l'un pour l'autre. Au choix :
  - Déplacez tous les fichiers à partir de {{/prestashop }} vers l'URL normale, en remplaçant les anciens fichiers par les nouveaux.
  - Envoyez vos fichiers de votre ordinateur vers l'URL de l'ancienne version, en remplaçant les anciens fichiers par les nouveaux.
  - Déplacez les anciens fichiers dans un nouveau dossier (par exemple /versionprecedente) et déplacez la boutique mise à jour depuis le dossier /prestashop vers le dossier normal.
- Activez votre boutique (page "Maintenance" du menu "Préférences").

C'est fait ! Découvrez toutes les nouvelles fonctionnalités de cette mise à jour !

Première étape – Enregistrer et sauvegarder la boutique actuellement en ligne

Ne pas sauvegardez votre boutique vous fait prendre un risque très important si vous rencontrez des difficultés avec la mise à jour. Vous pourriez perdre vos données et ne jamais les récupérer

Ne jamais sauter cette étape. Ne passez pas à l'étape 2 sans être absolument certain que vos sauvegardes ont été effectuées avec succès, et sont entièrement fonctionnelle. Faites autant de tests et vérifications que possible.

Désactiver votre boutique

Il est très important de désactiver votre boutique.
En la désactivant, vous vous assurez qu'il n'y a pas d'activité sur votre boutique tandis que vous la mettez à jour. Par conséquent, si jamais vous avez à revenir à la mise à jour d'une sauvegarde, même très récente, vous n'aurez pas perdu des paniers en cours de remplissage ou des commandes.

Allez dans le back-office de votre boutique, ouvrez la page "Maintenance" depuis le menu "Préférences", puis choisissez "Non" pour l'option "Activer la boutique".

Dans PrestaShop 1.4, ce réglage est directement disponible depuis l'onglet "Préférences".

Dans le champ "Maintenance de IP ", situé juste en dessous de la case "Activer la boutique", saisissez votre propre adresse IP, de sorte que vous pouvez continuer à utiliser votre boutique lors de la mise à jour. Cela vous permettra de tester la boutique, tout en faisant en sorte que des visiteurs ne puissent pas accéder au site Web.
Afin de connaître votre adresse IP, rendez-vous sur cette page: http://www.mon-ip.com/

Sauvegarder vos fichiers

Vous devez enregistrer tous les fichiers liés à votre boutique PrestaShop.

Il y a principalement deux manières de les enregistrer :

Demandez à votre hébergeur de le faire pour vous.
Assurez-vous qu'il s'agit d'une sauvegarde pleinement fonctionnelle, récente, et surtout qu'elle reflète pleinement le contenu de votre boutique actuelle.

...ou...

Copiez tous vos fichiers depuis votre hébergement vers votre ordinateur à l'aide d'un client FTP.
Cette méthode n'est possible que si votre hébergeur vous donne accès à votre serveur FTP. Créer un dossier "Sauvegarde" sur votre bureau, puis à l'aide d'un client FTP (tel que FileZilla, que vous pouvez télécharger sur http://filezilla-project.org/), sélectionnez tous les fichiers et dossiers de PrestaShop sur votre serveur (utilisez le raccourcis clavier Ctrl-A) et copiez-les dans votre dossier "Sauvegarde".

Sauvegarder votre base de données

Vous devez absolument faire une sauvegarde de toute la base de données de votre boutique PrestaShop.

Il y a trois manières de réaliser cette sauvegarde :

Demandez à votre hébergeur de le faire pour vous.
Assurez-vous qu'il s'agit d'une sauvegarde pleinement fonctionnelle, récente, et surtout qu'elle contient bien toutes les données de votre boutique actuelle.

...ou...

Téléchargez une sauvegarde depuis le back-office de PrestaShop.
Ouvrez la page "Sauvegarde BDD", puis suivez les instructions sur la page.
Cette page se trouve :

PrestaShop 1.4 : dans l'onglet "Outils", sous-onglet "Sauvegarde BDD".

PrestaShop 1.5 : dans le menu "Paramètres avancés", page "Sauvegarde BDD".
Le processus entier peut prendre entre 1 et 20 minutes, en fonction de la taille de votre base de données, après quoi vous verrez un lien apparaître sur la page, "Téléchargez le fichier de sauvegarde (taill)". Cliquez-le, et assurez-vous que la sauvegarde est fonctionnelle, récente, et surtout qu'elle contient bien toutes les données de votre site web. Ouvrez le fichier zip et vérifiez qu'il n'y a absolument AUCUNE ERREUR dans le fichier .sql avant de continuer le processus de mise à jour.

...ou...

Téléchargez une copie de vos données en passant par phpMyAdmin.
Assurez-vous que votre base de données est fonctionnelle, récente, et surtout qu'elle contient toutes les données de votre boutique PrestaShop. Si votre base de données est trop volumineuse, il se peut que phpMyAdmin vous renvoie une erreur. Dans ce cas, passez par votre hébergeur.

Conservez ce fichier dans le dossier "Sauvegarde" de votre ordinateur, que vous devez avoir créé à l'étape précédente et devrait déjà contenir vos fichiers.

Sauvegarder vos traductions personnalisées

Si vous n'avez pas modifié les traductions, ni ajouté de nouvelles traductions (que ce soit pour PrestaShop ou vos modules), passez directement à l'étape suivante.

Pour conserver vos modifications de traduction :

Rendez-vous dans la page "Traduction" du menu "Localisation" de votre back-office.

Dans PrestaShop 1.5, allez dans le sous-onglet "Translations" qui se trouve dans l'onglet "Outils".
Dans la section "Exporter des traductions", sélectionnez la langue dans laquelle vous avez fait vos modifications, puis sélectionnez le thème actuel, et cliquez sur "Exporter".
Enregistrez le fichier téléchargé dans le dossier "Sauvegarde" sur votre ordinateur.

Répétez ce processus pour toutes les langues que vous avez personnalisé, que ce soit celles que vous avez créé/ajouté et celle que vous avez modifié/corrigé.

Contient-il...

...une copie complète de tous vos fichiers ?
...une copie complète et sans erreur de votre base de données ?
...une copie de vos traductions personnalisées (facultatif) ?

Vous devez avoir vérifié l'intégralité de votre dossier de sauvegarde, et fait en sorte que tout y est correct et que, au besoin, vous pourriez récupérer vos données.

Si vous avez répondu oui à toutes les questions ci-dessus, passez à l'étape 2.

Deuxième étape – Se préparer pour la nouvelle version

Télécharger et décompresser la dernière version de PrestaShop

Rendez-vous sur http://www.prestashop.com et téléchargez la dernière version de PrestaShop (cliquez sur le bouton "Téléchargement", remplissez le formulaire, et validez).

Vous devriez obtenir un fichier sous la forme prestashop_1.x.x.zip (où "x" est un chiffre du numéro de version).

Décompressez ce fichier zip sur votre ordinateur. Si vous n'avez pas d'outil de décompression, vous pouvez en télécharger un gratuit ici : http://www.7-zip.org/.

Une fois décompressé, ouvrez le dossier /prestashop qui se trouvait dans l'archive Zip.

Dans ce dossier /prestashop, sélectionnez le dossier /admin et donnez-lui un nom unique, par exemple /admin436. À l'heure actuelle, votre boutique en ligne dispose également d'un dossier "admin" renommé de manière unique, qui date de l'installation originale de PrestaShop ; vous pouvez utiliser ce nom si vous le souhaitez, ou celui de votre choix.

Copier dans le nouveau dossier "prestashop" les fichiers qui ont été sauvegardés pendant l'étape 1

Certains dossiers que vous avez sauvegardés doivent être copiés dans le dossier /prestashop que vous venez de décompressé depuis l'archive Zip.

Vous allez copier des fichiers depuis votre dossier "Sauvegarde" vers votre dossier /prestashop. Choisissez "Oui" chaque fois que le système vous demandera s'il doit remplacer le fichier original par la copie.

Les dossiers suivants doivent être copiés depuis votre dossier "Sauvegarde" vers le dossier /prestashop récemment décompressé :

/mails. Contient tous les modèles de mails, dont ceux que vous avez modifiés.
Si vous n'avez jamais modifié vos modèles de mails, ne copiez pas ce dossier.
/img. Contient votre logo et toutes les images de votre boutique (catégories, produits, etc.). Copiez plus particulièrement ces fichiers et dossiers :
- logo.jpg - le logo de votre boutique
- favicon.ico - le favicon de votre boutique
- logo_stores.gif - le logo de votre boutique pour la carte de l'outil de découverte de magasins
- /c - les images de vos catégories
- /cms - les images de vos pages CMS
- /co - les textures de couleur de vos attributs
- /m - les logos de vos marques/fabricants
- /p - les photos de vos produits
- /scenes - les image-maps/scènes de vos catégories
- /st - les photos de vos magasins physiques
- /su - les logos de vos fournisseurs
- ...en définitive, copiez tous les dossiers sauf /img/admin et /img/jquery-ui.
/modules. Ne copiez que les modules que vous avez ajoutés à l'installation par défaut.
/themes/votreTheme. Ne copiez que votre propre thème. Si vous utilisez le thème par défaut de PrestaShop (non modifié), ne copiez pas ce dossier, vous devriez utiliser le thème par défaut de la nouvelle version. Si vous utilisez une version modifiée du thème par défaut, copiez ce dossier mais renommez-le, ne conservez pas le nom de dossier /default tel quel.
/download et /upload. Contiennent vos produits téléchargeables, les fichiers attachés, et les produits personnalisables. Si vous n'utilisez pas ces fonctionnalités, ne copiez pas ces dossiers.

/classes. Dans le cas où vous avez ajouté des classes personnalisées dans ce dossier, copiez-les vers le nouveau dossier /classes.

Si vous faites une mise à jour depuis une version inférieure à la 1.4, vous devrez faire des modifications manuelles aux classes de PrestaShop. Vous n'avez à modifier à la main que celles que vous avez personnalisées. Pour qu'elles puissent fonctionner correctement avec la dernière version de PrestaShop, toutes les classes doivent recevoir un nouveau suffixe pour leur nom, "Core". Ne le faites que si vous êtes à l'aise avec les fichiers PHP.
Voici comment vous devez modifier les fichiers personnalisés que vous souhaitez conserver :

- Ouvrez tous les fichiers de classe, et trouvez ceux dont le nom de classe ne se termine pas par Core. Si vous faites une mise à jour depuis une version 1.4, vous ne devriez pas en trouver (sauf pour vos classes personnalisées, peut-être).
- Changez le nom de la classe, en lui ajoutant Core à la fin. Par exemple, "MyClass" devient "MyClassCore".
  Ne changez que le nom de la classe PHP dans le fichier, pas le nom du fichier lui-même !
- Si tous les fichiers ont déjà "Core" dans leur nom de class (par exemple "class AttributeCore extends ObjectModel"), alors vous n'avez rien à faire.
Enregistrez les fichiers modifiés.

/config. Ne copiez que le fichier settings.inc.php, puis, si vous avez modifié vos identifiants de base de données (normalement, vous n'auriez pas dû avoir à le faire), mettez à jour ou contrevérifiez toutes les lignes qui contiennent "DB_SERVER", "DB_NAME", "DB_USER" et "DB_PASSWD".

Placer le dossier /prestashop sur votre serveur FTP

Le dossier prestashop que vous aviez décompressé contient maintenant toutes les modifications en provenance de votre dossier "Sauvegarde" (et donc, de votre boutique actuelle). La prochaine étape consiste à mettre ce dossier en ligne sur votre serveur.

Si le dossier de votre boutique en ligne se nomme déjà /prestashop, donnez un autre nom au dossier /prestashop de votre disque dur avant de le mettre en ligne.

Si vous renommez le dossier /prestashop, n'oubliez pas de modifier le fichier config/settings.inc.php en conséquence, comme expliqué dans l'étape 2.

À l'aide de votre client FTP, mettez le dossier /prestashop en ligne, au même niveau que le dossier contenant votre boutique actuelle si celle-ci n'est pas à la racine du serveur.

Tout vérifier avant d'aller plus loin

Prenons l'exemple selon lequel votre nom de domaine est http://www.myprestashop.com.

Pour tester la mise à jour, vous avez d'abord téléchargé la dernière version de PrestaShop.
Vous avez ensuite décompressé cette version, et l'avez stockée dans le dossier local /prestashop.
Vous avez copiez vos fichiers personnalisés depuis votre sauvegarde locale vers ce nouveau dossier /prestashop.
Vous avez mis le dossier /prestashop en ligne sur votre serveur FTP, et vous pouvez y accéder sans problème à l'adresse http://www.myprestashop.com/prestashop (ce qui devrait afficher une page blanche, et non un message d'erreur).

Téléchargé PrestaShop
Décompressé le fichier .zip
Copié manuellement vos fichiers de l'ancien dossier au nouveau
Mis en ligne le dossier /prestashop sur votre serveur FTP

Si vous avez répondu oui à toutes les questions ci-dessus, passez à l'étape 3.

Troisième étape – Lancer la mise à jour

Lancement du script de mise à jour

Rendez-vous sur l'adresse en ligne du script de mise à jour, par exemple http://www.myprestashop.com/prestashop/install/upgrade/upgrade.php (remplacez "myprestashop.com" par le vrai nom de domaine de votre boutique, et "prestashop" par le nom du dossier que vous venez de transférer sur votre FTP).

Si l'adresse renvoie une erreur 404, peut-être avez oublié certains fichiers de la dernière version de PrestaShop 1.5. Refaites les différentes étapes du processus.

Ne touchez plus à votre navigateur web ! Ne le fermez pas, ne cliquez pas sur le bouton retour : le script de mise à jour travaille, et cela peut prendre plusieurs minutes. Laissez-le faire !

Terminer la mise à jour

Une fois la mise à jour terminée, un fichier XML devrait s'afficher dans votre navigateur. C'est absolument normal, mais cela peut vous surprendre, car l'affichage ne ressemble pas à une page web classique, et chaque navigateur web a sa propre manière de l'afficher. Par exemple, Firefox affichera d'abord un message d'avertissement, "Aucune information de style ne semble associée à ce fichier XML. L'arbre du document est affiché ci-dessous", au-dessus du contenu du fichier XML lui-même. Ce sera amélioré dans les versions ultérieures du script.

La page doit commencer par la ligne suivante :

<action result="ok" error="">

C'est le "ok" qui compte : ça a marché ! Le plus dur est fait, restent les détails.

Sur votre serveur FTP, dans le dossier "prestashop", vous devriez effacer :

Le dossier /install, qui contient le script d'installation.
Les fichiers README, qui contiennent des informations sur votre installation de PrestaShop.
Le fichier CHANGELOG, qui contient des informations sur les dernières modifications apportées à PrestaShop.

Vous pouvez maintenant vous rendre sur votre boutique à l'adresse publique (http://www.myprestashop.com/prestashop dans notre exemple), qui devrait afficher la page de maintenance avec votre logo, étant donné que votre boutique est censée être en mode de maintenance.

Si cette page de maintenance ou votre thème n'apparaît pas, mais qu'à la place vous obtenez un message disant "Votre thème n'est pas disponible : -nom du thème'. Veuillez vérifier le nom du répertoire du thème et ces permissions", alors vous avez sans doute oublié de copier votre thème vers le dossier /prestashop.

Depuis le dossier /themes de votre dossier "Sauvegarde", copiez votre thème vers le dossier /prestashop/themes. Rechargez le contenu de votre navigateur pour voir la page de maintenance – ou votre thème.

Si votre logo ne s'affiche page, mais qu'à la place vous avez un logo "YourLogoHere", alors vous avez sans doute oublié l'étape où vous deviez copier vos images personnalisées vers le dossier /prestashop.

Relisez l'étape 2 de ce chapitre ("Deuxième étape – Se préparer pour la nouvelle version") afin de copier les bons fichiers et dossiers.

Maintenant, rendez-vous sur la page d'administration de votre boutique, avec du nom de dossier /admin que vous aviez renommé. Vous devrez vous connecter à l'aide de vos identifiants. Vous pouvez désormais profiter de toutes les fonctionnalités de cette nouvelle version !

Lancé l'outil de mise à jour.
Terminé l'installation en effaçant les dossiers et fichiers inutiles.
Vérifié que vous êtes toujours en mode maintenance.
Fait en sorte que vous avez bien copié tous les fichiers personnalisés.
Vérifié que vous pouvez accéder à vos pages d'administration les unes après les autres.

Si vous avez répondu oui à toutes ces questions, félicitations ! Passez à l'étape 4.

Quatrième étape – tests et assurance qualité

Importer vos traductions

Si vous avez exporté vos traductions personnalisées durant la première étape), il vous faut les importer dans votre nouvelle boutique en vous rendant dans la page "Traductions" du menu "Localisation", et utiliser le formulaire de la section "Ajouter / Mettre à jour une langue".

Vérification de votre nom de domaine

Vous devez vérifier que le nom domaine assigné dans la base de données correspond à celui avec lequel vous travaillez. Pour ce faire, rendez-vous dans la page "SEO & URLs", sous le menu "Préférences".

Vérifiez les informations suivantes, dans la section "URL de la boutique" :

"Chemin" : il doit s'agir du nom de domaine auquel vous êtes connecté. Si ce n'est pas le cas, tous les liens de votre boutique ne fonctionneront pas, car ils pointeront vers un autre domaine.
"Domaine" : il doit s'agir du dossier que vous avez transféré sur vos serveurs FTP ; dans ce tutoriel, il s'agit de /prestashop.

Tests à faire sur votre boutique

Pour vous assurer que tout fonctionne correctement sur votre boutique mise à jour, nous vous recommandons de faire les tests suivants :

Charger tous les types de pages (accueil, catégorie, produit, comparaison, CMS, etc.)
Créer un compte client
Faire une commander (ajouter des produits à un panier et valider)
Vérifier que le paiement se passe sans problème (carte de crédit, PayPal, etc.)
Dans le back-office, vérifier que les commandes passées sont bien reçues
Envoyer un e-mail depuis la page de contact, récupérer votre mot de passe
Relire la facture
Vérifier les fonctionnalités de tous les modules que vous avez activés

Cette liste est loin d'être exhaustive, vous devriez faire autant de tests que possible, et créer les vôtres.

Si tous vos tests se passent sans problème, félicitations ! Passez à l'étape 5.

Cinquième étape – Relancer votre boutique mise à jour

Échanger votre boutique à jour et votre boutique en production

Félicitations, vous êtes parvenu sans encombre au bout du processus de mise à jour !

Mais la boutique à jour est encore hors de portée de vos clients : pour le moment, vous seul savez que l'adresse /prestashop contient votre nouvelle boutique, tous vos visiteurs continuent de passer par l'adresse public habituelle.

Il vous faut donc faire l'échange entre les deux boutiques.

Depuis le début du processus de mise à jour, votre boutique en production doit être désactivée ! C'est d'autant plus important pour cette étape !

Deux possibilités s'offrent à vous :

Sur votre serveur FTP, sélectionnez l'intégralité du contenu du dossier /prestashop et glissez le dans le dossier de votre boutique de production. Cette option est la plus rapide. Si votre client FTP vous le propose, confirmez que vous voulez écraser tous les anciens fichiers.

...ou...

Vous pouvez télécharger l'intégralité du dossier à jour (/prestashop) depuis votre serveur FTP vers votre ordinateur, puis mettre tous les fichiers de ce dossier en ligne, à l'emplacement du dossier de la boutique en production. Cette option prendra plus de temps, et une fois de plus il vous faudra confirmer que vous voulez écrasez les anciens fichiers.

Activer votre boutique

Enfin, rendez-vous dans la page "Maintenance" du menu "Préférences" afin de réactiver votre boutique : choisissez "Oui" pour l'option "Activer la boutique".

Allez à la page d'accueil de votre boutique, et parcourez-en toutes les pages afin de vous assurer que tout fonctionne correctement.

C'est terminé ! Félicitations, vous avez terminé votre mise à jour vers la dernière et meilleure version PrestaShop !