- Blog
- Concevoir un thème pour la page de commande d’une boutique : le kit de thème Bill&Go
Concevoir un thème pour la page de commande d’une boutique : le kit de thème Bill&Go
Pour les designers et les développeurs : le kit de thème est sorti. Téléchargez le thème de départ, écrivez du CSS pour les éléments et les tokens de la page de commande, et une boutique sur Growth ou Pro l’ajoute dans sa console. Chaque thème est vérifié, et le bouton de commande, les prix et les erreurs restent sûrs.
Les boutiques Bill&Go prennent leurs commandes sur une page à elles : dans leur Mini App Telegram, et depuis le QR code au comptoir ou le lien qu’elles partagent. Depuis hier, une boutique sur Growth ou Pro peut habiller cette page avec un thème à elle. Aujourd’hui, nous publions ce dont un designer a besoin pour en faire un : le kit de thème.
Ce qu’est un thème
Un thème est du CSS, avec ses images et ses polices, dans un seul .zip. Il habille la page ; il ne la modifie jamais. Le menu, les prix, le panier et le paiement appartiennent à la page, donc quoi que fasse un thème, une commande reste possible.
- theme.json : l’id, le nom, la version et l’auteur du thème, les modes pour lesquels il est fait (clair, sombre ou les deux), ses fichiers, et jusqu’à 12 réglages que le propriétaire peut changer sans toucher à votre CSS.
- theme.css : vos styles, dans un seul fichier, jusqu’à 150 Ko.
- Images et polices : png, jpg, webp et woff2, à côté de theme.css. Pas de SVG.
Partir du thème de départ
- Téléchargez le thème de départ depuis le kit de thème. Il passe déjà chaque vérification.
- Décompressez-le et donnez-lui votre propre
idetnamedans theme.json. - Définissez les tokens de la page (
--bg,--panel,--ink,--look-ret les autres), pour le clair et pour[data-theme="dark"], puis stylez ses éléments :.to-head,.to-section,.po-dish,.po-card,.to-bar. - Recompressez-le et remettez-le à la boutique. Le propriétaire l’ajoute sous Magasins → le magasin → Commande à retirer → Vos thèmes, sur le web ou dans l’app Console, et le choisit pour la Mini App, la page du QR code ou les deux.
Astuce. Écrivez vos règles pour la page telle qu’elle est, sans préfixe. Une fois le thème ajouté, chaque règle est restreinte à lui, si bien qu’elle n’atteint jamais une autre partie de Bill&Go.
Réglages que le propriétaire change
Un thème peut proposer des couleurs et des interrupteurs. Une couleur a une valeur pour le clair et une pour le sombre, et arrive dans votre CSS sous la forme var(--setting-<id>). Un interrupteur, quand il est activé, pose html[data-setting-<id>]. Le thème de départ a deux couleurs (la page et les cartes) et un interrupteur (coins carrés), pour que vous voyiez les deux à l’œuvre.
La couleur de la boutique reste celle de la boutique
Lisez l’accent de la boutique dans --acc-solid, --acc-ink, --acc-tint et --acc-line : il est rendu lisible pour chaque mode. Un seul thème peut ainsi habiller beaucoup de boutiques, chacune avec sa propre couleur.
Ce qui est vérifié, et ce qui ne change jamais
Chaque paquet est vérifié à l’ajout. Un refus liste chaque problème avec sa ligne, pour tout corriger d’un coup. Le vérificateur refuse, entre autres :
@import, et touturl()vers quelque chose hors du paquet.!important, et la définition d’une couleur verrouillée : le bouton de commande, les statuts et les erreurs.- Du texte dans
content, pour qu’un thème ne puisse pas écrire un faux prix sur la page.
Ensuite, après votre CSS, la page ajoute des règles qu’aucun thème ne peut dépasser : le bouton de commande garde sa couleur et reste lisible, les erreurs gardent leur rouge, les prix sont toujours là, le focus du clavier est toujours visible, et avec la réduction des animations, rien ne bouge.
Publier une nouvelle version
Ajoutez à nouveau le même id avec une nouvelle version, et il remplace l’ancien dans cette boutique. Les boutiques qui le portent le gardent. Chaque envoi est servi à une nouvelle adresse, si bien que les clients ne voient jamais une moitié de fichier.
Une page qui ne bouge pas
Chaque classe, état et token de la page du kit de thème fait partie de la version 1 de la page, et chaque thème actuel est fait pour elle. Nous la complétons seulement, sans rien renommer ni retirer, donc un thème fait aujourd’hui continue de fonctionner à mesure que Bill&Go évolue.
Bon à savoir. Une boutique ajoute ses propres thèmes avec Growth et plus, à partir de 43.99 $ par mois. Pour toucher tous les commerces, elle envoie le thème à la galerie de thèmes : une fois publié par Bill&Go, les commerces sur Starter et au-delà peuvent le porter. Concevoir et compresser un thème ne demande aucun compte.
Questions
Faut-il un compte Bill&Go pour faire un thème ?
Non. Téléchargez le thème de départ et écrivez votre CSS. Pour le voir sur une vraie page, la boutique concernée l’ajoute dans sa console ; l’ajout d’un thème se fait avec Growth et Pro.
Un thème peut-il charger une police depuis Google Fonts ?
Non : un thème ne renvoie qu’à ses propres fichiers. Mettez la police dans le paquet en woff2 et listez-la dans theme.json. Gardez une police qui contient les lettres khmères et chinoises pour ces langues.
Comment mettre à jour un thème qu’une boutique porte déjà ?
Ajoutez-le à nouveau avec le même id et une nouvelle version. Il remplace l’ancien dans cette boutique, et les boutiques qui le portent le gardent.
Toujours bloqué ?
Dites à l’équipe Bill&Go à Phnom Penh ce que vous essayiez de faire, et nous vous guiderons.