Woocommerce - Informations de suivi et des points relais

 

Vous avez installé le module Boxtal Connect pour Woocommerce et vous voulez ajoutez dans les emails pour vos clients les informations de suivi ou du point relais ? 

Depuis la version 1.2.11 du module Boxtal Connect, vous pouvez utiliser nos hooks pour récupérer le numéro de suivi du transporteur avec le lien de suivi et le détail du point relais. 

 

🚚 Récupérer les informations de suivi

[Vous êtes e-commerçant] Pour ajouter la référence du transporteur avec le lien de suivi, ajoutez la ligne de code ci-dessous dans le code de l'email que vous envoyez à vos clients. 

/*
* @hooked Api_Action::print_tracking_number() Prints shipping number
*/
do_action( 'boxtal_connect_print_tracking_number', $order);

Les informations de suivi s'afficheront comme ceci :

💡 Astuce : Si vous souhaitez modifier l'affichage par défaut proposé par Boxtal, vous pouvez modifier le fichier html-order-tracking.php qui se trouve dans :

Boxtal/BoxtalConnectWooCommerce/assets/views/html-order-tracking.php

Si vous rencontrez des difficultés, demandez de l'aide à votre webmaster.

 

[Vous êtes développeur] Dès qu'il y a du suivi sur une commande, vous pouvez récupérer toutes les informations de suivi en utilisant la ligne de code ci-dessous.

/*
* @hooked Api_Action::get_tracking() Prints shipping number
*/
do_action( 'boxtal_connect_get_tracking', $order);

 

📍 Récupérer le détail du point relais

[Vous êtes e-commerçant] Pour rappeler le point relais choisi par votre destinataire, ajoutez la ligne de code ci-dessous dans le code de l'email que vous envoyez à vos clients. 

 

/*
* @hooked Api_Action::print_order_parcelpoint() Prints parcel point details
*/
do_action( 'boxtal_connect_print_parcelpoint', $order);

Les informations du point relais s'afficheront comme ceci :

💡 Astuce : Si vous souhaitez adapter l'affichage existant dans le module Boxtal à vos documents, vous pouvez modifier le fichier html-order-parcelpoint.php qui se trouve dans :

Boxtal/BoxtalConnectWooCommerce/assets/views/html-order-parcelpoint.php

Si vous rencontrez des difficultés, demandez de l'aide à votre webmaster.

 

[Vous êtes développeur] Si un point relais a été choisi pour votre commande, vous pouvez récupérer toute l'information du relais (il faudra ensuite gérer l'information retournée) en utilisant :

/*
* @hooked Api_Action::get_order_parcelpoint() Prints shipping number
*/
do_action( 'boxtal_connect_get_parcelpoint', $order);

🔗 Où ajouter les hooks ?

Si vous souhaitez enrichir vos emails WooCommerce avec le numéro de suivi ou le point relais, il suffit d'ajouter les lignes de code ci-dessus.

Pour les emails WooCommerce par défaut, vous pouvez éditer le modèle directement depuis : 

WooCommerce > Réglages > E-mails > Sélectionner un e-mail > Gérer. 

Si vous modifiez votre modèle pour la première fois, vous devez copier le fichier dans le thème en cliquant sur: 

Copier le fichier dans le thème > voir modèle. 

📧 Une fois que vous accédez au modèle, il suffit de coller la fonction 'do_action' où vous le souhaitez dans votre template qui vous permettra d'insérer le code à cet endroit. 

✔️ Après l'enregistrement des changements, pensez à faire des tests avec des commandes qui ont un suivi (le bordereau est déjà généré) et/ou avec des points relais, pour vérifier que l'affichage est correct. 

Voici un exemple en ajoutant les deux les fonctions dans le modèle: 

Si vous utilisez le template WooCommerce par défaut, nous vous conseillons de renseigner les informations après les détails des clients (woocommerce_email_customer_details) .

Les informations s'afficheront dans votre mail : 

 

🚨 Un problème ?

Si vous rencontrez des difficultés, n'hésitez pas à communiquer ces informations à la personne qui gère votre site pour vous aider avec la mise en place. Le support technique Boxtal ne pourra pas faire la modification pour vous.