Comparaison de produits : installation et aide

Dans "Modules > Module Manager", téléversez le ZIP mprcompare, installez-le et cliquez sur "Configure". Sur PrestaShop 1.6, utilisez l'écran de téléversement des modules disponible dans cette version. "Configure" ouvre Configuration, avec le formulaire Paramètres de comparaison.

Nécessite PrestaShop 1.6.1 ou une version ultérieure et PHP 7.1 ou une version ultérieure.

En multiboutique, choisissez le contexte de boutique souhaité avant d'enregistrer. Les réglages sont résolus dans l'ordre boutique, groupe de boutiques, puis toutes les boutiques. Utiliser la valeur héritée supprime un choix local. Utiliser le maximum hérité permet à une boutique ou un groupe d'hériter de la limite de produits. Consultez la description Portée des paramètres dans le formulaire.

Ouvrez une catégorie et sélectionnez des produits à l'aide de leurs boutons de comparaison. Les fiches produits proposent également la comparaison. Le compteur de l'en-tête est actualisé lorsque vous modifiez la sélection. Vous pouvez poursuivre la sélection dans différentes catégories.

Ouvrez la page de comparaison depuis l'en-tête ou la barre flottante. Son URL habituelle sans réécriture est /index.php?fc=module&module=mprcompare&controller=comparator ; /module/mprcompare/comparator est la forme réécrite. Laissez le module générer les liens pour votre boutique.

Le tableau charge les données actuelles du catalogue. Il peut afficher les images, noms, prix et anciens prix, disponibilités, marques, références, poids, EAN-13, caractéristiques, descriptions courtes et liens des produits. Les champs dépendent des données disponibles. Les lignes de caractéristiques avec plusieurs valeurs distinctes sont mises en évidence, y compris pour deux produits aux valeurs différentes.

Les sélections comprennent l'identifiant du produit, l'identifiant de la déclinaison et la quantité. Sur une fiche produit, le module lit la déclinaison et la quantité sélectionnées lorsque le thème les expose. Les sélections sont stockées dans le localStorage du navigateur sous mprcompare:shop:<shop ID>. Elles appartiennent à ce navigateur et à cette boutique. Ce ne sont ni des enregistrements du compte client ni une URL de comparaison partageable. Si le stockage du navigateur est bloqué, la sélection ne reste disponible que sur la page actuelle.

Vous ne pouvez ni choisir les lignes de comparaison ni restreindre les catégories dans le formulaire de configuration. Maintenez des noms de caractéristiques cohérents et des données de catalogue complètes avant de comparer des produits.

Sur PrestaShop 1.7 et versions ultérieures, l'installation enregistre :

actionFrontControllerSetMedia
displayProductListFunctionalButtons
displayProductListReviews
displayProductButtons
displayAfterProductAddCartBtn
displayProductActions
displayNav2
displayBeforeBodyClosingTag

Sur PrestaShop 1.6, elle enregistre les trois hooks produit communs ainsi que displayHeader, displayNav et displayFooter. Le thème doit afficher un hook approprié.

Si vous gérez une fiche produit miniature personnalisée, vous pouvez ajouter un déclencheur avec un véritable identifiant de produit :

<a href="#" class="btn-mprcompare js-mprcompare-toggle"
   data-id-product="123" data-id-product-attribute="0" data-quantity="1"
   title="Compare">Compare</a>

Utilisez la feuille de style de votre thème pour .btn-mprcompare, .mprcompare-active, .mprcompare-floating et .mprcompare-table .text-primary. Les surcharges de modèles du thème utilisent :

themes/your_theme/modules/mprcompare/views/templates/front/comparator.tpl
themes/your_theme/modules/mprcompare/views/templates/front/comparator-16.tpl

Format des requêtes pour les développeurs

Le point d’accès accepte un tableau JSON selections. Les requêtes utilisant à la place ids ou id_product ne sont pas prises en charge.

POST /index.php?fc=module&module=mprcompare&controller=actions
action=getProducts&ajax=1&selections=[{"id_product":12,"id_product_attribute":0,"quantity":1},{"id_product":34,"id_product_attribute":0,"quantity":1}]

Encodez selections au format formulaire dans une requête réelle. Pour action=getProductImage, envoyez exactement une sélection dans ce tableau. Le point d'accès vérifie l'accès à la boutique et la validité des déclinaisons. Ne remplissez pas le stockage avec l'ancien tableau d'identifiants de produits seuls.

1. Ajoutez deux produits accessibles avec des valeurs de caractéristiques différentes.
2. Vérifiez le compteur de l'en-tête et les miniatures flottantes.
3. Ouvrez la comparaison et vérifiez les prix actuels, le stock et la mise en évidence des caractéristiques.
4. Supprimez un article, puis videz la liste.
5. Rechargez et recommencez avec une autre déclinaison sur une fiche produit.

Si les boutons sont absents, vérifiez Activer la comparaison de produits, la portée de boutique actuelle et les hooks du thème. Si la comparaison est vide, vérifiez le stockage du navigateur, la visibilité du produit dans la boutique et la réponse de actions dans les outils de développement du navigateur. Un produit supprimé du catalogue ou une déclinaison non valide peut être omis. Effacez le stockage de comparaison de la boutique dans le navigateur s'il contient des sélections obsolètes.

Si rien ne se charge après un échec de configuration, consultez la page "Integrity" du module. Les échecs de lecture de la configuration désactivent la comparaison plutôt que de l'activer avec des réglages incertains.

Désinstallez via "Module Manager". Le module supprime sa configuration et son menu d'administration. Les sélections du navigateur sont stockées séparément et ne sont pas effacées à distance par la désinstallation du module. Supprimez les déclencheurs ou les surcharges du thème ajoutés manuellement.