[TUTO] Installer simplement Leed sur son hébergement mutualisé

Publié le 15 mars 2013 par Timcruz

Suite à l’annonce de la fermeture prochaine de Google Reader, beaucoup cherchent une solution alternative comme Leed. Le tuto expliquant comment installer Leed sur son propre serveur  existant déjà, je vous propose de découvrir comment l’installer sur son hébergement mutualisé.

What is Leed?

Pour ceux qui se le demande, Leed est un agrégateur de RSS à l’image de Google Reader, RSS Lounge, TinyTinyRSS ou Ardilla. Celui-ci a bien des avantages dont la légèreté, le fait d’être open source ou moins risqué qu’un service propriétaire qui peut (comme va le faire Google Reader) fermer à tout moment.

Leed utilise PHP, JQUERY, HTML5 pour la partie code et MySQL pour la partie base de données. Il est le fruit du travail de Valentin CARRUESCO aka Idleman qui fait très régulièrement évoluer le produit en écoutant les demandes des utilisateurs (comme Cyrille Borne qui a  oublié qu’il l’a découvert Leed grâce à moi – oui, je me la pète – et qui aime en parler à tour de bras).

Pour plus d’info sur le projet, vous pouvez consulter le site du projet ou mon précédent article sur celui-ci.

Un thème imitant le look Google Reader existe aussi pour Leed (par TomCanac) :greeder

Le tuto pour intaller Leed sur son serveur LAMP est dispo ici. Voyons pour notre part comment l’installer sur un hébergement mutualisé :

Pré-requis à l’installation

Les prérequis à l’installation de Leed chez son hébergeur sont les même que sur son propre serveur, à savoir :

  • un serveur Apache (ou lighttpd ou nginx)
  • PHP 5.3 (ou plus)
  • MySQL
  • un minimum de connaissance des hébergements

Ces prérequis sont en général respectés chez les principaux hébergeurs français. Si vous êtes chez OVH ou 1and1, il y a une petite spécificité puisque c’est avec un fichier .htaccess que vous pourrez spécifier votre version de PHP (explication ici pour ovh et ici pour 1&1).

Attention toutefois : les hébergements à bas coûts ne proposent pas toujours la configuration de plusieurs bases de données. Ce tuto ne sera donc applicable que si vous n’hébergez que le service Leed sur votre hébergement ou si votre hébergeur accepte l’hébergement multi-base de données.

Pour les personnes utilisant Leed comme seul service sur leur hébergement, rendez vous directement à l’étape 2

Etape 1 : création d’un sous-domaine

Remarque : cette étape est tout à fait optionnelle et vous pouvez décider de mettre Leed dans un dossier et y accéder via l’url http://nomdedomain.fr/leed

Si vous avez déjà un service avec BDD hébergé, j’en déduis qu’il possède un nom de domaine. Pour se faciliter la chose, on va donc se créer un sous-domaine. Pour ma part, j’ai créé le sous-domaine leed.geekdefrance.fr.

Remarque : Idleman conseille – et a raison – de plutôt choisir rss.nomdedomaine.tld pour garder le sous-domaine en cas de changement de solution d’agrégation de RSS.

Chez Web4all, la chose est très simple et se fait en 3 clics via le manager. En général, la manipulation est aussi simple chez les autres hébergeurs.

Etape 2 : base de données

Bon maintenant que l’on a un sous-domaine, on se crée une base de donnée. Là encore, la manipulation est souvent très simple puisqu’elle est souvent proposée par défaut avec notre hébergement ou peut être créée encore une fois en 3 clic depuis son manager, puis on y ajoute un utilisateur.

Parfois même, la base de données est pré-crée avec un nom inchangeable (par exemple pour les abonnements perso OVH) auquel cas pas besoin de la créer.

Si votre hébergeur vous propose la gestion de vos bases de données via phpMyAdmin et que vous ne savez pas comment faire, je vous propose de consulter ce tuto qui l’explique clairement.

Veillez à bien noter les information relative à : votre host, votre nom de base de donnée et votre nom d’utilisateur (et mot de passe) de base de données.

Etape 3 : upload des fichiers

Maintenant, on va télécharger ici la dernière archive de Leed puis on la décompresse. Il ne reste plus qu’à recopier l’ensemble des fichiers du dossier leed (plus précisément home/ftp/www/projets/leed/archives/leed/ dans l’archive) dans le www de votre hébergement (ou dans le dossier correspondant à votre sous-domaine) en FTP.

Pour éviter d’avoir une erreur 500 au fonctionnement de Leed, on donne les attributs 0755 au dossier où se trouve les fichiers (faisable via Filezilla avec un clic droit>Attributs du fichiers…).

Etape 4 : Installation

Pour installer Leed, il suffit de se rendre à l’adresse http://(votresoudomaine.)votredomaine/install.php.

ex : http://leed.geekdefrance.fr/install.php

On va, tout d’abord, spécifier les informations de base de données créées lors de l’étape 2. A noter que certain hébergeur n’acceptent pas que l’on attaque sa base de donnée via l’hôte localhost. Dans ce cas, n’hésitez pas à solliciter votre hébergeur (ou a regarder sur le panel admin chez ovh et 1&1) pour connaître le nom d’hôte à spécifier.

Puis, on définit le compte Administrateur qui servira à gérer plus tard sa page Leed.

Ensuite, on choisit ses options de synchronisation. Dans le cas d’un hébergement manuel on peut rarement se créer une tache cron, aussi on choisira une synchronisation manuelle.

Enfin, on affine ses préférences (configurable ensuite de toute façon) et on clique sur « Lancer l’installation ».

Maintenant que l’installation est terminée, surtout n’oubliez pas de supprimer le fichier install.php si vous ne voulez pas voir votre installation vilainement et simplement alterné par un vilain méchant.

Vous pouvez maintenant accéder à votre page Leed à l’adresse http://(votresoudomaine.)votredomaine/index.php

Etape 5 : Installation d’un thème Google Reader

Bon et si comme moi vous êtes nostalgique de Google Reader, TomCanac a créé un superbe thème pour leed qui imite Google Reader. Pour l’installer, nous allons d’abord le télécharger via le github de l’auteur et le décompresser (et renommer greeder-master en greeder).

On upload ensuite via FTP le dossier greeder dans le dossier templates de notre site Leed.

Puis on modifie le fichier constant.php pour que la valeur de la variable DEFAULT_THEME soit le nom du thème voulu. Dans notre cas :

define(‘DEFAULT_THEME’,'greeder’);

Si vous préférez le thème par défaut, il vous suffira de re-modifier la variable DEFAULT_THEME au profit de marigolds.

Remarque : Si vous voulez créer votre propre thème, seules quelques notions de css/html sont nécessaires, vous pourrez le proposer à Idleman afin qu’il le mette (après validation) sur sa vitrine et le partage avec la communauté via cette page.

Notez également que le thème de greeder n’étant pas officiel, il peut souffrir de quelques bugs lors de mises à jour de leed, si vous constatez un problème sur le thème, vous pouvez vous adresser directement à Tom Canac (et lui payer une bière pour sa peine parce qu’il est quand même bénévole :p)

Etape 6 : import de ses flux Google Reader

Tant que Google Reader existe encore, autant en récupérer les flux. Dans ses paramètres Google Reader, on sélectionne l’onglet Importer/Exporter, puis Download your data through Takeout.

Via Takeout, on se laisse guider dans la création d’une archive zip. Dans celle-ci se trouve un fichier subscriptions.xml qui est le fichier ompl.

Maintenant, dans Leed>préférences (icône en forme de roulement)>import, on va chercher le fichier subscriptions.xml et on clique sur importer. L’opération étant longue, il ne vous reste plus qu’à patiemment attendre quelques minutes jusqu’à ce que Leed vous indique que l’opération est terminée.

Remarque : L’équipe de Leed travaille encore sur son système d’import/export victime de bugs en fin de vies , aussi il est parfois possible que vous rencontriez quelques erreurs, n’hésitez pas a mailer Idleman pour vous sortir de la

Voila vous avez maintenant un Leed opérationnel et accessible depuis n’importe quel navigateur récent et design responsive pour le consulter depuis son smartphone.

Notez que j’ai effectué cette manipulation chez 2 hébergeurs : toile-libre et Web4All. Il se peut que vous rencontriez des subtilités qui nécessitent une mise à jour de ce tuto. Dans ce cas, n’hésitez surtout pas à me le faire savoir et je mettrai à jour cet article.