Dans Certains cas il peut être intéressant de pouvoir appliquer une condition ou une boucle.
Par exemple dans la composition de vos messages de remerciement, vous pourriez afficher un message selon le montant donation.
Ou bien sur la page de retour avoir du tracking uniquement dans le cas d'une transaction validée.
La Boucle s'applique sur les produits
Conditionnel
Ce short se présente sous la forme : [if] [else] [endif]
Le shortcode [if] indique le début de la condition, toute condition débuté avec [if] doit se terminer par [endif]
[if] indique le début de la condition, il prend trois attributs obligatoires qui sont :
- subject : texte ou un shortcode
- operator : valeurs prédéfini correspondant au type de comparaison :
- superiorTo
- inferiorTo
- equalTo
- value : texte ou un shortcode
[else] permet de définir le comportement si la condition n’est pas respectée.
Exemple:
[if subject="[order_amount]" operator="superiorTo" value="100"]
Plus de 100
[endif]
Affichera si le montant de la transaction est supérieur à 100 : Plus de 100
[if subject="[order_amount]" operator="superiorTo" value="100"]
Plus de 100
[else]
Moins de 100
[endif]
Affichera si le montant de la transaction est supérieur à 100 : Plus de 100
Affichera si le montant de la transaction est inférieur ou égal à 100 : Moins de 100
Il est possible d’imbriquer le shortcode conditionnel jusqu’à 5 niveaux, par exemple :
[if subject="[order_amount]" operator="superiorTo" value="100"]
Don [if subject="[order_type]" operator="equalTo" value="S"]ponctuel[else]régulier[endif] de plus de 100
[else]
Don [if subject="[order_type]" operator="equalTo" value="S"]ponctuel[else]régulier[endif] de moins de 100
[endif]
Permettra d’afficher :
Don ponctuel de plus de 100
Don régulier de plus de 100
Don ponctuel de moins de 100
Don régulier de moins de 100
Boucle
Le short code se présente sous la forme :[foreach_order_items] [endforeach][foreach_order_items] [endforeach] permet de faire une boucle sur les produits, il est possible d’utiliser des shortcodes spécifiques à l’intérieur de cette boucle :
•Le shortcode spécifique [item_id] Identifiant du produit•Le shortcode spécifique [item_name] Nom du produit•Le shortcode spécifique [item_code] Code du produit•Le shortcode spécifique [item_quantity]
Quantité du produit•Le shortcode spécifique [item_amount] Montant du produit, partage le premier groupement d’attribut avec le shortcode [order_amount], à savoir :decimals => nombre de chiffre après la virgule decimal_separator => séparateur des décimales thousands_separator => séparateur des milliers
Exemple d'utilisation : [foreach_order_items]
[item_quantity] fois [item_name]
[endforeach]
Affichera par exemple (en fonction de l'inscription) :
•2 fois lenomdel'article1
•1 fois lenomdel'article2