La page principale

La vue normale

À FAIRE

La vue globale

À FAIRE

La vue lecture

À FAIRE

Rafraîchir les flux

Pour profiter pleinement de FreshRSS, il faut qu’il récupère les nouveaux articles disponibles des flux auxquels vous avez souscrit. Pour cela, il existe plusieurs méthodes.

Mise à jour automatique

C’est la méthode recommandée car il n’y a pas besoin d’y penser, elle se fait toute seule, à la fréquence que vous avez choisi.

Par le script actualize_script.php

Cette méthode n’est possible que si vous avez accès aux tâches planifiées de la machine sur laquelle est installée votre instance de FreshRSS.

Le script qui permet de mettre à jour les articles s’appelle actualize_script.php et se trouve dans le répertoire app de votre instance de FreshRSS. La syntaxe des tâches planifiées ne sera pas expliqué ici, cependant voici une introduction rapide à crontab qui peut vous aider.

Ci-dessous vous trouverez un exemple permettant la mise à jour des articles toutes les heures.

0 * * * * php /chemin/vers/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log 2>&1

« Paramètres de configuration du script; Ils sont utilisables simultanément

»

• Parameter “force”

https://freshrss.example.net/i/?c=feed&a=actualize&force=1 If force is set to 1 all feeds will be refreshed at once.

• Parameter “ajax” https://freshrss.example.net/i/?c=feed&a=actualize&ajax=1 Only a status site is returned and not a complete website. Example: “OK”

• Parameter “maxFeeds”

https://freshrss.example.net/i/?c=feed&a=actualize&maxFeeds=30 If maxFeeds is set the configured amount of feeds is refreshed at once. The default setting is “10”.

• Parameter “token”

https://freshrss.example.net/i/?c=feed&a=actualize&token=542345872345734 Security parameter to prevent unauthorized refreshes. For detailed Documentation see “Form authentication”.

Online cron

If you do not have access to the installation server scheduled task, you can still automate the update process.

To do so, you need to create a scheduled task, which need to call a specific URL: https://freshrss.example.net/i/?c=feed&a=actualize (it could be different depending on your installation). Depending on your application authentication method, you need to adapt the scheduled task.

Aucune authentification

C’est le cas le plus simple, puisque votre instance est publique, vous n’avez rien de particulier à préciser :

0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize'

Authentification par formulaire

Dans ces cas-là, si vous avez autorisé la lecture anonyme des articles, vous pouvez aussi permettre à n’importe qui de rafraîchir vos flux (« Autoriser le rafraîchissement anonyme des flux »).

L’url précédente devient donc accessible à n’importe qui et vous pouvez utiliser la tâche cron de la partie précédente.

Vous pouvez aussi configurer un jeton d’authentification pour accorder un droit spécial sur votre serveur.

La tâche cron à utiliser sera de la forme suivante :

0 * * * * curl 'https://freshrss.example.net/i/?c=feed&a=actualize&token=mon-token'

You can also target a different user by adding their username to the query string, with &user=insert-username:

0 * * * * curl 'https://freshrss.exemple.net/i/?c=feed&a=actualize&user=quelquun&token=mon-token'

Authentification HTTP

Dans ce cas-là, le token et les permissions “anonymes” sont inutilisables et il vous sera nécessaire d’indiquer vos identifiants dans la tâche cron. Notez que cette solution est grandement déconseillée puisqu’elle implique que vos identifiants seront visibles en clair !

0 * * * * curl -u alice:motdepasse123 'https://freshrss.exemple.net/i/?c=feed&a=actualize'

Mise à jour manuelle

Si vous ne pouvez pas ou ne voulez pas utiliser la méthode automatique, vous pouvez le faire de façon manuelle. Il existe deux méthodes qui permettent de mettre à jour tout ou partie des flux.

Mise à jour complète

Cette mise à jour se fait pour l’ensemble des flux de l’instance. Pour initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour disponible dans le menu de navigation.

Lorsque la mise à jour démarre, une barre de progression apparait et s’actualise au fur et à mesure de la récupération des articles.

Mise à jour partielle

Cette mise à jour se fait pour le flux sélectionné uniquement. Pour initier cette mise à jour, il suffit de cliquer sur le lien de mise à jour disponible dans le menu du flux.

Filtrer les articles

Avec le nombre croissant d’articles stockés par FreshRSS, il devient important d’avoir des filtres efficaces pour n’afficher qu’une partie des articles. Il existe plusieurs méthodes qui filtrent selon des critères différents. Ces méthodes peuvent être combinées dans la plus part des cas.

Par catégorie

C’est la méthode la plus simple. Il suffit de cliquer sur le titre d’une catégorie dans le panneau latéral. Il existe deux catégories spéciales qui sont placées en haut dudit panneau :

• Flux principal qui affiche uniquement les articles des flux marqués comme visible dans cette catégorie
• Favoris qui affiche uniquement les articles, tous flux confondus, marqués comme favoris

Par flux

Il existe plusieurs méthodes pour filtrer les articles par flux :

• en cliquant sur le titre du flux dans le panneau latéral
• en cliquant sur le titre du flux dans le détail de l’article
• en filtrant dans les options du flux dans le panneau latéral
• en filtrant dans la configuration du flux

Par statut

Chaque article possède deux attributs qui peuvent être combinés. Le premier attribut indique si l’article a été lu ou non. Le second attribut indique si l’article a été noté comme favori ou non.

Dans la version 0.7.x, les filtres sur les attributs sont accessibles depuis la liste déroulante qui gère l’affichage des articles. Dans cette version, il n’est pas possible de combiner les filtres. Par exemple, on ne peut pas afficher les articles lus qui ont été notés comme favori.

Starting with version 0.8, all attribute filters are visible as toggle icons. They can be combined. As any combination is possible, some have the same result. For instance, the result for all filters selected is the same as no filter selected.

By default, this filter displays only unread articles

By content

It is possible to filter articles by their content by inputting a string in the search field.

Grâce au champ de recherche

Il est possible d’utiliser le champ de recherche pour raffiner les résultats :

• par ID de flux : f:123 ou plusieurs flux (ou) : f:123,234,345
• par auteur : author:nom or author:'nom composé'
• par titre : intitle:mot or intitle:'mot composé'
• par URL: inurl:mot or inurl:'mot composé'
• par tag: #tag
• par texte libre : mot or 'mot composé'
• by date of discovery, using the ISO 8601 time interval format: date:<date-interval>
  • From a specific day, or month, or year:
    • date:2014-03-30
    • date:2014-03 or date:201403
    • date:2014
  • From a specific time of a given day:
    • date:2014-05-30T13
    • date:2014-05-30T13:30
  • Between two given dates:
    • date:2014-02/2014-04
    • date:2014-02--2014-04
    • date:2014-02/04
    • date:2014-02-03/05
    • date:2014-02-03T22:00/22:15
    • date:2014-02-03T22:00/15
  • After a given date:
    • date:2014-03/
  • Before a given date:
    • date:/2014-03
  • For a specific duration after a given date:
    • date:2014-03/P1W
  • For a specific duration before a given date:
    • date:P1W/2014-05-25T23:59:59
  • For the past duration before now (the trailing slash is optional):
    • date:P1Y/ or date:P1Y (past year)
    • date:P2M/ (past two months)
    • date:P3W/ (past three weeks)
    • date:P4D/ (past four days)
    • date:PT5H/ (past five hours)
    • date:PT30M/ (past thirty minutes)
    • date:PT90S/ (past ninety seconds)
    • date:P1DT1H/ (past one day and one hour)
• par date de publication, avec la même syntaxe: pubdate:<date-interval>
• par ID d’étiquette : L:12 ou de plusieurs étiquettes : L:12,13,14 ou avec n’importe quelle étiquette : L:*
• par nom d’étiquette : label:étiquette, label:"mon étiquette" ou d’une étiquette parmis une liste (ou) : labels:"mon étiquette,mon autre étiquette"
• par plusieurs noms d’étiquettes (et) : label:"mon étiquette" label:"mon autre étiquette"
• par ID d’article (entrée) : e:1639310674957894 ou de plusieurs articles (ou): e:1639310674957894,1639310674957893
• par nom de filtre utilisateur (recherche enregistrée) : search:maRecherche, search:"Ma recherche" ou par ID de recherche : S:3
  • en interne, ces références sont remplacées par le filtre utilisateur correspondant dans l’expression de recherche

Attention à ne pas introduire d’espace entre l’opérateur et la valeur recherchée.

Certains opérateurs peuvent être utilisé négativement, pour exclure des articles, avec la même syntaxe que ci-dessus, mais préfixé par ! ou - : !f:123, -author:nom, -intitle:mot, -inurl:mot, -#tag, !mot, !date:2019, !date:P1W, !pubdate:P3d/.

Il est également possible de combiner les mots-clefs pour faire un filtrage encore plus précis, et il est autorisé d’avoir plusieurs instances de : f:, author:, intitle:, inurl:, #, et texte libre.

Combiner plusieurs critères implique un et logique, mais le mot clef OR peut être utilisé pour combiner plusieurs critères avec un ou logique : author:Dupont OR author:Dupond

Enfin, les parenthèses peuvent être utilisées pour des expressions plus complexes, avec un support basique de la négation :

• (author:Alice OR intitle:bonjour) (author:Bob OR intitle:monde)
• (author:Alice intitle:bonjour) OR (author:Bob intitle:monde)
• !((author:Alice intitle:bonjour) OR (author:Bob intitle:monde))
• (author:Alice intitle:bonjour) !(author:Bob intitle:monde)
• !(S:1 OR S:2)

ℹ️ Si vous devez chercher une parenthèse, elle doit être échappée comme suit : \( ou \)