Score Center
Les matchs d’un sport sur un jour, en un bloc par compétition (nom, journée ou phase, bouton « Classement »). Chaque match affiche son état : l’heure s’il est à venir, le score en direct ou une fois terminé. Au-dessus des blocs, un filtre de statut (Tous, En cours, Terminés, À venir) et le choix du jour, avec des flèches vers le jour précédent et le jour suivant qui ont des matchs. Avec plusieurs sports, des onglets permettent de passer de l’un à l’autre.
<div data-idalgo-component="ScoreCenter" data-idalgo-param-sport="102"></div><script src="https://delivery.idalgo.live/sdk/v1.js" async></script>Paramètres
Section intitulée « Paramètres »| Paramètre | Obligatoire | Description | Exemple |
|---|---|---|---|
sport |
Oui¹ | Sport affiché (id de /v1/sports) |
102 |
sports |
Non | Onglets de sport, dans l’ordre (ids de /v1/sports) ; à partir de deux. Sans sport, le premier est affiché |
102,202 |
competitions |
Non² | Compétitions du sport affiché, dans l’ordre des blocs (ids de /v1/competitions, 30 au plus) |
103,2003,503 |
competitions.<sport> |
Non² | Compétitions d’un onglet de sport, même format | 1205,1305 |
date |
Non | Jour affiché (AAAA-MM-JJ) ; par défaut, aujourd’hui |
2026-10-31 |
status |
Non | Statut sélectionné à l’affichage : live (en cours), finished (terminés) ou scheduled (à venir) ; par défaut, tous |
live |
timezone |
Non | Fuseau horaire de vos lecteurs (IANA), qui borne le jour et les heures affichées (défaut Europe/Paris) |
America/Montreal |
lang |
Non | Langue des noms (défaut fr) ; l’interface reste en français (voir Langue) |
en |
mode |
Non | Mode : light (défaut), dark ou auto, qui suit le réglage de l’appareil du lecteur ; par défaut, celui de votre thème (voir Mode sombre) |
dark |
live |
Non | false : coupe le direct de ce widget ; par défaut, celui de votre offre |
false |
¹ Sauf si sports est donné.
² Sans compétitions, le football affiche une sélection de compétitions définie par iDalgo (Ligue 1,
Ligue des Champions, grands championnats européens, coupes et compétitions internationales). Les
autres sports n’en ont pas : donnez-leur leurs compétitions, sinon le widget répond en erreur
400 (et un onglet de ce sport n’affiche que « Les matchs de ce jour n’ont pas pu être chargés »).
Le widget affiche au plus 200 matchs par jour ; au-delà, il l’indique sous les blocs.
Navigation
Section intitulée « Navigation »Les flèches mènent au jour précédent et au jour suivant qui ont des matchs pour ce sport et ces compétitions, en sautant les jours vides ; la liste propose ces jours voisins et ceux déjà parcourus. Changer de jour ou de sport recharge les matchs dans le widget, sans recharger la page, avec le même fuseau, la même langue et les compétitions de ce sport.
Le filtre de statut s’applique aux matchs du jour déjà chargés. Avec status, le widget s’affiche
avec ce seul statut ; choisir un autre filtre charge le jour entier.
Classement
Section intitulée « Classement »Le bouton « Classement » d’un bloc émet sur le widget l’événement DOM
idalgo:score-center:standings, qui remonte dans la page. Son detail donne la compétition et la
saison du bloc ({ competition: { id, name }, season: { id, name } }) : de quoi afficher le widget
Classement de cette saison.
document.addEventListener("idalgo:score-center:standings", (event) => { const { season } = event.detail; iDalgo.render("#classement", { component: "RankingTable", params: { season: season.id } });});En direct
Section intitulée « En direct »Les matchs du jour affiché se mettent à jour seuls, sans recharger la page : passage en direct, score, fin du match. Le widget relit l’API à partir de 90 minutes avant le premier coup d’envoi du jour, au rythme qu’elle indique, et s’arrête quand tous les matchs du jour sont terminés. Il reprend après chaque changement de jour ou de sport. Un onglet de navigateur caché ne relit rien ; il se remet à jour dès qu’il redevient visible.
Sans direct, selon votre offre ou avec live=false, le widget reste tel qu’affiché ; un match en
cours le signale, avec l’heure des données et un bouton « Actualiser » (voir Direct).
Erreurs et états
Section intitulée « Erreurs et états »En erreur, le widget n’est pas rendu : le SDK affiche « Impossible de charger le widget », avec un
bouton « Réessayer » si l’erreur est passagère (réseau, serveur), ou appelle votre onError (voir
SDK) ; en intégration côté serveur,
la réponse porte le statut, un message et un code stable { "error": "…", "code": "…" }.
| Statut | Cas | Code de l’API |
|---|---|---|
400 |
sport absent (sans sports) ou non numérique ; competitions, date, timezone, lang ou mode invalide |
invalid-request |
400 |
Sport sans sélection de compétitions par défaut, sans competitions |
invalid-request |
502 |
API iDalgo injoignable ou réponse non conforme | — |
Un status inconnu est ignoré (tous les matchs s’affichent), un sport de sports inconnu est
écarté des onglets, une compétition inconnue ne donne aucun bloc. Les états du widget :
- aucun match pour le jour et le filtre choisis : « Aucun match ce jour-là. » (« Aucun match en cours ce jour-là. », « Aucun match terminé ce jour-là. », « Aucun match à venir ce jour-là. ») ;
- échec du chargement d’un autre jour ou d’un autre sport : « Les matchs de ce jour n’ont pas pu être chargés. » ;
- plus de 200 matchs : « D’autres matchs de ce jour ne sont pas affichés. » ;
- panneau Classement : « Chargement du classement… », puis « Pas de classement pour cette saison. » s’il n’y en a pas, ou « Le classement n’a pas pu être chargé. » avec un bouton « Réessayer ».
En direct, une relecture en échec est retentée 30 secondes plus tard, et le widget garde les dernières données affichées.
Le widget lit le module GET /modules/score-center/v1,
puis, pendant les matchs, sa route live
GET /modules/score-center/v1/live : les
mêmes données sont disponibles en JSON pour vos propres interfaces.