Installer un thème Prestashop : les problèmes fréquents et leurs solutions

Avant de commencer

Quelques étapes préalables vous éviteront bien des surprises :

• Vérifiez la compatibilité du thème avec votre version de Prestashop et avec la version de PHP du serveur sur lequel est installé votre boutique.
• Effectuez une sauvegarde complète de votre boutique (fichiers et base de données).
• Idéalement, mettez en place une copie de test de votre boutique pour tester l'installation sans risque, avant de l'appliquer à votre boutique en production.

Un thème Prestashop s'installe depuis la section Apparence >> Thème et logo de votre back-office, avec le bouton Ajouter un nouveau thème : vous envoyez le fichier zip du thème, puis vous cliquez sur Utiliser ce thème. Prestashop installe alors le thème de manière automatique.

1 - L'envoi du fichier zip échoue

Deux causes reviennent le plus souvent :

• Vous envoyez le mauvais fichier. L'archive téléchargée après votre achat contient souvent la documentation, des fichiers d'exemple et le thème lui-même, dans un second fichier zip. C'est ce second fichier qu'il faut envoyer : il doit contenir directement le dossier du thème, avec son fichier config/theme.yml.
• Le fichier est trop lourd pour votre serveur. La taille maximale des fichiers envoyés est limitée par la configuration de PHP (upload_max_filesize et post_max_size). Demandez à votre hébergeur d'augmenter ces valeurs, ou déposez le fichier zip du thème dans le dossier /themes de votre boutique par FTP, puis choisissez l'option Importer à partir du FTP.

2 - Les images sont déformées ou floues

Chaque thème définit ses propres formats d'images (miniatures des produits, des catégories, des marques…). Ils sont créés à l'activation du thème, mais les images existantes de votre catalogue ne sont pas recalculées. Elles s'affichent alors floues, déformées ou recadrées.

Rendez-vous dans la section Apparence >> Images de votre back-office et procédez à la régénération de vos images via l'encart Regénérer des miniatures en bas de page. Sur un gros catalogue, l'opération peut prendre plusieurs minutes : lancez-la de préférence format par format.

3 - Des modules sont mal placés ou ont disparu

Le fichier theme.yml indique à Prestashop quels modules installer, activer ou désactiver, et à quelles positions les greffer. Lors du changement de thème, certains modules peuvent donc changer de place, être désactivés, ou ne plus s'afficher parce que le nouveau thème ne prévoit pas leur emplacement.

• Vérifiez la liste de vos modules dans la section Modules >> Gestionnaire de modules et réactivez ceux dont vous avez besoin.
• Contrôlez leurs emplacements dans la section Apparence >> Positions.
• Consultez la documentation du thème, qui indique en général les modules utilisés et leurs positions.

4 - Les modifications ne s'affichent pas

Vous avez modifié un réglage ou un fichier du thème, mais rien ne change sur votre boutique ? C'est presque toujours une question de cache :

• Videz le cache de Prestashop dans la section Paramètres avancés >> Performances.
• Videz aussi le cache de votre navigateur, ou testez dans une fenêtre de navigation privée.
• Si votre hébergeur ou un module utilise un système de cache supplémentaire, videz-le également.

5 - Les traductions ou les réglages ne s'enregistrent pas

Lorsque vous enregistrez la traduction du thème (depuis la section International >> Traductions) ou un formulaire de configuration comportant beaucoup de champs, une partie des modifications peut être perdue sans message d'erreur.

La cause est souvent la directive PHP max_input_vars, qui limite le nombre de champs qu'un formulaire peut envoyer (1 000 par défaut). Demandez à votre hébergeur de l'augmenter, par exemple à 10 000, ou modifiez-la vous-même si votre hébergement vous donne accès à la configuration de PHP.

6 - Une fonctionnalité ne marche plus

Un thème peut entrer en conflit avec un module tiers, souvent à cause d'un template de module que le thème modifie, ou d'un script JavaScript. Pour savoir d'où vient le problème :

• Activez temporairement le thème Classic, fourni avec Prestashop, de préférence sur une copie de test de votre boutique.
• Si le problème disparaît, il vient bien du thème : signalez-le à son auteur, en précisant votre version de Prestashop et le module concerné.
• S'il persiste, il vient d'un module ou de votre configuration, et non du thème.

Gardez vos modifications à l'abri

Si vous personnalisez votre thème (couleurs, templates, CSS), ne modifiez pas directement ses fichiers : vos modifications seraient perdues à la prochaine mise à jour. Créez plutôt un thème enfant, qui hérite de tout le thème parent et ne contient que vos modifications.

Et avec le thème Universal ?

Le thème Prestashop Universal s'installe comme n'importe quel autre thème Prestashop, depuis la section Apparence >> Thème et logo de votre back-office. Sa documentation détaille chaque étape de l'installation et de la configuration, pour une boutique opérationnelle en quelques minutes.

Conclusion

La plupart des problèmes rencontrés lors de l'installation d'un thème ne viennent pas du thème lui-même, mais d'une étape oubliée : mauvais fichier zip, miniatures à régénérer, modules à repositionner ou cache à vider. Lisez toujours la documentation du thème, travaillez sur une copie de test de votre boutique, et si un problème persiste, contactez l'auteur du thème en lui donnant un maximum de détails.