You are on page 1of 17

PIWIGO

Published : 2011-11-17 License : None

INTRODUCTION
Piwigo est un outil de gestion de galerie d'images en ligne. Piwigo gre des galeries partout dans le monde qu'il s'agisse d'une dizaine de photos d'une soire ou de la banque d'image d'une agence photo. Cette volutivit est possible grce une navigation intelligente travers des catgories, des tags ou une chronologie. Piwigo est respectueux des standards de la photographie et du web. Les extensions rendent Piwigo encore davantage volutif et personnalisable. (http://fr.piwigo.org/basics) Il gre les utilisateurs et groupes d'utilisateurs. Il est donc possible de publier des photos prives qui ne seront vue que par les intresss Piwigo bnficie d'une communaut importante et d'une documentation abondante (mme s'il y a encore des manques). Retenez ce lien, nous y ferons rfrence souvent : http://fr.piwigo.org/doc/doku.php? id=pwg22 Attention, ce qui suit est valable pour Piwigo 2.2. La version 2.3 apporte des amliorations et le manuel doit tre mis jour en ce sens.

INSTALLATION
Pr-requis : PHP 5 et MySQL 5. Si votre hbergeur propose plusieurs versions de PHP, crez un fichier .htaccess (ou compltez) dans le rpertoire destin Piwigo et contenant cette ligne :
SetEnv PHP_VER 5

T rs facile. T out d'abord, tlchargez l'archive sur http://fr.piwigo.org/basics/downloads Essayez d'abord le NetInstall. Il s'agit d'un fichier PHP dposer sur votre hbergement (par exemple /www/piwigo-netinstall.php o www est la racine de votre site Web). Avec votre navigateur, tapez l'URL de ce fichier PHP (comme pour l'afficher, mais avec un fichier PHP, il sera excut) : http://mondomaine.com/piwigo-netinstall.php Si les pr-requis sont respects, le script tlcharge Piwigo l'emplacement de votre choix et lance l'installation.

Une fois tous les renseignements saisis (certains vous sont fournis par votre hbergeur), l'installation se droule et abouti normalement un succs.

PRISE EN MAIN
1. CONFIGURATION 2. PUBLIER DES IMAGES

1. CONFIGURATION
La partie administrative (ou les coulisses ou le backend comme ils disent en anglais) se trouve l'adresse http://URL_de_la_galerie/admin.php. Pour chaque cran de la partie administrative vous avez la possibilit de lire l'aide en ligne. Le point d'interrogation situ en haut droite ouvre un nouvel onglet (ou une nouvelle fentre) du navigateur avec l'aide de la page courante.

OPTIONS
Par dfaut, la galerie se nomme Piwigo demonstration site avec pour sous-titre My photos web site . Allez dans l'interface d'administration, dans le menu Configuration Options puis modifiez le titre de la galerie et ma bannire des pages votre convenance. Remarquez que pour la bannire, vous pouvez utiliser une syntaxe HT ML. Profitez-en pour rgler d'autres options. Si vous souhaitez qu'une partie des photos soient prives, les personnes autorises devront avoir un compte utilisateur. Soit vous les crez vous-mme, soit vous laissez faire les utilisateurs et validez ensuite. Dans ce dernier cas, il faut cocher Permettre l'enregistrement des utilisateurs et, ventuellement, Notifier les administrateurs lors de l'inscription d'un utilisateur . L'adresse e-mail peut tre utile si vous souhaitez envoyer une notification lorsque vous mettez jour certains albums privs. Dans le menu Configuration Menu vous choisissez les lments apparaissant ou non dans la partie gauche de la galerie. Enfin, dans le menu Configuration Thmes vous pouvez changer le thme (l'apparence de la galerie), voire en tlcharger de nouveaux, directement depuis Piwigo.

Dans l'onglet Ajouter un thme , cliquez simplement sur Installer . Piwigo tlcharge et installe le thme dans le rpertoire themes . Attention, l'utilisateur www-data doit avoir les droits d'criture sur ce rpertoire. C'est le cas si vous avez utilis le NetInstall. Si vous ne pouvez installer le thme parce que Piwigo ne peut crire dans le rpertoire, vrifiez les droits.

UTILISATEURS ET GROUPES
Pour les photos publiques, pas de souci, n'importe qui peut les voir dans son navigateur sans avoir se connecter (on peut toutefois limiter l'accs aux images haute dfinition aux utilisateurs connects). Pour les photos prives (par exemple lorsque des personnes sont prsentes sur la photo et qu'elles n'ont pas spcifi explicitement et par crit qu'elles souhaitaient apparatre sur Internet) il faut donc que le visiteur soit connect. En tant qu'administrateur vous pouvez crer des groupes et assigner les utilisateurs dans ces groupes (un utilisateur peut appartenir plusieurs groupes). Ensuite, vous pourrez autoriser l'accs aux albums privs par groupes ainsi que par utilisateurs. Le menu Utilisateurs donne accs tous ces paramtres : Grer Groupes Notifications par e-mail Les utilisateurs ont tous un statut. Le statut Webmestre est celui donnant tous les droits (plus que le statut Administrateur ). Il est conseill d'avoir au moins deux webmestres afin de garder la main sur la galerie si l'un d'eux se fait pirater son compte. Il faut avoir le statut webmestre pour ajouter des photos depuis un logiciel externe comme Les utilisateurs authentifis ont, en principe, le statut Visiteur .

ALBUMS ET PHOTOS
Il existe deux types d'albums : physiques : ils correspondent des rpertoires crs dans le rpertoire galleries l'aide d'un logiciel FT P (et les photos dposes de la mme manire) ; virtuels : ils n'existent que dans la base de donnes, les photos sont ranges dans le rpertoire upload (cette information n'tant pas ncessaire pour la cration d'albums virtuels).

l'origine de Piwigo (du temps de PhpWebGallery comme il s'appelait avant) seuls les albums physiques taient possibles. C'est d'ailleurs la mthode triviale d'ajout de photos : on cre des rpertoires et y dposons les photos l'intrieur. Cependant, les albums virtuels permettent une gestion plus souple. T out se gre depuis l'interface Web (ce qui n'est pas le cas des albums physiques pour lesquels il faut passer par un client FT P, et encore, le dplacement de rpertoires n'est pas ais, vu que des informations sont tout de mme inscrites dans la base de donnes). Le dplacement d'album se fait simplement. Une photo peut tre prsente dans plusieurs albums sans pour autant tre physiquement duplique sur l'espace disque. Avec un greffon l'on peut mme crer des albums partir des tiquettes (tags) des photos. Bref, dans la pratique l'on est tent de commencer avec des albums physiques, plus rassurants car l'on sait o se trouvent les photos, comment elles sont ranges. Mais l'on vient vite aux albums virtuels pour leur souplesse. Depuis le menu Albums Grer vous ne pouvez crer que des albums virtuels. Pour ceux qui veulent tout de mme connatre les coulisses, les photos sont donc ranges dans le rpertoire upload puis classes par anne, mois et quantime de la date du dpt de l'image. Ainsi, aucun risque de rpertoire surcharg !

2. PUBLIER DES IMAGES


C'est tout de mme le but ultime ! Il y a plusieurs mthodes, certaines moins fatigantes.

DIRECTEMENT VIA PIWIGO


Via le menu Photos Ajouter l'onglet Ajouter des photos propose la mthode traditionnelle d'envoi de fichier sur un site Web, avec sa zone de saisie, son bouton parcourir. On peut donc, ainsi, envoyer un ou des fichiers Jpeg et/ou Zip. Il est intressant de noter que l'on peut grouper plusieurs photos dans une archive Zip plutt que de les slectionner une une. Mais, la fonction qui permet d'envoyer un fichier sur le Web est gnralement bloque 2 Mo. De nos jours une photo numrique a tendance peser dans les 5 Mo voire plus. Donc, a coince (et ne pensez pas que de mettre la photo dans une archive Zip va diminuer son poids, le Jpeg est dj un format trs compress et vous ne gagnerez rien). Deux solutions ce problme de poids : La plus raisonnable : diminuer les dimensions de la photo. En effet, une photo de 5 Mo mesure environ 3000 pixels de large. Les crans les plus grands mesurent, en cette anne 2011, 1920 pixels de large sur 1080 de haut. On peut donc envisager de rduire les images 1000 pixels de large (et avoir un fichier qui pse dans les 400 ko). La moins durable : ouvrir les vannes. La limite de 2 Mo est dfinie dans la configuration de PHP. Il est possible de la redfinir localement avec un fichier .htaccess . Par exemple, portons cette limite 50 Mo :
<IfM odule mod_php5.c> php_value file_uploads O n php_value upload_max_filesize 50M php_value post_max_size 50M php_value max_input_time 60 php_value max_execution_time 60 </IfM odule>

VIA UN LOGICIEL TIERS


Dans l'onglet Piwigo Uploader vous trouverez le logiciel du mme nom installer sur votre ordinateur. C'est une version un peu ancienne (en aot 2011 la dernire version date de mai 2010) et la version Ubuntu ne fonctionne que sur une Ubuntu ancienne (9.10). Oublions-le pour l'instant, mais tout en gardant un il sur les mises jour. Sinon, il y a digiKam et son module d'export vers diverses galeries en ligne dont Piwigo. Voir la page mettre des photos dans Piwigo avec digiKam ( rdiger).

MAINTENANCE
3. INSTALLER DES EXTENSIONS 4. METTRE JOUR PIWIGO

10

3. INSTALLER DES EXTENSIONS


Piwigo propose une pliade d'extensions rajoutant moultes fonctions votre galerie. Attention : trop d'extensions tuent le logiciel ! En effet, lorsque vous installez des extensions vous : introduisez du code produit par d'autres personnes que les dveloppeurs du cur de Piwigo ; ces extensions sont normalement valides pour tre publies sur http://piwigo.org, mais des failles peuvent chapper leur vigilance ; risquez que ces extensions ne suivent pas les volutions du cur et de vous retrouver avec des fonctions qui font planter la galerie ; risquez que votre galerie devienne ingrable. Donc, installez des extensions si vous avez besoin d'une fonction absente de base, mais avec parcimonie ! Ceci est valable pour toute application (Web ou locale) proposant un mcanisme d'extensions. Une fois cela tant pos, allez dans le menu Plugins Grer (plug-in tant un terme anglais se traduisant par greffon ou par extension galement). L'onglet Liste des plugins montre tous les plugins activs, seulement installs mais inactifs ou seulement tlchargs mais pas installs. L'onglet Rechercher des mises jour vous aide vrifier si les extensions que vous possdez existent en une version plus rcente. Enfin, l'onglet Autres plugins disponibles liste tous ceux disponibles sur le site de Piwigo et que vous pouvez installer d'un clic sur le lien Installer . Comme pour les thmes, il se peut qu'il faille ajuster les droits du rpertoire plugins de Piwigo. Une fois installe depuis l'onglet Autres plugins disponibles retournez dans Liste des plugins pour installer (l'extension passe de non-install dsactiv ) puis activer l'extension.

11

4. METTRE JOUR PIWIGO


La mise jour de Piwigo est un passage oblig si vous souhaitez utiliser votre galerie dans le temps, tout en la protgeant d'ventuelles failles de scurits (dcouvertes puis corriges) et en bnficiant de nouvelles fonctionnalits et d'amlioration proposes par les utilisateurs (vous peut-tre ? ). C'est fort dommage, mais la mise jour facile de Piwigo n'est disponible que via une extension (sinon, il reste videmment la mthode manuelle qui consiste tout sauver soi-mme, dcompacter la nouvelle version en crasant l'ancienne et prier que tout fonctionne) modifier : depuis la version 2.3, Autoupgrade est intgr au cur de Piwigo. Donc, installez cette extension qui vous sera fort salutaire ! Elle s'appelle Piwigo AutoUpgrade .

Une fois installe puis active, vous pouvez l'utiliser via le menu Plugins Piwigo AutoUpgrade.

L encore, un simple clic suffit mettre jour votre Piwigo. Notez que vous avez-l un onglet pour grer directement les mises jour des extensions. Enfin, comment savoir qu'une nouvelle version est disponible ? Sur la page d'accueil cliquez sur le lien Dernire version ? et vous aurez la rponse (ce lien est prsent mme sans l'extension).

12

CAS PRATIQUES
5. PARTAGER DES PHOTOS PRIVES SANS AUTHENTIFICATION

13

5. PARTAGER DES PHOTOS PRIVES SANS


AUTHENTIFICATION
Nous l'avons bien vu prcdemment, pour partager des photos prives, il faut que les bnficiaires aient un compte utilisateur avec un mot de passe. Oui mais sur Picasa(*) j'envoie juste un code et mes amis seulement peuvent voir mes photos (* d'autres services dit gratuits galement). Il y a une extension qui propose le mme comportement, c'est--dire, que vous pouvez gnrer une URL particulire contenant un code impossible deviner. Vous n'avez alors qu' envoyer cette URL vos destinataires et ils peuvent voir les photos sans s'authentifier. Cela peut tre intressant pour un album ponctuel, mais il est plus intressant, sur le long terme, de crer des comptes utilisateur pour que vos amis puissent consulter des nouveaux contenus que vous aurez mis en ligne. Cette extension s'appelle Event Cats. Rien voir avec les chats, cela signifie Event categories ou catgories vnementielles, ce qui traduit l'aspect ponctuel du contenu ainsi vis. Allez ensuite dans Plugins Event Cats. L'onglet Cration autolog vous permet de crer facilement ce code. Choisissez d'abord une page afficher (tout en bas du formulaire), une catgorie (un album) par exemple, puis cliquer sur le bouton T out automatique . Le code est gnr, un utilisateur est prvu pour tre cr (du mme nom que l'album) avec son groupe (inutile, vous pouvez le dcocher). Un mot de passe est gnr que vous pouvez recopier dans la case Confirmez . Ensuite, validez.

L'onglet Entres autolog apparat et contiendra toutes les entres cres par ce biais.

14

Cochez l'entre que vous venez de crer. L'URL apparat dans le champ idoine. Recopiez-l et envoyez-la vos correspondants.

Il n'y a pas besoin du mot de passe pour accder la page voulue.

15

ANNEXES
6. A PROPOS DE CE LIVRE

16

6. A PROPOS DE CE LIVRE
Ce livre est bas sur une documentation rdige par Dimitri Robert, dans le cadre de son activit pour Libres vous et plus particulirement une action d'tude d'un certain nombre de logiciels libres, finance par le Fonds social europen. Afin d'enrichir ce premier jet et, pourquoi pas, d'aboutir un livre complet, il a dcid de le publier, sous licence libre, sur Flossmanuals FR.

17

You might also like