Balise : url

La balise wcf:url crée une URL et applique les règles de réécriture HCL Commerce prises en charge appropriées.
La balise wcf:url contient les ajouts suivants par rapport à la balise c:url :
  • La balise wcf:url crée des URL compatibles SEO si le SEO est activé pour HCL Commerce.
  • La balise ajoute un préfixe à l'URL avec le protocole approprié, HTTP ou HTTPS, selon les fichiers de configuration Struts.
  • Par défaut, la balise crée une URL de chemin d'accès complet, plutôt qu'un chemin d'accès relatif.
    Remarque : Pour permettre à l'URL de créer un chemin d'accès relatif à la place, ajoutez la ligne suivante au fichier instance.xml, en tant qu'enfant direct au nœud <config> :
    
<UrlTagConfiguration useRelativePath="true" />
<SEOConfiguration defaultUrl="" dynamicURL="true" enable="true" constructUrlWithoutHost = "true"/>

Informations sur la balise
Informations sur la balise
Contenu de l'élément 'Body' vide

Attributs

Attributs
Attribut Requis Date/heure de la requête Type Description
var false true java.lang.String Nom de la variable de portée exportée pour l'URL traitée.
value true
  • true pour les espaces de travail
  • false pour tous les autres cas
 true java.lang.String URL à traiter ou nom mappé utilisé dans le fichier SEOUrlMapper.xml.
patternName false true java.lang.String Nom de modèle défini dans les fichiers de canevas de pattern. Ce modèle est utilisé pour construire l'URL SEO. La valeur peut être égale à l'attribut de nom des pattern définis pour le magasin.
context false true java.lang.String Nom du contexte lorsque vous spécifiez une ressource URL relative qui appartient à un contexte étranger.
scope false true java.lang.String Portée de la variable spécifiée par var.
type false true java.lang.String Spécifie si l'URL actuelle est utilisée dans un appel Ajax. Les valeurs de type valides sont Ajax ou Base. La valeur par défaut est Base. Si la valeur de type est Ajax, le schéma de l'URL est tiré de la requête en cours, plutôt que du fichier de configuration Struts.
Remarque : L'attribut value ou patternName est obligatoire. Si des espaces de travail sont utilisés, value et patternName sont requis. Si l'attribut value et l'attribut patternName sont fournis et que le SEO est activé dans le fichier wc-server.xml comme indiqué dans l'exemple suivant, les URL sont construites à l'aide des définitions de canevas de pattern. La préférence est donnée à l'attribut patternName par rapport à l'attribut value lorsque les deux attributs sont spécifiés. 
<SEOConfiguration enable="true" dynamicUrl="true" defaultUrl="www.madisons.com">
  <context-root-rewrite value="/shop"/>
  <mapper-class-name value="com.ibm.commerce.seo.url.helpers.SEOURLMapperImpl"/>
</SEOConfiguration>
Si la construction de l'URL à l'aide de l'attribut patternName échoue (à la suite d'un patternName non valide ou d'un paramètre manquant), des URL dynamiques sont construites lorsque l'attribut dynamicUrl est défini sur true. Si l'attribut dynamicUrl est défini sur false, la balise wcf:url renvoie la valeur defaultUrl spécifiée dans le fichier wc-server.xml.

L'ordre de création d'URL est :

  1. Si le SEO est activé et que l'attribut patternName est spécifié, l'attribut patternName construit une nouvelle URL SEO.
    1. Si une nouvelle construction d'URL SEO échoue et que dynamicUrl = true, une URL dynamique est construite.
    2. Si dynamicUrl = false, une defautUrl est construite
  2. Sinon, l'attribut value est utilisé et une URL SEO de style plus ancienne est construite.

Variables

Aucune variable n'est définie pour la balise wcf:url.

Exemple

L'exemple suivant forme une URL pour afficher le panier à l'aide de la balise wcf:url. Il spécifie le type d'URL en tant qu'appel Ajax.

<wcf:url var="currentShoppingCartLink" value="ShopCartPageView" type="Ajax">
   <wcf:param name="storeId" value="${WCParam.storeId}"  />
   <wcf:param name="catalogId" value="${WCParam.catalogId}" />
   <wcf:param name="langId" value="${WCParam.langId}" />
</wcf:url>