Integración domótica FFHandball, gratuita y de código abierto
Siga equipos de balonmano franceses: resultados, clasificación y partidos de ffhandball.fr.
Publicado por prohand
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Esta integración sigue equipos de balonmano franceses en ffhandball.fr, el sitio web de la federación francesa de balonmano: ligas profesionales y campeonatos nacionales, regionales y departamentales. Cada equipo seguido se convierte en un dispositivo de Gladys con su clasificación, su último resultado y su próximo partido, y alimenta disparadores de escena y widgets del panel.
Sin cuenta ni clave: la integración lee el sitio web público por internet (nube).
Añadir un equipo
-
En www.ffhandball.fr/competitions, elija la temporada, la competición y haga clic en su equipo (en el calendario o en la clasificación).
-
Copie la dirección de esa página en su navegador. Termina en
/equipe-<número>/, por ejemplo:https://www.ffhandball.fr/competitions/saison-2026-2027-22/national/daikin-starligue-2026-27-32372/equipe-2119699/ -
En Gladys, abra la pantalla Configuración de la integración y péguela en Equipos. Una dirección por línea para seguir varios equipos. Guarde.
-
Abra la pestaña Descubrimiento y cree los dispositivos.
¿No encuentra la página del equipo? Copie en su lugar la dirección de la competición (o de uno de sus grupos) y péguela en el botón Listar los equipos de una competición: la respuesta lista cada equipo con la dirección que hay que pegar.
Nueva temporada, nuevas direcciones. La federación da a cada equipo una página nueva cada temporada: en septiembre, pegue la nueva dirección. Es un dispositivo nuevo (el historial de la temporada pasada se queda en el antiguo, que puede borrar).
Configuración
| Campo | Función |
|---|---|
| Equipos | Direcciones de las páginas de equipo, una por línea. |
| Intervalo de actualización | Minutos entre dos lecturas de ffhandball.fr (30 por defecto, 5 como mínimo). El sitio actualiza sus páginas más o menos una vez por hora. |
| Aviso de partido | Minutos antes del inicio en los que se activa «Un partido va a empezar» (60 por defecto, 0 = al inicio). |
| Idioma de los textos de los dispositivos | Idioma de los nombres de las funciones y de los textos publicados como estados y variables de escena. |
Probar la conexión vuelve a leer cada equipo e indica, equipo por equipo, lo que respondió el sitio: nombre, competición, posición y próximo partido — o por qué falló.
El dispositivo equipo
| Función | Valor |
|---|---|
| Posición | Puesto en el grupo |
| Puntos, Jugados, Ganados, Empatados, Perdidos | La clasificación del grupo |
| Diferencia de goles | Goles a favor menos goles en contra |
| Último resultado | 1 victoria, 0 empate, -1 derrota |
| Último partido: goles a favor / en contra | El marcador del último partido, desde el lado del equipo |
| Último partido | Texto, p. ej. «Victoria 29-23 contra TOULOUSE FENIX» |
| Próximo partido | Texto, p. ej. «sáb, 17/10, 19:00 · CAEN HANDBALL – PARIS SAINT-GERMAIN» |
| Próximo partido en (días) | 0 el día del partido |
Las horas son horas francesas (Europe/Paris), tal como las publica la federación. La insignia del dispositivo indica nube cuando se leyó el equipo, inaccesible cuando ffhandball.fr no respondió.
Escenas (Gladys 5.1+)
Disparadores
| Disparador | Se activa | Filtros | Variables |
|---|---|---|---|
| Se publica el resultado de un partido | cuando aparece el resultado final de un partido | equipo, resultado, campo | team, opponent, score_for, score_against, score, result_text, summary, competition, kickoff, kickoff_text |
| Un partido va a empezar | una vez por partido, los minutos configurados antes del inicio | equipo, campo | team, opponent, kickoff, kickoff_text, minutes_before, summary, competition |
| La posición de un equipo ha cambiado | cuando el equipo sube o baja en su grupo | equipo, sentido | team, rank, previous_rank, points, competition |
| Un partido ha sido reprogramado | cuando cambia la fecha o la hora de un próximo partido | equipo, campo | team, opponent, kickoff, kickoff_text, previous_kickoff, previous_kickoff_text, summary, competition |
Use una variable en las acciones siguientes como {{triggerEvent.data.<variable>}}, por
ejemplo en una notificación: {{triggerEvent.data.result_text}}.
Cada disparador se activa una vez por cambio, incluso tras un reinicio: la integración recuerda lo que ya anunció. Un equipo recién añadido no repite su temporada: los eventos empiezan con el próximo cambio. Un resultado visto por primera vez más de tres días después del partido, o un marcador corregido, no activa nada.
Acciones
| Acción | Salidas |
|---|---|
| Leer el próximo partido de un equipo | found, team, opponent, venue (home/away), kickoff, kickoff_text, days_until, competition, summary |
| Leer el último resultado de un equipo | found, team, opponent, venue, result (win/draw/loss), result_text, score_for, score_against, summary |
| Leer la clasificación de un equipo | found, team, rank, points, played, won, drawn, lost, goal_difference, teams_in_pool |
found vale false cuando no hay nada que leer (ningún partido programado, ningún partido
jugado aún): condicione las acciones siguientes a ello.
Ideas
- Cada sábado a las 9:00, Leer el próximo partido de un equipo; si
days_untilvale 0, enviar «Partido hoy a las {{…kickoff_text}} contra {{…opponent}}». - Se publica el resultado de un partido, resultado Victoria: poner las luces del salón con los colores del club.
- Un partido va a empezar, campo Local: recordar a todos que salgan hacia el pabellón.
Widgets del panel (Gladys 5.1+)
| Widget | Muestra |
|---|---|
| Equipo de balonmano | Posición, puntos y diferencia de goles (en directo), último resultado, próximo partido, un enlace a la página del equipo y un botón Actualizar |
| Clasificación balonmano | La clasificación del grupo del equipo, hasta 10 filas alrededor del equipo, destacado |
| Próximos partidos | Los próximos partidos de todos los equipos seguidos (1 a 8) |
| Últimos resultados | Los últimos resultados de todos los equipos seguidos (1 a 8) |
Solución de problemas
- «no es una página de equipo»: la dirección debe contener
/equipe-<número>/. Use el botón Listar los equipos de una competición para obtenerla. - «team … not found on ffhandball.fr»: la temporada de esa página ha terminado o el equipo se ha retirado. Pegue la dirección de la temporada en curso.
- «ffhandball.fr unreachable»: el sitio o su conexión a internet no funciona; la integración lo vuelve a intentar en la próxima actualización.
- Un resultado llega tarde: la federación lo publica cuando se cierra el acta del partido, a veces horas después, y su sitio guarda las páginas en caché una hora.
Privacidad
La integración solo lee páginas públicas de ffhandball.fr. No envía nada sobre usted ni sobre
su casa, y solo guarda /data/state.json (lo que ya anunció a sus escenas).
Parámetros de configuración
Estos son los parámetros que FFHandball te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | En www.ffhandball.fr, abra Compétitions, elija la temporada, la competición y haga clic en su equipo: copie la dirección de esa página (termina en /equipe-<número>/) y péguela abajo, un equipo por línea. ¿No encuentra la página? Pegue la dirección de la competición en el botón «Listar los equipos de una competición». Sin cuenta ni clave: la integración lee el sitio web público. |
| Equipos | string | No | Direcciones de páginas de equipo de ffhandball.fr, una por línea. Cada equipo se convierte en un dispositivo de Gladys. Las páginas cambian cada temporada: pegue la nueva dirección en septiembre. |
| Intervalo de actualización (minutos) | number | No | Frecuencia de lectura de ffhandball.fr. El propio sitio actualiza sus páginas más o menos una vez por hora: leerlo más a menudo no adelanta los resultados. |
| Aviso de partido (minutos antes del inicio) | number | No | Cuándo se activa el disparador de escena «Un partido va a empezar». 0 lo activa al inicio del partido. |
| Idioma de los textos de los dispositivos | select | No | Idioma de los nombres de las funciones y de los textos publicados como estados (último partido, próximo partido) y en las variables de escena. Los widgets siguen el idioma del lector. |
Cómo instalar FFHandball en Gladys
- En Gladys, abre Integraciones: FFHandball aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-ffhandball:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-ffhandball.
FFHandball requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
FFHandball es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación