Événements et Actions #
Finder permet d’interagir avec son comportement via des événements et des actions disponibles en JavaScript. Cela vous permet d’écouter ce qui se passe dans le moteur de recherche ou même de remplacer certains comportements par défaut pour les adapter à la logique de votre boutique.
L’exemple suivant montre comment enregistrer des événements et modifier certaines actions de Finder :
(function() {
const initializerFinderActionsAndEvents = () => {
window.sbFinder.addEventListener('sellboostfinder:event:search:key-press', ({
key,
searchQuery
}) => {})
window.sbFinder.addActionHandler('sellboostfinder:action:search:failover', (searchQuery, redirectUrl) => {})
window.sbFinder.addActionHandler('sellboostfinder:action:cart:get-current', () => {
let quantity = 2
return new Promise(resolve => resolve(quantity))
})
window.sbFinder.addActionHandler('sellboostfinder:action:cart:add-product', (productId) => {
return new Promise(resolve => resolve(true))
})
}
if (window.sbFinder?.addActionHandler) {
initializerFinderActionsAndEvents()
} else {
window.addEventListener('sellboostfinder:event:loaded', () => initializerFinderActionsAndEvents())
}
})();
Dans cet exemple, un bloc de code est initialisé et s’exécute lorsque Finder est disponible. Si la bibliothèque est déjà chargée, il s’exécute immédiatement ; sinon, il attend l’événement sellboostfinder:event:loaded.
Plusieurs exemples sont illustrés dans cette initialisation :
- Événement key-press : permet d’écouter lorsqu’un utilisateur appuie sur une touche dans le champ de recherche. L’événement fournit des informations telles que la touche pressée et la requête actuelle.
- Action search:failover : permet de remplacer le comportement par défaut lorsqu’une recherche échoue ou ne renvoie aucun résultat. Cela peut être utilisé, par exemple, pour rediriger vers une autre page ou appliquer une logique personnalisée.
- Action cart:get-current : permet de définir comment obtenir la quantité de produits actuellement présents dans le panier de la boutique.
- Action cart:add-product : permet de définir le comportement lors de l’ajout d’un produit au panier depuis Finder. La fonction doit renvoyer une valeur booléenne ou une promesse qui résout en un booléen indiquant si l’action a été réalisée avec succès.
Variables de Configuration #
Finder permet également de modifier certains comportements via des variables JavaScript globales qui peuvent être définies avant le chargement du moteur de recherche.
- sbFinderDisabledStats : permet de forcer l’activation ou la désactivation du système de statistiques.
- sbExcludedBrands : permet d’exclure certaines marques des résultats de recherche.
Exemple d’utilisation :
var sbFinderDisabledStats = false;
var sbExcludedBrands = [];
sbExcludedBrands.push("PENHALIGON'S");
sbExcludedBrands.push("ERBORIAN");
Dans cet exemple, un tableau est défini avec les marques qui ne doivent pas apparaître dans les résultats de recherche.
JavaScript Personnalisé #
Finder permet de charger du JavaScript personnalisé directement depuis le panneau de configuration. Cette option se trouve dans la section configuration avancée du module Finder.
Depuis cette section, il est possible d’ajouter vos propres scripts pour étendre ou modifier le comportement du moteur de recherche sans avoir besoin de modifier le code du thème de la boutique.
