Servlet ExperSHOP Lite


Page Principale Table

Pour tout rapport de bug ou suggestion, envoyez un mèl au Support ExperLog


Servlet ExperSHOP Lite

Son rôle principal est d'interpréter des pages DynHtml, pour générer dynamiquement du contenu HTML.

Tout ce qui concerne la gestion de la session client (déterminer qui est connecté) et du panier d'achats est transparent pour l'utilisateur.

ExperSHOP Lite se compose d'un seul servlet:

  • com.expershop.lite.ExperSHOP est le servlet ExperShop Lite : dites-lui quelle page DynHtml afficher, et quelle action éxécuter.
    Le servlet ExperSHOP Lite tient à jour le contenu du panier d'achats du client.
    En particulier, le servlet ExperSHOP dispose d'un paramètre appelé ShoppingCart, qui permet d'itérer sur le contenu du panier d'achats, d'afficher le prix total des produits présents dans le panier, etc...

Paramètres HTTP

Le servlet ExperShop a besoin des paramètres HTTP suivants :
  • Page: La page DynHtml à afficher, en relatif par rapport au répertoire ESRootDir/ESTemplates/Shop (OBLIGATOIRE)
  • Action: L'action à effectuer avant d'afficher la page (FACULTATIF)
    Exemple: l'action prédéfinie ESAddToCart sera utilisée pour ajouter un article dans le panier d'achats, avant d'afficher son contenu.
    Voir le Guide des Actions ExperSHOP pour plus de détails.
  • ActionFailed: La page DynHtml à afficher en cas d'échec d'una action (FACULTATIF, n'a de sens que si le paramètre Action est défini).
  • Cache: Si ce paramètre est présent (et quelle que soit sa valeur), la prochaine page sera mise dans le cache du browser (par defaut, le cache est désactivé).
  • La valeur du "cookie" ExperSHOP Lite: nécessaire à ExperSHOP pour savoir qui est connecté.
  • Tout autre paramètre qui peut être nécessaire à ExperSHOP pour interpréter la prochaine page DynHtml (par exemple, une Référence Produit pour afficher une page DynHtml qui détaille les propriétés d'un produit).
La première fois que le servlet est appelé, un nom de boutique peut lui être spécifié, en utilisant un paramètre HTTP appelé "S_": ce paramètre est nécéssaire si vous souhaitez supporter plusieurs boutiques.

Exemple:

<a href=com.expershop.lite.ExperSHOP?S_=SurfShop>Surf Shop</a><br>
<a href= com.expershop.lite.ExperSHOP?S_=Supermarket>
Faites vos courses!</a><br>
Exemple de lien HTTP vers une page ExperSHOP, dans une page DynHtml (liste des rayons de la boutique) :
<a href=
com.expershop.lite.ExperSHOP?$COOKIE$&Page=ESListeRayons.tmpl>
Rayons</a>
$COOKIE$ sera remplacé par toute l'information nécessaire à ExperSHOP pour savoir qui est connecté.
Page dit à ExperSHOP quelle page DynHtml afficher lorsque l'utilisateur clique sur le lien.

Voir le Guide DynHtml pour plus de détails.

Panier d'achats, et autres "Data Sets" prédéfinis

Dans les pages DynHtml, vous pouvez boucler sur des "data sets" (jeux de données, comme par exemple des résultats de requêtes SQL) et afficher leur contenu.

Certains "Data Sets" sont prédéfinis, et toujours accessibles:

  • Le panier d'achats (nom du data set: ShoppingCart): voir le document utilisation du panier d'achats.
  • Le fichier de configuration de la boutique (nom du data set: ShopConfig) : chaque propriété définie dans le fichier de configuration peut être affichée dans une page DynHtml, en spécifiant $ShopConfig:[nom-de-propriete]$; par exemple, $ShopConfig:shop.Currency$ affiche la valeur de la propriété shop.Currency (devise utilisée).
  • La date courante (nom du data set: CurrentDate): voir le document utiliser les dates dates.