Aller au contenu principal

Intégration Widget : Placez les Dates de Livraison N'importe Où

Le module Estimated Delivery n'est pas limité à la position par défaut sur la page produit. Vous pouvez placer le widget de date de livraison n'importe où dans votre boutique — que vous utilisiez un constructeur de pages glisser-déposer ou que vous préfériez travailler directement dans des modèles PHP.

Deux approches sont disponibles, décrites dans des sections séparées ci-dessous :

  • PrettyBlocks — glisser-déposer, aucune programmation requise, convient à la plupart des commerçants
  • PrestaShop WidgetInterface — pour les développeurs qui souhaitent un contrôle total sur le positionnement

Aucune configuration n'est nécessaire pour activer l'une ou l'autre approche. L'interface widget est toujours disponible, et les blocs PrettyBlocks apparaissent automatiquement dès que PrettyBlocks est installé sur la même boutique.


PrettyBlocks : Blocs Glisser-Déposer

Si votre boutique utilise PrettyBlocks, deux blocs sont enregistrés automatiquement dès l'installation du module Estimated Delivery à ses côtés.

Identifiant du blocCe qu'il fait
estimateddelivery_productAffiche la date de livraison pour le produit actuellement sur la page. Placez-le n'importe où dans une mise en page de page produit — il récupère le produit automatiquement, aucun ID manuel n'est nécessaire.
estimateddelivery_cartAffiche les informations de livraison dans le contexte du panier actuel. Utilisez-le dans les mises en page de page panier pour rassurer les clients avant le passage en caisse.

Ouvrez l'éditeur PrettyBlocks, trouvez l'un ou l'autre bloc dans la bibliothèque de blocs, et faites-le glisser dans n'importe quelle zone de mise en page. Les deux blocs affichent le même message de livraison que vous avez configuré dans les paramètres du module — ce ne sont pas des designs séparés, c'est le même widget intégré dans un nouvel emplacement.

Quand utiliser chaque bloc

Utilisez estimateddelivery_product pour ajouter des dates de livraison à une section de page produit personnalisée que vous avez créée avec PrettyBlocks. Utilisez estimateddelivery_cart lorsque vous souhaitez afficher les attentes de livraison au moment du passage en caisse, réduisant ainsi l'hésitation avant que le client ne passe la commande.


Pour les Développeurs : PrestaShop WidgetInterface

Le module implémente le WidgetInterface de PrestaShop, ce qui signifie que n'importe quel modèle PHP ou module personnalisé peut demander le HTML de date de livraison et l'afficher où il le souhaite.

C'est utile lorsque vous souhaitez :

  • Intégrer des dates de livraison dans un modèle de thème personnalisé (fichier .tpl)
  • Afficher des dates de livraison sur une page de catégorie ou de destination
  • Créer un bloc personnalisé pour un constructeur de pages autre que PrettyBlocks

Comment l'appeler

$deliveryHtml = Module::getInstanceByName('estimateddelivery')
->renderWidget('displayProductAdditionalInfo', [
'id_product' => $idProduct,
'id_product_attribute' => $idProductAttribute,
]);
  • Utilisez displayProductAdditionalInfo lorsque vous avez un contexte produit (passez id_product et id_product_attribute).
  • Utilisez displayShoppingCart pour le contexte panier.

La méthode retourne une chaîne HTML que vous pouvez afficher directement dans votre modèle. Si aucune date de livraison n'est configurée pour le produit, elle retourne une chaîne vide — l'appel est donc sûr à effectuer de façon inconditionnelle.


Foire Aux Questions

Cela fonctionne-t-il avec des constructeurs de pages autres que PrettyBlocks ?

Des blocs glisser-déposer natifs sont fournis uniquement pour PrettyBlocks. Pour d'autres constructeurs — comme Creative Elements ou Elementor pour PrestaShop — vous pouvez utiliser l'approche WidgetInterface : appelez renderWidget() depuis un bloc HTML ou PHP personnalisé que votre constructeur expose.

Puis-je afficher des dates de livraison sur une page de catégorie ou de destination ?

Oui. Appelez renderWidget() avec l'ID produit et l'ID d'attribut du produit que vous souhaitez afficher, et affichez le résultat dans votre modèle. Cela fonctionne sur n'importe quelle page, pas uniquement sur la page produit standard.

Le bloc PrettyBlocks s'affiche vide — que dois-je vérifier ?

Confirmez d'abord que PrettyBlocks est installé et actif. Ensuite, vérifiez que la date de livraison est configurée pour le produit en question — si aucune règle ne correspond au produit, le bloc retourne une sortie vide par conception. Vous pouvez vérifier la configuration dans la section Règles de Livraison du module.

Dois-je faire quoi que ce soit pour activer ces fonctionnalités ?

Non. Le WidgetInterface est toujours actif. Les blocs PrettyBlocks s'enregistrent automatiquement lorsque le module Estimated Delivery et PrettyBlocks sont tous les deux installés. Il n'y a aucun bouton à activer ni étape de configuration supplémentaire.