Framanews est un fork de ttrss, un lecteur de flux RSS en
ligne. Il vous permet donc de consulter vos flux, de vous y abonner, …
directement depuis un navigateur, où que vous soyez. Il dispose aussi d'une
application Android.
Il est évidement possible d'importer un fichier opml existant pour garder tous
ses flux.
Vous pouvez utiliser Framanews sur des serveurs de Framasoft ou sur votre serveur. C'est ce que nous allons
faire ici.
Installer les bons paquets
Pour faire fonctionner framanews, nous avons besoin de :
- git pour récupérer framanews et ses plugins ou ses thèmes.
- PostgreSQL comme système de base de données.
- php et de ses extensions pour fonctionner avec PostgreSQL.
- nginx (serveur web)
Sur un système basé sur debian, nous pouvons installer tous ça avec :
sudo apt-get install php5 php5-pgsql php5-fpm php-apc php5-curl php5-cli
sudo apt-get install git postgresql nginx
Sur un système basé sur CentOS/RHEL :
yum install postgresql postgresql-libs postgresql-server
yum install php-fpm php-gd php-mbstring php-pgsql php-pdo
yum install git nginx
Reste à activer les bons services (nous les lancerons un peu plus tard) :
service nginx enable
service postgresql enable
service php-fpm enable
Récupérer framanews
Framanews est disponible sur github. Pour le récupérer, placez vous dans le
dossier où vous voulez le placer (/var/www/ pour moi) et lancez :
git clone https://github.com/framasoft/framanews_ttrss.git
Framanews sera alors placé dans /var/www/framanews_ttrss ce que je ne trouve
pas parlant. Je propose de renommer ce dossier en framanews avec :
mv framanews_ttrss framanews
Ensuite, nous devons donner les droits au serveur pour qu'il puisse faire son
travail correctement. La commande peut varier en fonction de votre système. Sous
debian et affiliée, l'utilisateur s'appelle www-data et mais apache sous
CentOS/RHEL et affiliée. On fera donc au choix :
chown -R www-data:root framanews/
ou :
chown -R apache:root framanews/
Finaliser l'installation
Allez sur l'adresse que vous avez choisie pour Framanews (ttrss.jujens.eu pour
moi). Il reste à remplir avec les informations demandées (à adapter à votre cas) :
- Type de base de données : PostgreSQL
- Username : ttrss
- Password : SUPER_MDP
- Database name : ttrss
- Port : 5432
On teste la configuration :
Et on sauvegarde le fichier de conf :
Et voilà !
Je vous laisse faire un tour dans les options pour adapter Framanews à vos
besoins.
Mise à jour des flux
Par défaut, les flux ne se mettent pas à jour via l'interface web. La solution
recommandée est d'entrer la ligne suivante dans un terminal :
su www-data -c './update.php --daemon& > /dev/null&'
Malheureusement, dès que vous quitterez le terminal, le programme sortira. Je
propose donc plutôt d'utiliser le crontab. Pour éditer le
crontab, tapez (en tant que root) :
crontab -e
et ajouter la ligne suivante pour une mise à jour toutes les 30 minutes (le
chemin est à adapter) :
*/30 * * * * su www-data -c '/usr/bin/php /var/www/framanews/update.php --feeds --quiet'
Pour information : cette ligne lance en tant que l'utilisateur www-data le
script update.php.
Si vous n'avez pas de crontab, vous pouvez utiliser la mise à jour en arrière
plan. Framanews va alors tenter de mettre à jour les flux tant qu'il est ouvert
dans votre navigateur. Pour cela, dans /var/www/framanews/config.php mettre
SIMPLE_UPDATE_MODE à TRUE.
Plugins et thèmes
ttrss (et donc Framanews) peut être étendu grâce à des plugins et son pas très
joli thème de base peut être changé. La liste des plugins est disponible ici et celle des thèmes
là. Installer un
thème ou un plugin n'est pas compliqué.
Plugins
Par exemple, pour le plugin framarticle_toolbar, il suffit de :
Se placer dans le dossier plugin de votre installation de Framanews
(/var/www/framanews/plugin pour moi.
Lancer :
git clone https://github.com/framasoft/framarticle_toolbar.git
chown -R www-data:root framarticle_toolbar/
On l'active dans Actions > Préférences > Préférences > Plugin.
Thème
On procède comme pour un plugin, mais en se plaçant dans le dossier theme. On
active le thème dans Actions > Préférences directement dans l'onglet préférence.