+ + + + + +

Mettre à jour wallabag

Pour mettre à jour votre installation, téléchargez et décompressez l’archive dans votre installation (ici /var/www/html/wallabag/) :

wget http://wllbg.org/latest
+unzip latest
+rsync -ur wallabag-version-number/* /var/www/html/wallabag/

Supprimez le répertoire install et videz le cache :

cd /var/www/html/wallabag/
+rm -r cache/* install/

Pour vider le cache, il est également possible d'aller dans la page de configuration et de cliquer sur le lien pour supprimer le cache.

Vérifiez dans le bas de la page de configuration que la dernière version est bien installée.

+ +

+ + + + + +

wallabag multi-utilisateurs

Créer un nouveau compte

Si vous souhaitez utiliser wallabag pour plusieurs personnes, il est possible de créer de nouveaux comptes depuis la page de configuration.

En bas de cette page se trouve un formulaire où vous devez saisir un nom d'utilisateur et un mot de passe.

Il est maintenant possible de se connecter avec ce compte depuis la page d'identification de wallabag.

Aucune information n'est partagée entre les différents comptes.

Supprimer un compte

Il est possible de supprimer son propre compte, depuis la page de configuration. Il suffit de saisir son mot de passe et de demander la suppression.

Attention, lorsqu'il ne reste plus qu'un compte, il est évidemment impossible de le supprimer.

+ +

+ + + + + +

Options cachées

Mise en garde

Attention, cette partie concerne les utilisateurs avancés. Nous allons modifier un fichier important de wallabag, inc/poche/config.inc.php, il est donc conseillé de faire une sauvegarde de celui-ci avant toute modification.
+Toute erreur lors d'une modification d'un fichier de wallabag pourra entrainer des dysfonctionnements.

Ce fichier est créé lorsque vous installez wallabag.
+Installez donc d'abord wallabag, faites une copie du fichier et ouvrez-le avec ~~Sublime Text~~ votre éditeur de texte préféré.

Dans ce fichier sont définis des paramètres qui ne sont, aujourd'hui, pas encore disponibles dans la page Configuration de wallabag.

Modification des options avancées

Chaque paramètre est défini de cette façon :

@define ('NOM_DU_PARAMETRE', 'Valeur du paramètre');

Pour chaque ligne, vous ne pouvez modifier que la partie Valeur du paramètre.

Listons maintenant les différents paramètres que vous pouvez changer :

HTTP_PORT (par défaut, 80) : correspond au port HTTP de votre serveur web. À changer si votre serveur web est derrière un proxy. Valeur attendue : un nombre.
SSL_PORT (par défaut, 443) : correspond au port SSL de votre serveur web. À changer si votre serveur web utilises SSLH. Valeur attendue : un nombre.
DEBUG_POCHE (par défaut, FALSE) : si vous rencontrez des problèmes avec wallabag, nous vous demanderons peut-être d'activer le mode Debug. Valeurs attendues : TRUE ou FALSE.
DOWNLOAD_PICTURES (par défaut, FALSE) : permet de télécharger sur votre serveur les images des articles. Ce paramètre est désactivé par défaut pour ne pas surcharger votre serveur web. Nous préférons vous laisser activer vous-même ce paramètre. Valeurs attendues : TRUE ou FALSE.
SHARE_TWITTER (par défaut, TRUE) : permet d'activer le partage vers twitter. Valeurs attendues : TRUE ou FALSE.
SHARE_MAIL (par défaut, TRUE) : permet d'activer le partage par email. Valeurs attendues : TRUE ou FALSE.
SHARE_SHAARLI (par défaut, FALSE) : permet d'activer le partage vers votre installation de Shaarli (gestionnaire de favoris). Valeurs attendues : TRUE ou FALSE.
SHAARLI_URL (par défaut, 'http://myshaarliurl.com') : définit l'URL de votre installation de Shaarli. Valeur attendue : une URL.
FLATTR (par défaut, TRUE) : permet d'activer la possibilité de flattrer un article (Flattr est une plateforme de micro-dons). Si un article est flattrable, une icône s'affichera et vous permet d'envoyer un micro-don à l'auteur de l'article. Valeurs attendues : TRUE ou FALSE.
SHOW_PRINTLINK (par défaut, '1') : permet d'afficher le lien pour imprimer un article. Valeurs attendues : '0' pour désactiver ou '1' pour activer.
SHOW_READPERCENT (par défaut, '1') : permet d'afficher (sur les thèmes default, dark, dmagenta, solarized, solarized-dark) le pourcentage de lecture de l'article. Valeurs attendues : '0' pour désactiver ou '1' pour activer.
PAGINATION (par défaut, '12') : définit le nombre d'articles affichés sur une liste. Valeur attendue : un nombre.

+ +

+ + + + + +

Télécharger et installer wallabag

Je ne souhaite pas installer wallabag

Puisque vous ne voulez pas, puisque vous ne pouvez pas, nous vous proposons de vous créer un compte gratuit : lisez la documentation complète ici.

Je souhaite installer wallabag

Je souhaite télécharger wallabag via composer

Vous devez installer composer :

curl -s http://getcomposer.org/installer | php

Ensuite, sur votre serveur web, exécutez cette commande :

composer create-project wallabag/wallabag . dev-master

Tout est téléchargé dans le répertoire courant.

Continuez en lisant la partie ci-dessous, Création de la base de données MySQL.

Je souhaite télécharger wallabag manuellement

Téléchargez la dernière version de wallabag et décompressez-la :

wget http://wllbg.org/latest
+unzip latest
+mv wallabag-version-number wallabag

Copiez les fichiers sur votre serveur web. Dans le cas d'Ubuntu/Debian, il s'agit de /var/www/html/ :

sudo mv wallabag /var/www/html/

Pré-requis pour votre serveur web

Pour être sûr que votre serveur possède tous les pré-requis, vous pouvez exécuter le fichier wallabag_compatibility_test.php qui se trouve dans le répertoire install de wallabag : dans votre navigateur, accédez à http://votreserveur.com/wallabag/install/wallabag_compatibility_test.php et installez les composants requis. Par exemple pour Tidy sur Ubuntu/Debian :

sudo apt-get install php5-tidy
+sudo service apache2 reload

Installation des dépendances

Pour pouvoir fonctionner, wallabag a besoin de dépendances. Pour les installer, vous devez utiliser composer. Placez-vous dans votre dossier wallabag (toujours dans le cas d'Ubuntu/Debian : /var/www/html/wallabag/) et exécutez les commandes suivantes :

curl -s http://getcomposer.org/installer | php
+php composer.phar install

Si vous ne pouvez pas installer composer (dans le cas d'hébergement mutualisé par exemple), nous vous proposons un fichier vendor.zip. Vous pouvez soit le télécharger puis le décompresser dans votre répertoire wallabag, soit laisser le script d'installation le faire pour vous.

Création de la base de données MySQL

wallabag peut s'installer sur différents types de bases de données (sqlite, mysql ou postgresql), mais nous vous conseillons d'utiliser MySQL, plus performante. Il est alors nécessaire de créer une nouvelle base (par exemple wallabag), un nouvel utilisateur (par exemple wallabag) et un mot de passe (ici VotreMotdePasse). Vous pouvez pour cela utiliser 'phpMyAdmin', ou exécuter les commandes suivantes :

mysql -p -u root
+mysql> CREATE DATABASE wallabag;
+mysql> GRANT ALL PRIVILEGES ON `wallabag`.* TO 'wallabag'@'localhost' IDENTIFIED BY 'VotreMotdePasse';
+mysql> exit

Permissions

Le serveur web doit avoir accès en écriture aux répertoires assets, cache et db. Sans cela, un message vous indiquera que l'installation est impossible :

sudo chown -R www-data:www-data /var/www/html/wallabag

Installation de wallabag. Enfin.

Accédez à wallabag depuis votre navigateur : http://votreserveur.com/wallabag. Si votre serveur est bien configuré, vous arrivez sur l'écran d'installation.

Renseignez le type de votre base de données (sqlite, mysql ou postgresql) et les informations de votre base de données. Dans le cas de la base MySQL créée plus haut, la configuration standard sera :

Database engine:    MySQL
+Server:             localhost
+Database:           wallabag
+Username:           wallabag
+Password:           VotreMotdePasse

Créez enfin votre premier utilisateur et son mot de passe (différents de l'utilisateur de la base de données).

wallabag est maintenant installé.

Connexion

Vous arrivez sur l'écran d'identification : saisissez votre identifiant et votre mot de passe et vous voici connecté.

+ +