Contenu
| Table of Contents | ||
|---|---|---|
|
...
Mise à jour manuelle
La mise à jour manuelle est un 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.
...
| Tip | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Une grande partie du processus se déroule au sein d'un serveur web installé sur votre ordinateur. Avant de vous lancer, téléchargez et installez le serveur local de votre choix : WAMP, XAMPP, EasyPHP, MAMP, ou autre. Si vous n'avez jamais installé de serveur local, lisez le chapitre "Ce dont vous avez besoin" du Guide de Démarrage, section "Installer PrestaShop sur votre propre ordinateur". Les étapes de la mise à jour de PrestaShop :
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
Désactiver votre boutique
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 le champ "IP de maintenance", situé juste en dessous de la case "Activer la boutique", saisissez votre propre adresse IP, de sorte que vous pouvez continuer à utiliser le front-office de 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. Sauvegarder vos fichiersVous devez récupérer tous les fichiers de votre boutique PrestaShop pour les stocker sur votre ordinateur. Il y a principalement deux manières de les enregistrer :
...ou...
Sauvegarder votre base de donnéesVous 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 :
...ou...
...ou...
Conservez ce fichier dans le dossier "prestashop-prod" de votre ordinateur, que vous devez avoir créé à l'étape précédente et qui devrait déjà contenir vos fichiers. Sauvegarder vos traductions personnaliséesSi 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 :
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é.
Le dossier "prestashop-prod" contient-il...
Vous devez avoir vérifié l'intégralité de votre dossier de sauvegarde, et fait en sorte que tout y soit correct et que, au besoin, vous pourrez récupérer vos données. Si vous avez répondu oui à toutes les questions ci-dessus, passez à l'étape 2. |
...
/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.). Prenez surtout soin de copier ces fichiers et dossiers :logo.jpg- le logo de votre boutiquefavicon.ico- le favicon de votre boutiquelogo_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 du dossier
/img, sauf/img/adminet/img/jquery-ui.
/modules. Ne copiez que les modules que vous avez ajoutés depuis que vous avez installé PrestaShop la première fois (et qui ne font donc pas partie de l'installation par défaut).- Certains de ces modules peuvent ne plus être actuellement activés ou installés : à vous de déterminer s'il peut vous être utile de les avoir sur votre installation mise à jour.
- Notez également qu'il vous faudra peut-être mettre à jour les modules qui n'ont pas été conçus pour cette nouvelle version.
/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 son dossier (
/themes/prestashop) : vous devriez utiliser le thème par défaut de la nouvelle version (/themes/default). - Si vous utilisez une version modifiée du thème par défaut, copiez son dossier.
- Si vous utilisez le thème par défaut de PrestaShop (non modifié), ne copiez pas son dossier (
/downloadet/upload. Contiennent vos produits téléchargeables, les fichiers attachés, et les produits personnalisables. Si vous n'utilisiez 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.Warning Si vous faites une mise à jour depuis une version inférieure à la 1.4, vous devrez faire des modifications manuelles aux classes de PrestaShop que vous avez personnalisé. 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 :- Copiez les fichiers de classe que vous avez personnalisés dans le dossier
/classesde "prestashop-prep". - Ouvrez tous les fichiers de classe que vous avez personnalisés, 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 classe (par exemple "
class AttributeCore extends ObjectModel"), alors vous n'avez rien à faire.
- Copiez les fichiers de classe que vous avez personnalisés dans le dossier
- Enregistrez les fichiers modifiés.
/config. Ne copiez que le fichiersettings.inc.php./translations- si vous utilisez une autre langue que celles disponibles par défaut, vous devrez copier le dossier de votre langue dans le dossier/translationsde votre nouvelle installation. Sans cela, la mise à jour ne fonctionnera pas.
...
- Ouvrir l'outil phpMyAdmin, qui doit être fourni avec votre serveur local. Il est le plus souvent à l'adresse 127.0.0.1/phpmyadmin, ou 127.0.0.1/mysql.
- Si ce n'est pas déjà fait, créez une base de données spécialement pour ce projet. Donnez-lui un nom distinctif, comme "prestashop_update" ou même le nom de la base de données de votre boutique en production, par exemple.
Si vous aviez déjà créé une base de données lors d'un test de mise à jour locale précédent, effacez toutes ses tables. - Ouvrez la base de données, et cliquez sur l'onglet "Importer" situé en haut de l'écran.
Cliquez sur le bouton "Parcourir" et sélectionnez le fichier
.sqlde sauvegarde de votre base de production, qui doit normalement se trouver dans le dossier "prestashop-prod".
Vérifier que la "Taille maximum" affichée par phpMyAdmin est supérieure à la taille du fichier.sql. Si ce n'est pas le cas, il vous faudra modifier le fichierphp.inide votre serveur local, notamment les directivesupload_max_filesize,post_max_sizeet en dernier recours,memory_limit. Ceci fait, relancer vos serveurs Apache et MySQL locaux afin de prendre en compte vos modifications.Tip Au lieu de modifier les réglages du serveur, vous pouvez plus simplement compresser le fichier
.sqlà l'aide d'un outil de gestion Zip, tel que http://www.7-zip.org/. phpMyAdmin devrait accepter les fichier.sql.zip, et se chargera des décompresser le fichier avant d'en importer les données.- Cliquez sur le bouton "Exécuter" pour importer votre fichier SQL.
...
La page doit commencer par la ligne suivante :
| Code Block |
|---|
<action result="ok" error="">
|
...
Toutes les mises à jour ne se terminent pas forcément bien, et les raisons très variées. Pour vous aider, le script de mise à jour vous affiche un code d'erreur au début du résultat XML. En cas d'erreur, la page commence ainsi :
| Code Block |
|---|
<action result="fail" error="27" />
|
...