mirror/FreshRSS
0
0
Fork 0
mirror of https://github.com/FreshRSS/FreshRSS.git synced 2026-03-03 14:07:04 -05:00
Code Issues Packages Projects Releases Wiki Activity
1,110 Commits 3 Branches 84 Tags
736ee492a0fe723b0d6ce9ea59fb3f3eef7ecf23
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
Alexis Degrugillier 736ee492a0 Show only unread when selecting unread 
Before, when there was no unread articles, all articles where displayed. This behaviour was not the one intended.
Now, when there is no unread articles, a message is displayed to alert that there is no article.

See #428

Correction after comment
2014-03-01 14:30:55 -05:00
app
Show only unread when selecting unread
2014-03-01 14:30:55 -05:00
data
Improve sharing
2014-02-22 17:03:36 -05:00
lib
API streamContents for categories and feeds
2014-02-28 20:22:50 +01:00
p
API: SQL optimisation
2014-03-01 15:47:15 +01:00
CHANGELOG
CHANGELOG 0.7.1 + TMP_PATH 0.8
2014-02-21 10:01:40 +01:00
constants.php
CHANGELOG 0.7.1 + TMP_PATH 0.8
2014-02-21 10:01:40 +01:00
index.html
HTTP Auth : améliorations + changelog
2014-01-01 17:01:09 +01:00
index.php
HTTP Auth : améliorations + changelog
2014-01-01 17:01:09 +01:00
LICENSE
Modif du fichier README + l'application s'appellera désormais FreshRSS
2012-10-28 11:49:21 +01:00
README.md
Sharing: Compatibility 0.7
2014-02-23 21:55:45 +01:00

README.md

FreshRSS

FreshRSS est un agrégateur de flux RSS à auto-héberger à l’image de Leed ou de Kriss Feed.

Il se veut léger et facile à prendre en main tout en étant un outil puissant et paramétrable.

Il permet de gérer plusieurs utilisateurs, et dispose d’un mode de lecture anonyme.

Logo de FreshRSS

Disclaimer

Cette application a été développée pour s’adapter à des besoins personnels et non professionnels. Je ne garantis en aucun cas la sécurité de celle-ci, ni son bon fonctionnement. Je m’engage néanmoins à répondre dans la mesure du possible aux demandes d’évolution si celles-ci me semblent justifiées. Privilégiez pour cela des demandes sur GitHub (https://github.com/marienfressinaud/FreshRSS/issues) ou par mail (dev@marienfressinaud.fr)

Pré-requis

  • Serveur modeste, par exemple sous Linux ou Windows
    • Fonctionne même sur un Raspberry Pi avec des temps de réponse < 1s (testé sur 150 flux, 22k articles, soit 32Mo de données partiellement compressées)
  • Serveur Web Apache2 ou Nginx (non testé sur les autres)
  • PHP 5.2.1+ (PHP 5.3.7+ recommandé)
  • MySQL 5.0.3+ (ou SQLite 3.7.4+ à venir)
  • Un navigateur Web récent tel Firefox 4+, Chrome, Opera, Safari, Internet Explorer 9+
    • Fonctionne aussi sur mobile

Capture d’écran de FreshRSS

Installation

  1. Récupérez l’application FreshRSS via la commande git ou en téléchargeant l’archive
  2. Placez l’application sur votre serveur (la partie à exposer au Web est le répertoire ./p/)
  3. Le serveur Web doit avoir les droits d’écriture dans le répertoire ./data/
  4. Accédez à FreshRSS à travers votre navigateur Web et suivez les instructions d’installation
  5. Tout devrait fonctionner :) En cas de problème, n’hésitez pas à me contacter.

Contrôle d’accès

Il est requis pour le mode multi-utilisateur, et recommandé dans tous les cas, de limiter l’accès à votre FreshRSS. Au choix :

  • En utilisant l’identification par formulaire (requiert JavaScript, et PHP 5.3.7+ recommandé – fonctionne avec certaines versions de PHP 5.3.3+)
  • En utilisant l’identification par Mozilla Persona incluse dans FreshRSS
  • En utilisant un contrôle d’accès HTTP défini par votre serveur Web

Rafraîchissement automatique des flux

  • Vous pouvez ajouter une tâche Cron lançant régulièrement le script d’actualisation automatique des flux. Consultez la documentation de Cron de votre système d’exploitation (Debian/Ubuntu, Red Hat/Fedora, Slackware, Gentoo, Arch Linux…). C’est une bonne idée d’utiliser le même utilisateur que votre serveur Web (souvent “www-data”). Par exemple, pour exécuter le script toutes les heures :
7 * * * * php /chemin/vers/FreshRSS/app/actualize_script.php > /tmp/FreshRSS.log 2>&1

Conseils

  • Pour une meilleure sécurité, faites en sorte que seul le répertoire ./p/ soit accessible depuis le Web, par exemple en faisant pointer un sous-domaine sur le répertoire ./p/.
    • En particulier, les données personnelles se trouvent dans le répertoire ./data/.
  • Le fichier ./constants.php définit les chemins d’accès aux répertoires clés de l’application. Si vous les bougez, tout se passe ici.
  • En cas de problème, les logs peuvent être utile à lire, soit depuis l’interface de FreshRSS, soit manuellement depuis ./data/log/*.log.

Sauvegarde

  • Il faut conserver vos fichiers ./data/config.php ainsi que ./data/*_user.php et éventuellement ./data/persona/
  • Vous pouvez exporter votre liste de flux depuis FreshRSS au format OPML
  • Pour sauvegarder les articles eux-même, vous pouvez utiliser phpMyAdmin ou les outils de MySQL :
mysqldump -u utilisateur -p --databases freshrss > freshrss.sql

Bibliothèques incluses

Uniquement pour certaines options

Si les fonctions natives ne sont pas disponibles

Reference in New Issue View Git Blame Copy Permalink
Description
No description provided
Readme 67 MiB
Languages
PHP 79.9%
CSS 10.4%
HTML 7.1%
JavaScript 2.3%
Shell 0.1%
Other 0.1%