Widget EnvoiMoinsCher
Le widget EnvoiMoinsCher permet d'inclure une boîte de recherche EnvoiMoinsCher configurable dans une ou plusieurs pages de votre site web. Le widget peut être paramétré selon les besoins spécifiques des utilisateurs de votre site (type de contenu, adresse d'expédition ou de livraison, etc.), et sa présentation est modifiable à l'aide d'une feuille de style.
Comment afficher le widget sur votre site
Pour afficher le widget sur une page de votre site web de la manière la plus simple, il suffit d'insérer le bloc de code HTML suivant dans la page :
<iframe src="http://www.envoimoinscher.com/api/widget.html.vtl?version=1.0"></iframe>
Paramétrage du widget
Dans la ligne de code qui affiche le widget, vous pouvez spécifier des paramètres contrôlant les valeurs par défaut et la présentation du widget.
En utilisant le formulaire ci-dessous, vous pouvez configurer le widget en spécifiant différents paramètres, voir le résultat du paramétrage, et récupérer le code associé pour insertion dans votre site web :
| Paramètres du widget | Widget | Code HTML du widget |
|---|---|---|
|
|
Insérez le bloc de code HTML ci-dessus pour afficher le widget paramètré sur votre site.
|
Liste des paramètres du widget :
Les paramètres du widget sont de trois types, selon qu'ils sont spécifiables :
* par l'utilisateur (client/utilisateur du site),
* lors de la définition du widget sur une page (prescripteur/referrer),
* ou non spécifiables (constructeur).
La table ci-dessous liste tous les paramètres de widget.
| Nom de variable | Description | Valeur exemple ou par défaut ou fixée | Spécifiable | ||
| par l'utilisateur | dans déf. widget | non spécifiable | |||
| groupe_0.poids | Poids en kg | 1 | x | x | |
| groupe_0.longueur | Longueur en cm | 30 | x | x | |
| groupe_0.largeur | Largeur en cm | 20 | x | x | |
| groupe_0.hauteur | Hauteur en cm | 15 | x | x | |
| expediteur.codepostal | Code postal expéditeur | 75008 | x | x | |
| destinataire.codepostal | Code postal destinataire | 75001 | x | x | |
| destinataire.pz_id | Pays destinataire | FRANCE METROPOLITAINE | x | x | |
| type_envoi | Type de conditionnement | Colis | x | ||
| type_objet | Type de contenu | 10100 (Docs. sans val. comm.) | x | ||
| expediteur.collecte_type | Type de collecte expéditeur | adresse résidentielle | x | ||
| destinataire.collecte_type | Type de collecte livraison | adresse résidentielle | x | ||
| groupe_0.nb | Nombre de colis | 1 | x | ||
| date | Date d'envoi souhaitée | 0 (aujourd'hui) | x | ||
| delai_souhaite | Délai de livraison | 1 (délai indifférent) | x | ||
| delai_souhaite | Ordre de tri | 1 (priorité prix) | x | ||
| expediteur.pz_id | Pays expéditeur | FRANCE METROPOLITAINE | x | ||
| stylesheet | Feuille de style (URL) | http://www.envoimoinscher.com/api/widget.css | x | ||
Présentation externe du widget
On peut bien entendu spécifier la présentation externe du widget: avec et sans bordure, plus ou moins petit, positionné dans différentes parties de la page, en utilisant les attributs HTML standard du iframe, comme width, height, frameborder, style, etc.
Exemples :
<iframe style="border: 20px solid blue;" src="/api/widget.html.vtl" width="201" frameborder="0" height="177"></iframe>
<iframe src="/api/widget.html.vtl" width="204" frameborder="1" height="180"></iframe>
À venir
Une version ultérieure du widget permettra à un utilisateur d'intégrer le widget EnvoiMoinsCher dans sa page d'accueil personnalisée ou sur le bureau virtuel de son ordinateur (Gadget Google, Widget Netvibes, Application Facebook, Widgets de bureau Windows, Mac, Google Desktop, ...).
Aussi, à terme, les paramètres d'URL permettront de spécifier non seulement les valeurs par défaut des paramètres de requête, mais aussi si la valeur par défaut doit être affichée dans le widget, et si cette valeur doit être modifiable par l'utilisateur dans le widget.
On peut aussi envisager de produire une version du widget qui n'utilise pas de iframe. Le widget pourrait être affiché sur la page avec du Javascript dynamique produit sur le site de EnvoiMoinsCher. On pourrait également proposer le code XHTML in extenso à intégrer en bloc sur une page.
Si vous souhaitez rester au courant des évolutions du widget EnvoiMoinsCher, envoyez un mail à contact@envoimoinscher.com avec "widget" dans le sujet du mail.