Création d'un flux général pour une instance Castopod
Dans la version actuelle de Castopod, il est possible de récupérer le flux RSS d'un épisode pour pouvoir utiliser ce protocole pour la gestion d'outils d'abonnement. Mais il n'est pas encore possible de créer un flux global rassemblant les flux RSS de chaque épisode dans une instance de Castopod. Il faut donc que chaque utilisateur récupère le flux RSS d'un épisode, et qu'il gère de son côté la récupération de multiples flux pour pouvoir être avertie de la sortie d'un nouvel épisode.
C'est dans cette problématique que Jet Asso nous a demandé de faire en sorte d'avoir un flux global RSS contenant l'ensemble des flux de chaque épisode. Et après quelques recherches, nous avons pu trouver un outil adapté pour cette demande : FreshRSS.
FreshRSS est un agrégateur de flux RSS open source et auto-hébergé qui vous permet de suivre facilement vos flux RSS préférés à partir d'une seule interface. Nous allons vous montrer comment installer FreshRSS à l'aide de Docker et comment l'utiliser pour suivre les flux RSS du Castopod de l'association Jet.
Installation de Fresh RSS
Prérequis
Assurez-vous que Docker est installé sur votre système. Si ce n'est pas le cas, vous pouvez suivre les instructions d'installation de Docker Desktop disponibles sur le site de Docker.
Installation avec Docker
Ouvrez une fenêtre de terminal, allez dans un dossier où les différentes données de FreshRSS seront stockés, et exécutez la commande suivante pour lancer le conteneur FreshRSS :
docker run -d --restart unless-stopped --log-opt max-size=10m \
-p 8080:80 \
-e TZ=Europe/Paris \
-e 'CRON_MIN=1,31' \
-v freshrss_data:/var/www/FreshRSS/data \
-v freshrss_extensions:/var/www/FreshRSS/extensions \
--name freshrss \
freshrss/freshrss
Dans cette commande, nous spécifions :
- Le port sur lequel FreshRSS sera accessible (8080 dans cet exemple).
- Le fuseau horaire (Europe/Paris).
- La configuration de la tâche cron pour mettre à jour les flux toutes les 30 minutes (à la 1ère et à la 31ème minute de chaque heure).
- Les volumes pour stocker les données de FreshRSS et les extensions.
Une fois la commande exécutée, vous pouvez accéder à FreshRSS en ouvrant votre navigateur et en saisissant http://localhost:port.
Configuration initiale
La première fois que vous accédez à FreshRSS, vous devez effectuer une configuration initiale. Suivez les instructions à l'écran pour configurer votre compte utilisateur et vos préférences.
Utilisation de FreshRSS
Abonnement à l'ensemble des flux de Castopod
Pour suivre les flux RSS de l'association Jet, vous devez vous abonner aux flux RSS correspondants. Vous pouvez télécharger le fichier subscriptions.xml contenant tous les flux RSS de Castopod en cliquant ici.
Pour importer le fichier subscriptions.xml dans FreshRSS, suivez ces étapes :
- Cliquez sur l'icône "Gestion des abonnements" dans le menu latéral gauche.
- Cliquez sur l'onglet "Importer / Exporter".
- Dans la section "Importer", cliquez sur le bouton "Parcourir" et sélectionnez le fichier subscriptions.xml que vous avez téléchargé précédemment.
- Cliquez sur le bouton "Importer" pour importer les flux RSS.
Une fois que vous avez importé les flux RSS, vous pouvez actualiser le flux, ce qui permettra de charger tous les flux que vous venez d'importer et de les afficher sur la page d'accueil de FreshRSS.
Une fois cela fait, vous pouvez enfin accéder à un flux RSS global :
Et c'est ce lien que vous pourrez partager à vos utilisateurs pour qu'ils puissent accéder aux flux RSS global que vous avez configuré.
Ajout d'un nouveau flux RSS
Si un nouveau podcast est ajouté à Castopod, celui-ci ne sera pas présent dans le fichier subscriptions.xml et vous devrez l'ajouter à la main. Pour ce faire :
- Cliquer sur le petit
+à côté de "Gestion des abonnements" - Copier le lien du flux RSS du podcast dans "Ajouter un flux"
- Choissisez la catégorie
- Cliquer sur "Ajouter"
- Dans la page qui s'ouvre, vous pouvez cliquer sur "Valider" directement sauf si vous voulez modifier certains paramètres
Et voilà ! Vous avez importé l'ensemble des flux RSS présents sur le Castopod de l'association Jet (au 22/04/2024).
Ajout d'un utilisateur
Une fois que le compte administrateur est correctement abonné à tous les flux RSS du Castopod de l'association, il est possible de créer de nouveaux comptes pour les personnes intéressées. Pour ce faire, cliquez sur l'icône en forme d'écrou en haut à droite, puis sélectionnez "Gestion des utilisateurs". Vous pouvez alors créer un nouvel utilisateur en remplissant les champs requis.
Pour que le nouvel utilisateur puisse également s'abonner à tous les flux RSS, le compte administrateur peut lui partager son fichier d'abonnement. Pour ce faire, l'administrateur doit retourner dans l'onglet "Importer / Exporter" de la gestion des abonnements et exporter sa liste d'abonnements en décochant les options "Exporter les articles étiquetés" et "Exporter les favoris".
Le nouvel utilisateur n'a alors plus qu'à importer le fichier généré par l'administrateur en suivant la même méthode que celle présentée précédemment dans la section "Utilisation". Il pourra ainsi s'abonner facilement à tous les flux RSS partagés par l'administrateur.
Extensions
Nous vous recommandons de vous pencher sur les extensions disponibles pour FreshRSS, que vous pouvez retrouver sur cette page. Chaque extension que vous téléchargez pourra être mis dans le dossier freshrss_extensions du dossier utilisé pour le déploiement du conteneur.
No Comments