Exemple commenté

Exemple commenté d'une implémentation du Widget Mondial Relay

by MondialRelay

HTML

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr" dir="ltr">

  <head>
    <title>Exemple commenté d'une implémentation du Widget Mondial Relay</title>

    <!-- Librairie jQuery, facilitant la programmation de scripts côté client.
Cette librairie est requise par le widget Mondial Relay, 
elle doit être appellée avant la librairie du Widget Mondial Relay.
Le symbole "$" commençant une instruction javascript est caractéristique de l'utilisation de jQuery. -->
    <script src="//ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>

    <!-- Librairie de Cartographie : Leaflet. -->
    <script src="https://unpkg.com/leaflet/dist/leaflet.js"></script>
    <link rel="stylesheet" type="text/css" href="https://unpkg.com/leaflet/dist/leaflet.css" />

    <!-- Widget MR -->
    <script src="https://widget.mondialrelay.com/parcelshop-picker/jquery.plugin.mondialrelay.parcelshoppicker.min.js"></script>
  </head>

  <body>
    <!-- Zone dans laquelle le Widget est chargé -->
    <div id="Zone_Widget"></div>

    <div style="padding:8px; overflow:auto;">
      <div style="background:#edffb2; border:solid 1px #a5f913; padding:5px; font-family:verdana; font-size:10px;">
        <em>Cette zone n'est pas située dans le Widget mais bien dans la page appelante.</em><br/><br/>
        <div style="display:inline-block; vertical-align:top;">

          <!-- La balise ayant pour id "TargetDisplay_Widget" a été paramétrée pour reçevoir 
          l'ID du Point Relais sélectionné -->
          Point Relais Selectionné : <input type="text" id="TargetDisplay_Widget" /><br/>

          <!-- Balise HTML avec id "Target_Widget", paramétrée pour reçevoir l'ID 
          du Point Relais sélectionné -->
          Hidden : <input type="text" id="Target_Widget" /><br/>

          <!--Balise HTML avec id "TargetDisplayInfoPR_Widget" paramétrée pour recevoir 
          l'adresse du Point Relais sélectionné -->
  ...

JavaScript

// Initialiser le widget après le chargement complet de la page
$(document).ready(function() {
  // Charge le widget dans la DIV d'id "Zone_Widget" avec les paramètres indiqués
  $("#Zone_Widget").MR_ParcelShopPicker({
    //
    // Paramétrage de la liaison avec la page.
    //
    // Selecteur de l'élément dans lequel est envoyé l'ID du Point Relais (ex: input hidden)
    Target: "#Target_Widget",
    // Selecteur de l'élément dans lequel est envoyé l'ID du Point Relais pour affichage
    TargetDisplay: "#TargetDisplay_Widget",
    // Selecteur de l'élément dans lequel sont envoysé les coordonnées complètes du point relais
    TargetDisplayInfoPR: "#TargetDisplayInfoPR_Widget",
    //
    // Paramétrage du widget pour obtention des point relais.
    //
    // Le code client Mondial Relay, sur 8 caractères (ajouter des espaces à droite)
    // BDTEST est utilisé pour les tests => un message d'avertissement apparaît
    Brand: "BDTEST  ",
    // Pays utilisé pour la recherche: code ISO 2 lettres.
    Country: "FR",
    // Code postal pour lancer une recherche par défaut
    PostCode: "59000",
    // Mode de livraison (Standard [24R], XL [24L], XXL [24X], Drive [DRI])
    ColLivMod: "24R",
    // Nombre de Point Relais à afficher
    NbResults: "7",
    //
    // Paramétrage d'affichage du widget.
    //
    // Afficher les résultats sur une carte?
    ShowResultsOnMap: true,
    // Afficher les informations du point relais à la sélection sur la carte?
    DisplayMapInfo: true,
    // Fonction de callback déclenché lors de la selection d'un Point Relais
    OnParcelShopSelected:
      // Fonction de traitement à la sélection du point relais.
      // Remplace les données de cette page par le contenu de la variable data.
      // data: les informations du Point Relais
      function(data) {
        $("#cb_ID").html(data.ID);
        $("#cb_Nom").html(data.Nom);
        $("#cb_Adresse").html(data.Adresse1 + ' ' + data.Adresse2);
        $("#cb_CP").html(data.CP);
  ...