Showcase Revolution : installation et aide

Téléversez et installez mprshowcaserevolution dans "Modules" > "Module Manager". Cliquez sur "Configure" pour ouvrir le tableau de bord. Utilisez "Improve" > Showcase Revolution pour accéder à "Widgets", "Collections" et Réglages > Paramètres. Le sous-menu Réglages contient aussi Intégrité, Licence, Assistance et Mettre à jour.

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

Pour un premier test, ouvrez "Widgets", ajoutez un widget, saisissez un Titre, choisissez Type de widget: "New Products", Point d’accroche (emplacement): "Homepage (displayHome)", Mise en page: "Grid", Nombre de produits: 8 et Actif: Oui. Saisissez 4 produits par ligne sur ordinateur et 2 sur mobile. Enregistrez et ouvrez la page d’accueil.

Fonctionnalités

Utilisez l’état d’activation du module dans "Module Manager", ou le paramètre Actif d’un widget, pour contrôler l’affichage réel. Le champ de configuration distinct "Enable module" ne remplace pas ces commandes.

Valeurs par défaut des widgets

Il s’agit de préférences globales enregistrées. Les widgets existants possèdent leurs propres champs. Définissez explicitement chaque nouveau widget ; ne supposez pas qu’une modification d’une préférence globale met à jour les valeurs des widgets enregistrés ou préremplit tous les champs de l’éditeur.

Produits tendance

Utilisez la commande de recalcul manuel des tendances du tableau de bord après avoir collecté des vues. Les scores combinent les vues enregistrées et les ventes de commandes valides. Les vues de produits sont enregistrées via actionObjectProductViewAfter ; vérifiez que votre boutique ou votre intégration déclenche ce hook. L’enregistrement des retours en stock utilise actionUpdateQuantity et compare la quantité visible dans le stockage à la nouvelle quantité du hook. Vérifiez cette transition avec votre processus de mise à jour du stock.

Performances

Le HTML contenant un prix ou une commande d’ajout au panier est exclu du cache HTML partagé des widgets. Les sources personnelles en sont également exclues. Les carrousels compatibles avec Warehouse disposent d’un cache supplémentaire pour la sélection et les fiches allégées ; les données personnalisées des produits de la première ligne sont rendues dans le contexte du visiteur.

Styles du thème

Les valeurs par défaut proviennent du système partagé de styles du thème. Le module enregistre --mpr-sc-primary, --mpr-sc-accent, --mpr-sc-filter-bg, --mpr-sc-radius, --mpr-sc-shadow-hover et --mpr-sc-transition. "Card gap" vaut par défaut 16px et fournit --mpr-sc-gap. Modifiez les commandes de style partagées pour ajuster la palette détectée ou les espacements. Les correspondances primary-hover et d’ombre normale ne sont pas disponibles.

L’éditeur comporte les onglets Général, Affichage et Avancé. Les valeurs ci-dessous correspondent aux valeurs par défaut du schéma ; saisissez explicitement les valeurs lorsqu’un nouveau formulaire est vide.

Général

Les sources sont "Best Sellers", "New Products", "On Sale", "Featured Products", "Trending Now", "Curated Collection", "Back in Stock", "Recently Viewed" et "Cart Recommendations". "Recently Viewed" figure dans la liste mais ne renvoie aucun produit; ne la sélectionnez pas pour un bloc fonctionnel.

"Cart Recommendations" nécessite un module MPR Sales Revolution activé, un panier chargé et des produits dans ce panier. Les autres sources fonctionnent indépendamment de cette intégration. "Featured Products" utilise Périmètre de catégorie ou la catégorie de produits mis en avant configurée. Périmètre de catégorie n’est pas appliqué par toutes les sources, notamment les chemins de collection et de recommandations du panier.

Affichage

"Grid", "Slider" et "Carousel" utilisent normalement la miniature produit native du thème sur les versions modernes de PrestaShop. PrestaShop 1.6 dispose d’un template ancien du module. "List" et "Compact" utilisent des templates plus petits du module. Les points et la lecture automatique sont transmis au moteur de rendu actuel du carrousel.

Avancé

Trier par est enregistré, mais les sources automatiques conservent leur propre ordre de requête. Classe CSS est vide par défaut et ajoute une classe au conteneur. CSS personnalisé est vide par défaut et produit un bloc de style. "Position" vaut par défaut 0 et ordonne les widgets au sein d’un hook.

CSS personnalisé n’est pas automatiquement limité au widget. Incluez Classe CSS dans vos sélecteurs :

.homepage-staff-picks .mpr-showcase-widget__title {
  text-transform: uppercase;
}

La base de données enregistre aussi sort_dir avec la valeur par défaut DESC et show_manufacturer avec la valeur par défaut 0 ; ces champs ne sont pas des commandes du formulaire actuel du widget.

Créez une collection avec Nom, une "Description" facultative en texte enrichi, "Type", Date de début, Date de fin, Actif et "Position". Le nom et la description sont vides par défaut, "Type" vaut curated, les dates sont vides, Actif vaut Oui et "Position" vaut 0. Les types incluent curated, staff_picks, seasonal et spotlight.

Ajoutez les produits sélectionnés, réorganisez-les, puis enregistrez un widget avec Type de widget: "Curated Collection" et la "Collection" correspondante. Les produits utilisent leur position enregistrée dans la collection.

Les dates et Actif influencent les requêtes de collections qui demandent uniquement les sélections actives. La recherche directe des produits d’une collection par le widget ne vérifie pas ces champs de planification. Contrôlez un widget de collection avec son propre interrupteur Actif ; ne comptez pas sur les dates de la collection pour masquer un widget déjà affecté.

Par exemple, créez une collection appelée Summer Picks, puis configurez :

Title: Summer Picks
Widget Type: Curated Collection
Collection: your saved collection
Hook (Placement): displayHome
Layout: Grid
Products Count: 8
Active: Yes

Les hooks pris en charge sont :

displayHome
displayFooterCategory
displayLeftColumn
displayRightColumn
displayFooterBefore
displayFooterProduct
displayProductAdditionalInfo
displayOrderConfirmation2
displayCrossSellingShoppingCart
displayNotFound

Le thème doit appeler le hook sélectionné. Pour un pied de page produit personnalisé :

{hook h='displayFooterProduct'}

Il n’existe pas de moteur de rendu de shortcode CMS. Utilisez un hook pris en charge.

Les chemins de surcharge du thème comprennent :

themes/your_theme/modules/mprshowcaserevolution/views/templates/front/widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/_product-miniature-widget.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/list-item.tpl
themes/your_theme/modules/mprshowcaserevolution/views/templates/front/layouts/compact-item.tpl

Les sélecteurs utiles incluent .mpr-showcase-widget, ses modificateurs --grid, --slider, --carousel, --list et --compact, .mpr-showcase-widget__title, .mpr-showcase-widget__subtitle, .mpr-showcase-widget__link, .mpr-showcase-slider__nav, .mpr-list-item et .mpr-compact-item.

1. Vérifiez que votre premier widget "Grid" affiche des produits sur le hook choisi.
2. Passez à "Slider" et testez les flèches, les points et la lecture automatique sur ordinateur et mobile.
3. Vérifiez les commandes de prix et d’ajout au panier dans votre thème réel.
4. Cliquez sur un produit du widget et inspectez la requête trackClick si les enregistrements de clics vous intéressent.
5. Testez séparément une source de collection et de recommandations du panier avant de les réutiliser ailleurs.

Aucun conteneur n’est produit si une source ne renvoie aucun produit affichable. Vérifiez l’état actif, l’association à la boutique actuelle, le hook exact, l’admissibilité de la source, la catégorie, les images de couverture et le nombre de produits. "Best Sellers" nécessite des ventes et "Trending Now" des vues enregistrées ainsi qu’un recalcul. "Back in Stock" nécessite des transitions de stock enregistrées. "Recently Viewed" ne renvoie aucun produit dans cette version.

Si les changements tardent à apparaître, tenez compte des caches fixes de 30 minutes et du cache de votre boutique/thème. Si la planification des collections semble ignorée, utilisez la commande Actif du widget lui-même. Si un thème ignore les indicateurs de prix ou de bouton, examinez son template de miniature.

Exportez ou consignez les widgets et les collections avant la désinstallation. Celle-ci supprime le menu d’administration, l’enregistrement de la gestion des colonnes, l’enregistrement du thème et les tables du schéma appartenant au module, notamment les widgets, les collections, les tendances et les données de suivi. La désinstallation standard supprime les enregistrements de hooks. Si le nettoyage du thème échoue, la méthode s’arrête avant de supprimer le reste de la configuration. Supprimez les appels manuels de hooks du thème et les surcharges que vous avez ajoutés.