---
title: "Intégrer les widgets"
description: "Prérequis, principe de fonctionnement et autorisation des domaines pour les widgets Millcheck."
canonical_url: "https://docs.millcheck.fr/widgets/introduction"
---
# Intégrer les widgets

> Prérequis, principe de fonctionnement et autorisation des domaines pour les widgets Millcheck.

Les widgets Millcheck affichent les données directement sur vos fiches, **sans développement côté serveur** : un script, une balise `<div>`, et le rendu est généré dans la page du visiteur.

<card-group>
<card icon="i-lucide-calendar-days" title="Widget planning" to="https://docs.millcheck.fr/widgets/planning">

Calendrier des disponibilités d’un hébergement, avec gestion du multi-planning (entités).

</card>

<card icon="i-lucide-clock" title="Widget horaires d’ouverture" to="https://docs.millcheck.fr/widgets/horaires-ouverture">

Horaires Google des 7 prochains jours et bannière « ouvert / fermé aujourd’hui ».

</card>
</card-group>

## Prérequis

<steps level="3">

### jQuery 3 minimum

Les widgets s’appuient sur la librairie **jQuery (version 3 minimum)**. Si votre site la charge déjà de manière globale, inutile de l’ajouter à nouveau.

```html
<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
```

### Un domaine autorisé

Pour des raisons de sécurité, les widgets ne s’affichent que sur les **domaines déclarés** pour votre organisation. Communiquez à l’Agence Mill la liste des domaines concernés (production, préproduction…).

<note>

Le préfixe `www.` est ignoré : déclarer `mon-site.fr` autorise aussi `www.mon-site.fr`.

</note>

### L’identifiant SIT de l’objet

Chaque widget est lié à un objet via son **identifiant SIT**, passé dans l’attribut `data-id`.

</steps>

## Bonnes pratiques

- **N’affichez le widget que pour les objets qui ont des données.** Récupérez la liste via [`GET /objects`](https://docs.millcheck.fr/api/objets) (planning) ou [`GET /opening-hours/objects`](https://docs.millcheck.fr/api/horaires-objets) (horaires) une fois par jour ou par nuit, et conditionnez l’affichage du bloc sur vos fiches (voir [Synchroniser les objets actifs](https://docs.millcheck.fr/api/synchronisation)).
- **Placez les scripts en bas de page**, après les balises `<div>` des widgets.
- **Plusieurs widgets sur une même page ?** Chargez le script une seule fois : il initialise toutes les balises `<div>` correspondantes.

<caution>

Si l’objet est inactif, le domaine non autorisé ou les données absentes, le widget ne s’affiche pas. Prévoyez votre mise en page en conséquence (pas de titre de bloc vide, par exemple).

</caution>


## Sitemap

See the full [sitemap](https://docs.millcheck.fr/sitemap.md) for all pages.