Static
Le Widget Statique permet aux marchands d’intégrer le widget Sezzle dans leur site web sans communication directe avec les serveurs de Sezzle. Tout le code du widget, les configurations personnalisées, les images et les feuilles de style sont hébergés localement dans le thème de la boutique du marchand. Cette approche offre :
- Des temps de chargement plus rapides
- L’hébergement local réduit la dépendance aux serveurs externes.
- Un plus grand contrôle
- Les marchands ont un contrôle total sur l’apparence et le comportement du widget, car l’équipe Sezzle ne peut pas le modifier.
Ce contrôle local signifie que les marchands sont responsables de toutes les mises à jour ou modifications du widget.
Implémentation NPM
Utilisation de npm :
npm install @sezzle/sezzle-static-widget@latest
Dans votre page de produit, ajoutez le snippet de code suivant où vous voulez que le widget s’affiche, en mettant à jour le chemin vers node_modules selon votre structure de fichiers :
Utilisez les options de Configuration ci-dessous pour personnaliser l’apparence du widget selon vos souhaits.
Implémentation HTML
L’implémentation varie grandement selon la plateforme, le thème, etc. Voici un aperçu général du processus. Les snippets de code ci-dessous sont des exemples et peuvent nécessiter des modifications pour s’adapter à votre site. Pour les marchands Shopify, veuillez passer à la section suivante.
-
Créez un nouveau fichier Javascript dans le code de votre site à l’endroit approprié
-
Copiez et collez ce code minifié dans le fichier nouvellement créé
-
Importez le nouveau fichier dans la/les page(s) où le widget Sezzle sera ajouté
-
Créez un élément de placeholder où le widget Sezzle doit être rendu sur la/les page(s), généralement en dessous de l’élément contenant le prix
-
Ajoutez le script suivant en dessous de l’élément de placeholder, en mettant à jour la valeur du montant pour refléter votre variable de prix qui affiche le prix actuel du produit ou le total du panier selon le cas
-
Prévisualisez vos modifications pour confirmer que le widget s’affiche correctement dans chacun des scénarios suivants
- Utilisez les options de Configuration ci-dessous pour personnaliser l’apparence du widget selon vos souhaits :
- Prix normal
- Prix en solde
- Sélection de variante
- Bureau
- Mobile
- Utilisez les options de Configuration ci-dessous pour personnaliser l’apparence du widget selon vos souhaits :
Implémentation Shopify
-
Connectez-vous à l’administration de votre boutique Shopify
-
Cliquez sur
Online Store
>Themes
-
À côté du thème que vous souhaitez modifier, cliquez sur
Actions
, puis sélectionnezEdit Code
-
Sous le dossier
Assets
, cliquez surAdd a new asset
-
Dans l’onglet
Create a Blank File
, nommez le fichiersezzle-static-widget
et sélectionnez.js
comme type de fichier, puis cliquez surAdd Asset
-
Copiez le code du fichier du dépôt et collez-le dans ce nouveau fichier, puis cliquez sur
Save
-
Ajoutez les lignes de code suivantes là où le widget doit s’afficher sur la page du produit dans
templates/product.liquid
ousections/product-template.liquid
selon le cas -
Ajoutez les lignes de code suivantes là où le widget doit s’afficher sur la page du panier dans
templates/cart.liquid
ousections/cart-template.liquid
selon le cas
Personnalisation de la configuration
Une fois que le widget s’affiche, des configurations supplémentaires peuvent être ajoutées à AwesomeSezzle pour modifier son apparence. Voici un exemple présentant toutes les options. Cependant, amount est la seule valeur requise.
Le montant du prix cible, au format dollar.
Fournissez la variable du prix du produit comme un littéral de modèle.
Exemple Shopify Liquid : '{{ product.selected_or_first_available_variant.price | money }}'
Fournissez le nom de l’ID ou un tableau de noms d’ID correspondant aux éléments de placeholder du widget où le widget doit être rendu.
Met à jour la couleur du logo pour s’harmoniser et contraster avec différentes couleurs de fond des sites web. Si theme
n’est pas spécifié, le widget tentera de détecter la couleur de fond et d’appliquer le logo contrastant approprié. Utilisez “light” ou “black-flat” pour les fonds clairs, et “dark” ou “white-flat” pour les fonds sombres.
Options disponibles : dark
, light
, black-flat
, white-flat
Largeur maximale de l’élément widget en pixels. Réglez à 200 pour afficher le widget joliment sur 2 lignes, ou 120 pour 3 lignes.
Espace au-dessus du widget en pixels.
Espace en dessous du widget en pixels.
Espace à gauche du widget en pixels.
Espace à droite du widget en pixels.
Alignement du widget par rapport à l’élément parent.
Options disponibles : left
,center
, right
, auto
.
Largeur d’écran en pixels en dessous de laquelle l’alignement passe à alignmentSwitchType
au lieu de alignment
. Le point de rupture le plus courant est 768 (portable vs bureau). alignmentSwitchMinWidth
n’est généralement nécessaire que lorsque l’alignement n’est pas défini sur auto
.
Alignement du widget par rapport à l’élément parent à appliquer lorsque la largeur de la fenêtre est inférieure à alignmentSwitchMinWidth
.
Options disponibles : left
,center
, right
, auto
.
Couleur du texte du widget. Accepte tous les formats de couleur CSS : hex, rgb(), hsl(), etc.
Famille de police du texte du widget.
Taille de police du texte du widget en pixels. Entrez uniquement des chiffres — n’incluez pas d’unités commepx
!
Épaisseur du texte du widget. 100 est le plus léger, 900 est le plus gras.
Spécifie la catégorie de page sur laquelle le widget est rendu. Options disponibles :product-page
,product-preview
,cart
.
Définit la valeur CSS de la hauteur fixe.
Ratio auquel le logo Sezzle est mis à l’échelle. L’espace que le logo occupe entre le texte du widget et le lien/icône Plus d’infos est déterminé par la taille de la police.
Style personnalisé à appliquer au logo Sezzle dans le widget. L’objet accepte tout style CSS au format JSON. Les clés doivent être en camelCase.
Langue dans laquelle le texte du widget doit être rendu. Si la langue spécifiée n’est pas prise en charge, la traduction sera par défaut en anglais.
Options disponibles :en
,fr
,es
,de
.
Permet au prix des versements du widget de calculer et formater correctement pour les devises étrangères.
Options disponibles :default
,comma
.
Permet au widget d’afficher les détails du programme corrects, selon que le marchand est inscrit via Sezzle North America ou Sezzle Europe.
Options disponibles :North America
,Europe
.
Méthodes
Les fonctions suivantes sont intégrées dans le widget statique et sont prêtes à être utilisées pour votre installation de widget. Ajoutez simplement l’extrait de code applicable à votre code de page web, en mettant à jour l’écouteur d’événements et les variables si nécessaire.
alterPrice(newPrice)
Modifie le prix sur le widget. Créez un écouteur d’événements aprèsrenderSezzle.init()
qui invoque cette fonction oùnewPrice
est la nouvelle valeur de prix de la variante sélectionnée. Exemple :
renderModalByfunction()
Ouvre la fenêtre modale Sezzle par une fonction. Créez un écouteur d’événements qui invoque cette fonction si l’emplacement de l’événement est autre que l’icône d’information.
isMobileBrowser()
Renvoie true sur un navigateur mobile. Utilisez cet événement pour afficher ou masquer le widget à différents emplacements de la page en fonction du type d’appareil.
getElementToRender()
Renvoie l’élément où le widget sera rendu. Créez un écouteur d’événements qui invoque cette fonction si le widget doit apparaître lorsque l’événement se produit.