Publier votre carte sur votre site
Affichez votre carte Chowple sur votre propre site — widget, iframe ou API JSON, toujours à jour.
Votre carte Chowple peut être affichée sur votre propre site web : vous la tenez à jour dans l'onglet Carte, votre site la reflète automatiquement. Trois formats sont proposés — un widget à coller, une iframe, ou l'API JSON brute pour votre webmaster.
La diffusion sur votre propre site — widget, iframe et API JSON — fait partie du plan Pro. En plan Starter, l'interrupteur de publication vous propose de passer au plan Pro. Votre carte reste en revanche toujours visible sur votre page Chowple, quel que soit votre plan.
Activez la publication
Dans Réglages → Carte, carte Publier ma carte, activez l'interrupteur Carte publiée sur le web et confirmez. Vos plats, prix, photos et notes deviennent alors accessibles publiquement : sur votre page Chowple, dans le widget et via l'API. Vous pouvez dépublier à tout moment, d'un clic.
Choisissez d'afficher ou non les notes
Juste sous l'interrupteur de publication, Afficher les notes Chowple décide si les notes de vos plats et de votre établissement apparaissent sur la carte diffusée sur votre site — widget, iframe et API. Désactivez-le et votre carte y devient une carte de menu classique : noms, descriptions, prix et photos, sans aucune note.
Ce réglage ne concerne que votre propre site. Votre page Chowple, elle, continue d'afficher les notes : c'est la page d'avis de votre établissement.
Collez le widget sur votre site
Copiez le bloc Widget à coller sur votre site et insérez-le dans votre page (ou transmettez-le à votre webmaster) :
<div data-chowple-menu="votre-slug" data-lang="fr"></div>
<script src="https://chowple.com/embed/menu.js" async></script>Le widget est isolé du style de votre site (il reste net quel que soit votre thème) et s'adapte : liste dense pour une carte des vins, cartes avec photos pour les plats.
Personnalisez-le (optionnel)
Ajoutez des attributs sur le <div> selon vos besoins :
| Attribut | Effet |
|---|---|
data-lang="en" | textes et prix en anglais |
data-theme="dark" | thème sombre |
data-photos="false" | masquer les photos |
data-ratings="false" | masquer les notes Chowple sur cette intégration précise |
data-mode="dense" | forcer la liste compacte, sans cartes photo |
data-menu="Carte des vins" | n'afficher qu'une seule de vos cartes (nom exact) |
data-font="Georgia, serif" | police personnalisée |
Si le widget ne s'affiche pas : l'iframe
Certains sites bloquent les scripts externes (règle de sécurité CSP — fréquent chez Wix, Squarespace ou sur un site durci). Deux solutions :
-
soit votre webmaster ajoute ces quatre directives à la CSP du site :
script-src https://chowple.com; connect-src https://chowple.com; img-src https://hleawvqvbrkywdgjxcoo.supabase.co; style-src 'unsafe-inline';Les deux premières autorisent le chargement du widget et l'appel à votre carte. La troisième affiche les photos de plats, hébergées sur un autre domaine que
chowple.com— sans elle, la carte s'affiche mais toutes les photos restent vides. La quatrième autorise la feuille de style interne du widget : sans elle, la carte s'affiche en texte brut, sans mise en forme. -
soit utilisez la Variante iframe :
<iframe src="https://chowple.com/embed/menu/votre-slug" style="width:100%;border:0" height="800" title="Menu"></iframe>Ajustez
heightà la longueur de votre carte ; ajoutez?lang=enpour l'anglais. Une iframe est elle aussi soumise à la CSP : si votre site en applique une stricte, il faut y ajouterframe-src https://chowple.com.
Si votre CSP est verrouillée au point que rien de tout cela ne passe, il reste le lien simple vers votre carte publique Chowple, qui ne demande aucune autorisation.
Pour votre webmaster : l'API JSON
Le bloc API JSON donne l'adresse https://chowple.com/api/v1/menu/votre-slug
(?lang=en pour l'anglais) : votre carte complète en JSON, sans authentification, pour un
rendu 100 % personnalisé. Points de contrat à connaître :
menus,sections,itemsetpricessont toujours des tableaux, même avec un seul élément. Les notes sont sur 10 (rating_scale: 10) et masquées (rating: null) sous 3 avis par plat ou 5 avis pour l'établissement.ratings_visible(booléen) dit si la réponse porte des notes :falsequand l'établissement a désactivé Afficher les notes Chowple — à distinguer d'unrating: nullisolé, qui signifie « pas encore assez d'avis ».- Le contrat v1 est stable : les évolutions n'ajoutent que de nouvelles clés, rien n'est retiré ni renommé. Ignorez les clés inconnues.
- Erreurs : corps
{"error":"code"}—invalid_slug(400),menu_unavailable(404 : slug inconnu, publication désactivée, carte vide ou abonnement insuffisant — ces causes sont volontairement indistinguables),rate_limited(429, avec un en-têteRetry-After),internal(500). CORS ouvert (*), y compris sur les erreurs. - Le widget émet les événements
chowple:menu:loadedetchowple:menu:errorsur le<div>si vous voulez réagir au chargement.
Mise à jour : les réponses sont mises en cache. Après une modification dans l'onglet Carte, comptez jusqu'à 5 minutes avant qu'elle apparaisse sur votre site — il n'y a pas de purge instantanée.
La publication exige le plan Pro, un établissement vérifié et le rôle propriétaire, administrateur ou manager. Une carte vide ne peut pas être publiée. Si vous dépubliez, le widget disparaît proprement de votre site (aucun bloc d'erreur) et l'API répond 404. Même chose si votre abonnement repasse en Starter : la diffusion s'arrête (widget vide, API 404) sans toucher votre réglage — elle reprend telle quelle dès le retour au plan Pro, et votre page Chowple reste en ligne dans l'intervalle.
Cet article vous a-t-il aidé ?