Aller au contenu principal

Intégration UGC pour Gladys Assistant

Intégration UGC pour Gladys Assistant

Films actuellement à l'affiche dans votre cinéma UGC.

Voir sur GitHubToutes les intégrations externes

Films actuellement à l'affiche dans votre cinéma UGC, sous forme de widget de tableau de bord, avec un déclencheur de scène pour l'ajout d'un nouveau film.

Important : intégration non officielle​

Cette intégration lit la page "films à l'affiche" que ugc.fr sert publiquement à n'importe quel visiteur de son site — le même contenu que vous verriez en ouvrant la page de votre cinéma dans un navigateur, rien de plus. Elle n'est ni développée, ni approuvée, ni affiliée à UGC. UGC peut changer son site à tout moment et casser cette intégration sans préavis.

Aucune API payante, aucun identifiant extrait d'une application, aucun contournement de protection anti-robot n'est utilisé : uniquement le point d'accès public que le site utilise déjà pour lui-même.

Configuration​

  1. Ouvrez l'onglet Configuration de l'intégration.
  2. Lancez l'action Trouver mon cinéma : laissez le champ vide pour lister les 5 cinémas UGC les plus proches de votre maison Gladys (si sa position est renseignée), ou tapez une ville / un code postal pour chercher parmi tous les cinémas. Le résultat s'affiche sous le bouton, au format Nom du cinéma — Ville (12.3 km) (ID: 10) (la distance n'apparaît que pour une recherche par proximité).
  3. Copiez l'identifiant numérique du cinéma souhaité dans le champ Identifiant du cinéma, puis enregistrez.

Si aucune maison Gladys n'a de position renseignée, laisser le champ vide liste tous les cinémas UGC (comportement de repli).

Ajoutez le widget À l'affiche de l'intégration à un tableau de bord Gladys pour voir les films actuellement à l'affiche dans ce cinéma : affiche, lien de réservation, horaires de séances du jour (heure et version, VF/VOST) et, quand ugc.fr en propose une, un lien vers la bande-annonce.

Déclencheur de scène​

L'intégration déclare aussi un déclencheur de scène Nouveau film ajouté : créez une scène avec ce déclencheur pour réagir quand un film jamais vu auparavant apparaît dans le programme (envoyer un message, par exemple). Le déclencheur expose le titre du film, sa date de sortie, les horaires du jour et le lien de réservation comme variables de scène. L'intégration vérifie l'apparition de nouveaux films deux fois par jour.

Limites connues (v1)​

  • Un seul cinéma à la fois par installation de l'intégration.
  • Uniquement les films et horaires du jour même (pas de vue sur demain ou les jours suivants).
  • La liste des cinémas est une liste statique maintenue à la main (voir le README du dépôt) : un nouveau cinéma UGC peut ne pas encore y apparaître.

Dépannage​

L'intégration journalise tout ce qu'elle fait : consultez les logs de l'intégration depuis l'interface Gladys (ou docker logs sur l'hôte) avec LOG_LEVEL=debug pour le détail complet.

Paramètres de configuration​

Voici les paramètres demandés par UGC dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Cinéma UGCsectionNonCette intégration lit la page "films à l'affiche" publique que ugc.fr sert déjà à chaque visiteur. Ce n'est pas un produit officiel UGC, elle n'est pas affiliée à UGC, et peut cesser de fonctionner sans préavis si le site change. Lancez l'action ci-dessous pour trouver l'identifiant de votre cinéma, puis collez-le ci-dessous.
Identifiant du cinémastringOuiL'identifiant numérique affiché par l'action "Trouver mon cinéma", par ex. 10.

Comment installer UGC dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : UGC apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/vincentbesseau/gladys-ugc:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/vincentBesseau/gladys-ugc.

UGC nécessite Gladys >=5.1.1. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

UGC est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par vincentBesseau, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le