La fonctionnalité "sélecteur d'options", ainsi que ses sous-fonctionnalités, vous permet de personnaliser la présentation des options de produits et des langues de commentaires de visite. Grâce à différents paramètres, vous pouvez créer une mise en page hautement personnalisée. Bien que les paramètres par défaut offrent un affichage standard, nous recommandons d’utiliser l’ensemble des sous-fonctionnalités conjointement lors de toute modification afin d’obtenir une personnalisation optimale.
Liste des fonctionnalités du sélecteur d'options
La fonctionnalité "sélecteur d'options" comprend plusieurs sous-fonctionnalités. Ajoutez le bloc de code ci-dessous à votre Checkout Ventrata en utilisant l’une des deux méthodes suivantes :
Syntaxe de personnalisation de l’affichage des options:
la fonctionnalité
optionSelectordoit être placée dans l’objetfeaturesl’ensemble de ses sous-fonctionnalités doit ensuite être enregistrées dans l’objet
optionSelector
Mettre à jour l'attribut Data-Config - en ajoutant le code ci-dessous dans l'attribut data-config de votre script de checkout, voir le Guide d'implémentation pour plus d'informations.
"features": {
"optionSelector": {
"preselectFirstOption": true / false, (default: true)
"placement": "above-tickets" / "separate-step", (default: "separate-step")
"type": "expandable" / "fixed" (default: "fixed")
}
}
📒 REMARQUE
Le simple ajout de la fonctionnalité dans l’attribut data-config active le champ de saisie pour tous les produits du Checkout. Nous recommandons de restreindre cette fonctionnalité à des produits spécifiques en indiquant l'ID du produit (productId) dans l’attribut data-config.
Ajouter la fonctionnalité au script ou au bouton - ajoutez la fonctionnalité à votre data-config pour le script ou le bouton dans le format suivant :
<script
src="https://cdn.checkout.ventrata.com/v3/production/ventrata-checkout.min.js" type="module" data-config='{"apiKey":"<YOUR_API_TOKEN>", "features":{"optionSelector": {"preselectFirstOption": true, "placement": "above-tickets", "type": "expandable" }}}'></script>
📒 REMARQUE
Les modifications apportées au sélecteur d’options ne sont pas prises en compte lorsque l’attribut data-config contient un optionId, étant donné qu’une option a déjà été présélectionnée.
La fonctionnalité "sélecteur d'options" prend en charge les sous-fonctionnalités suivantes :
Sous-fonctionnalité | Par défaut | Valeurs disponibles | Description |
|
|
| Lorsqu’elle est activée, si le produit contient plusieurs options, la première option de la liste est présélectionnée. |
|
|
| Par défaut, les options sont sélectionnées à une étape distincte (c’est-à-dire sur une page séparée). Lorsque les options sont placées au-dessus des billets, la sélection des options s’effectue sur la même page que les billets et les dates de visite. |
|
|
| Le paramètre fixe par défaut s’applique aux deux emplacements en affichant l’ensemble des options disponibles. Le type extensible (expandable) peut être utilisé uniquement avec l’emplacement au-dessus des billets, où les options sont repliées et seule l’option sélectionnée est visible. |
Flux du sélecteur d'options
Le client sélectionne un produit. En fonction des paramètres définis dans le sélecteur d’options, les scénarios suivants peuvent se produire :
Paramètres par défaut
Les langues de commentaires de visite et les options sont affichées sur une page distincte. Les commentaires de visite sont repliés, et l’ensemble des options de produit disponibles est listé sur la page.
📗 ASTUCE
L’ensemble des paramètres par défaut correspond à des comportements standards de sélection des options et n’a donc pas besoin d’être spécifié dans l’attribut data-config.
Paramètres par défaut
Paramètres non standard de la fonctionnalité
Vous pouvez utiliser différentes variations de paramètres :
Les langues de commentaires de visite ainsi que toutes les options de produit disponibles sont affichées sur la page des billets, au-dessus de la sélection des billets. La première option de la liste est présélectionnée.
Sous-fonctionnalité | Paramètre |
|
|
|
|
|
|
Option présélectionnée, au-dessus des billets, fixe
Les langues de commentaires de visite ainsi que l’ensemble des options de produit disponibles sont affichées sur la page des billets, au-dessus de la sélection des billets. Aucune option n’est présélectionnée.
Sous-fonctionnalité | Paramètre |
|
|
|
|
|
|
Présélection : Faux, Au‑dessus des billets, Fixed
Les langues des commentaires de la visite et toutes les options de produit disponibles sont listées sur la page Billets au-dessus de la sélection des billets. La première option est présélectionnée, tandis que les autres options disponibles restent repliées. Pour voir et sélectionner d’autres options, basculez celle actuellement sélectionnée.
Sous-fonctionnalité | Paramètre |
|
|
|
|
|
|
Option présélectionnée, au-dessus des billets, extensible
Application non intentionnelle
Si un identifiant de produit (productId) n’est pas spécifié dans l’attribut data-config, les paramètres du sélecteur d’options sont appliqués à tous les produits, y compris ceux qui ne disposent pas d’options. Pour éviter une application non souhaitée de ces paramètres, veillez à inclure l’identifiant du ou des produits spécifiques.
Paramètres par défaut (à gauche) et Au-dessus du billet, extensible (à droite)