|
|
|
Un simple agrégateur de flux rss relativement léger et rapide par rapport aux
|
|
|
|
mastodontes que sont RSSLounge et TinyTinyRSS
|
|
|
|
|
|
|
|
@name FreshRSS
|
|
|
|
@author Marien Fressinaud <contact@marienfressinaud.fr>
|
|
|
|
@version 1.0 alpha
|
|
|
|
@date 2012-10-28
|
|
|
|
@license agpl3
|
|
|
|
|
|
|
|
DISCLAIMER
|
|
|
|
==========
|
|
|
|
Cette application a été développée pour s'adapter à mes besoins personnels.
|
|
|
|
Je ne garantis en aucun cas la sécurité de celle-ci, ni son bon fonctionnement
|
|
|
|
sur un autre serveur que le mien. 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)
|
|
|
|
|
|
|
|
De plus, je n'ai réellement testé FreshRSS que sous Firefox 16, il pourrait y
|
|
|
|
avoir des soucis sur d'autres navigateurs.
|
|
|
|
|
|
|
|
PRE-REQUIS
|
|
|
|
==========
|
|
|
|
- Serveur Apache (pas testé sur aucun autre)
|
|
|
|
- PHP 5.3 (il me faudrait des retours sur d'autres versions)
|
|
|
|
- libxml pour PHP
|
|
|
|
- MySQL
|
|
|
|
|
|
|
|
INSTALLATION
|
|
|
|
============
|
|
|
|
1. Récupérez l'application FreshRSS via la commande git ou en
|
|
|
|
téléchargeant l'archive
|
|
|
|
2. Exécutez le script ./build.sh
|
|
|
|
3. Déplacez la où vous voulez sur votre serveur (attention, la partie
|
|
|
|
accessible de l'application se trouve dans le répertoire `/public`)
|
|
|
|
4. Modifiez le fichier `/app/configuration/application.ini`
|
|
|
|
a/ environment = "production" de préférence
|
|
|
|
b/ use_url_rewriting = true si vous pouvez utiliser
|
|
|
|
l'url_rewriting, false sinon
|
|
|
|
c/ sel_application = "un_truc_aléatoire" à vous de mettre ce que
|
|
|
|
vous voulez, mais ne le changez pas après
|
|
|
|
d/ base_url = "" le chemin qui mène au répertoire `public` à
|
|
|
|
partir du répertoire pointé par le nom de
|
|
|
|
domaine (pas de slash à la fin /!\)
|
|
|
|
e/ title = "FreshRSS" le nom de l'application
|
|
|
|
f/ [db] (host, user, password, base) les paramètres pour accéder
|
|
|
|
à votre base de données mysql
|
|
|
|
5. Éxécutez le script MySQL `freshrss.sql` sur la table définie par le
|
|
|
|
paramètre `base` dans votre base de données (à travers PhpMyAdmin
|
|
|
|
par exemple)
|
|
|
|
6. Vérifiez les droits en lecture / écriture sur le répertoire de log
|
|
|
|
(`/log`) et celui de cache (`/cache`) qui doivent pouvoir étre lu et
|
|
|
|
écrit par le serveur, mais pas les autres
|
|
|
|
7. Tout devrait fonctionner :) En cas de problème, n'hésitez pas à me
|
|
|
|
contacter !
|
|
|
|
|
|
|
|
SÉCURITÉ ET CONSEILS
|
|
|
|
====================
|
|
|
|
1. Si possible, faites pointer un sous-domaine sur le répertoire
|
|
|
|
`/public`
|
|
|
|
2. Assurez-vous de ne laisser qu'un droit de lecture par le serveur sur
|
|
|
|
le fichier `/app/configuration/application.ini` (personne d'autre ne
|
|
|
|
doit avoir le droit d'y accéder !)
|
|
|
|
3. Le fichier de log peut être utile à lire si vous avez des soucis
|
|
|
|
4. Le fichier `/public/index.php` définie les chemins d'accès aux
|
|
|
|
répertoires clés de l'application. Si vous les bougez, tout se passe
|
|
|
|
ici.
|
|
|
|
5. Vous pouvez ajouter une tâche CRON sur l'url de mise à jour des flux
|
|
|
|
(clic droit sur "Mettre les flux à jour" puis "Copier l'adresse du
|
|
|
|
lien") pour que celle-ci se fasse de manière transparente
|