Vous trouverez sur cette page, je l'espère, toute l'aide dont vous aurez besoin pour administrer iGalerie. La zone d'administration d'iGalerie se trouve dans le répertoire « admin » du répertoire d'installation.
Schématiquement, iGalerie organise vos images de cette manière :
(catégorie) / (sous-catégories) / album / image
Une catégorie peut contenir soit des sous-catégories, soit des albums, soit les deux à la fois; un album ne peut contenir que des images; enfin les images ne peuvent et doivent se trouver uniquement dans des albums. Il n'est donc pas indispensable de créer des catégories, en revanche vous ne pouvez pas mettre des images directement à la racine de votre galerie. Toutes vos catégories et tous vos albums correspondent à autant de répertoires sur le disque, et se situent dans le répertoire des albums que vous aurez vous-même définis lors de l'installation d'iGalerie.
Lorsque vous ajoutez des images par FTP, vous pouvez les accompagner des vignettes que vous aurez vous-mêmes créées avec le logiciel de votre choix (et qui devront être placées dans le répertoire des vignettes dont vous aurez choisi le nom lors de l'installation), ou bien laisser iGalerie les générer lui-même (cela nécessite la librairie GD), ce qu'il ne fera pas lors de la récupération de vos images (car cela demanderait trop de temps si vous avez beaucoup d'images à ajouter à la fois) mais au moment du premier affichage des vignettes par les pages de la galerie.
Ainsi, l'organisation sur le disque de vos images et de leurs vignettes doit ressembler à ces deux exemples :
- repertoire_des_albums / album / image.jpg
- repertoire_des_albums / album / repertoire_des_vignettes / prefixe_vignette_image.jpg
- repertoire_des_albums / categorie / sous_categorie / album / image.jpg
- repertoire_des_albums / categorie / sous_categorie / album / repertoire_des_vignettes / prefixe_vignette_image.jpg
Il y a deux manières d'ajouter des images (upload FTP et envoi par l'admin), la première étant préférable si vous ajoutez un grand nombre d'images à la fois.
Première méthode : upload FTP
http://www.monsite.fr/galerie/albums/Photos de Jean/http://www.monsite.fr/galerie/ étant respectivement l'adresse de votre site et le répertoire dans lequel iGalerie est installé. Si vous avez plusieurs albums, et que vous souhaitez les regrouper en différentes catégories, alors vous devrez placer vos albums dans des répertoires correspondant aux différentes catégories, et dans lesquels ne doivent se trouver que des répertoires correspondant à des albums ou à des sous-catégories. Par exemple, si vous souhaitez mettre l'album « Photos de Jean » dans la catégorie « Famille », l'adresse de l'album ressemblera à celle-ci :
http://www.monsite.fr/galerie/albums/Famille/Photos de Jean/Si GD n'est pas activé, vous devrez alors envoyer les vignettes des images en même temps que les images elle-mêmes. Les vignettes doivent se situer dans un répertoire nommé par défaut « vignettes » (dont le nom peut être modifié dans la partie « Galerie » de la section « Configuration »), et celui-ci doit de situer dans le même répertoire que les images auxquelles elles correspondent. Pour reprendre l'exemple précédent, cela donnerait ceci si le nom du répertoire des vignettes est « vignettes » :
http://www.monsite.fr/galerie/albums/Photos de Jean/vignettes/Quant au nom d'une vignette, il doit être le même que le nom de l'image à laquelle elle correspond, précédé du préfixe « thumb_ ». Au final, pour une image nommée « jean01.jpg » cela donne donc ceci si le préfixe des vignettes est « thumb_ » :
http://www.monsite.fr/galerie/albums/Photos de Jean/jean01.jpg http://www.monsite.fr/galerie/albums/Photos de Jean/vignettes/thumb_jean01.jpgLa première ligne correpond à l'emplacement de l'image et la seconde à l'emplacement de la vignette. N'oubliez pas enfin que tous les répertoires contenant des images, sauf ceux correspondant aux répertoires de vignettes, seront considéré comme autant d'album.
Deuxième méthode : upload HTTP
La gestion des images, albums et catégories s'effectue dans la section « Albums ». On peut accéder à chaque image soit en cliquant sur les vignettes des albums, soit en utilisant la liste déroulante « Accès direct » (située en haut de page), qui contient la liste de tous les albums et catégories de la galerie. Chaque objet (objet = image, album ou catégorie) de la galerie correspond à un bloc rectangulaire s'étendant sur toute la largeur disponible.
Dans ces blocs, à gauche se trouve la vignette de l'objet, et à l'extrémité droite et en haut se trouve un petit cadre comprenant le type et le numéro d'identifiant de l'objet, ainsi qu'une case à cocher pour sélectionner l'objet. Toujours dans ces blocs, en bas et à droite se trouvent des liens en vert avec une flèche sur le coté droit. Ces liens donnent accès à des parties supplémentaires qui apparaissent sous chaque bloc lorsque l'on clique dessus. Sur chaque bloc se trouvent également des liens permettant d'effectuer des actions (suppression, désactivation, activation). Il est possible d'effectuer ces actions sur plusieurs objets à la fois (traitement par lot), d'abord en les sectionnant, puis en choisissant une option disponible parmi une liste déroulante située en bas de page.
Les différentes actions possibles pour les objets sont les suivantes (entre parenthèses, les objets concernés) :
Pour chaque objet, il est possible de changer le nom et la description (pour cette dernière, il est possible d'y inclure du code HTML). Le nom ne doit pas faire plus de 100 caractères et la description ne doit pas faire plus de 2000 caractères.
Pour les albums et catégories, il est possible de changer le représentant (lien « représentant » situé en bas à gauche de l'objet) et d'ajouter un mot de passe.
Pour les images, il est possible de changer le nom de fichier, la date de création et d'ajouter des tags.
Un lien « désactiver » est disponible à droite de chaque objet.
Il est également possible de sélectionner les objets à désactiver, puis de choisir l'option « désactiver » de la liste déroulante « pour la sélection » qui se trouve en bas de page.
Chaque objet peut être désactivé et réactivé. La désactivation d'un objet rend celui-ci invisible à tous les visiteurs de la galerie, même aux membres disposant du maximum des droits. C'est un moyen simple de rendre invisible un objet sans pour autant le supprimer (toutes les informations qui lui sont associées sont bien entendu conservées). Dès qu'une image est ajoutée dans un album désactivé, ce dernier est réactivé, mais pas les images désactivées qu'il contenait. De même, lorsqu'une image est déplacée vers un album, son « état » (activé ou désactivé) est conservé.
Un lien « supprimer » est disponible à droite de chaque objet.
Il est également possible de sélectionner les objets à supprimer, puis de choisir l'option « supprimer » de la liste déroulante « pour la sélection » qui se trouve en bas de page.
Si vous supprimez une catégorie, tous les albums et images qu'elle contient seront également supprimés. De même, tous les commentaires, tags et votes associés aux images de cette catégorie seront supprimés.
Notes :
- Chez certains hébergeurs, la fonction PHP de suppression de répertoires à été désactivée, ce qui laissera un répertoire vide sur votre espace FTP lorsque vous supprimerez une catégorie. Vous ne pourrez alors supprimer ces répertoires vides que par votre accès FTP.
- Ne supprimez pas d'objet par FTP (hormis pour le point précédent), car les informations de base de données qui lui sont associés ne seront pas supprimées, et l'objet existera toujours dans le script.
Pour déplacer un album ou une catégorie, cliquez sur le lien « déplacer » situé en bas et à droite de l'objet. Il n'est pas possible de déplacer des albums ou catégories contenant plus de 200 images ou plus de 60 Mo (en raison du temps d'exécution). Si vous souhaitez déplacer des albums contenant plus de 200 images, il est toujours possible de déplacer les images qu'il contient (jusqu'à 50 images à la fois).
Pour déplacer une ou plusieurs images, sélectionnez-les puis utilisez la liste déroulante « déplacer la sélection vers » située en bas de page. Les images ne peuvent être déplacées que dans des albums, pas dans des catégories.
Pour chaque album et catégorie, il est possible de remettre à zéro le nombre de visites. Pour cela, cliquez sur le lien « informations » situé en bas et à droite de chaque objet. Cochez la case « Remettre à zéro le compteur de visites » situé sous le tableau d'informations, puis validez.
Si vous protégez un album par un mot de passe, toutes les images qu'il contient le seront aussi avec le même mot de passe. Cela signifie que si un visiteur n'a pas entré le bon mot de passe de l'album, aucune vignette des images qu'il contient n'apparaîtra dans la partie « image au hasard », dans les résultats du moteur de recherche ou via les liens de statistiques. Ainsi, aucune image et aucune vignette d'image d'un album protégé ne sera visible ou accessible.
Notez également que lorsque vous ajoutez de nouvelles images à un album protégé, ces images le seront aussi automatiquement avec le mot de passe de l'album.
Enfin, un mot de passe doit contenir obligatoirement entre 4 et 20 caractères, et ne peut contenir que des chiffres, des lettres non accentuées ou des tirets.
Pourquoi utiliser la gestion de membres ? Cette fonctionnalité permet à des visiteurs de votre galerie de devenir membre et de disposer d'une page profil ainsi que de certaines fonctionnalités nouvelles. Elle permet à certains membres d'envoyer des images dans la galerie, et permet aussi que de créer des groupes pour donner des permissions spécifiques selon le type d'utilisateur que l'on aura soit-même défini.
Toute la gestion des membres s'effectue dans la section « Utilisateurs », en admin. Pour activer cette fonctionnalité, il suffit de cocher la case « Activer la fonctionnalité membres » de la page « Général » de cette section. Une fois ceci fait, une nouvelle partie « membres » apparaîtra sur votre galerie, permettant à chaque visiteur de s'inscrire et ainsi devenir membre. Dès qu'un visiteur s'inscrit, il figurera dans la « liste des membres », accessible pour tout le monde (membre comme simple visiteur). De même, les membres inscrits figureront dans la page « Membres » de la section « Utilisateurs » de l'admin. Sur cette page, en cliquant sur le nom ou l'avatar du membre, vous avez la possibilité de modifier les informations, options et avatar de ce membre. Vous ne pouvez pas changer le mot de passe ou le nom d'utilisateur d'un membre, mais, en revenant sur la page principale « Membres », vous avez en revanche la possibilité de supprimer n'importe quel membre. Pour cela, il suffit de cocher la case d'un ou plusieurs membres, puis de cliquer sur le bouton « supprimer les membres sélectionnés », situé en bas de page.
Avant même toute nouvelle inscription, il existe déjà un membre : l'administrateur. Avec votre nom d'utilisateur et mot de passe admin, vous pouvez donc vous identifier dans la zone des membres. Contrairement aux autres membres, vous ne pourrez pas modifier votre mot de passe dans cette zone (il faut le faire en admin, dans la section « Configuration »). De même, votre profil n'apparaîtra pas dans la section « Utilisateurs » -> « Membres » de l'admin (mais il apparaîtra bien dans la liste des membres de la galerie). Si vous souhaitez être alerté par mail de toute nouvelle inscription, il suffit de cocher la case « Être alerté par courriel de chaque nouvelle inscription », dans la section « Utilisateurs » -> « Général ».
Qu'est-ce qu'un groupe ? A quoi cela sert-il ? Comment créer, modifier ou supprimer un groupe ? Comment changer le groupe d'un membre ? Toutes ces questions auront des réponses dans ce qui suit.
Chaque membre de la galerie se trouve dans un groupe et peut être changé de groupe. Les groupes sont des catégories d'utilisateurs pour lesquelles on peut régler des droits spécifiques : il est possible de donner des droits différents pour chaque groupe. Les droits sont des permissions données à des groupes (et donc aux membres qui en font partie) pour accéder à certains albums ou utiliser certaines fonctionnalités de la galerie (commentaire, votes, etc.). Un exemple d'utilisation serait de donner le droit de poster des commentaires uniquement à ses amis ou aux membres de sa famille, même si la galerie est publique.
La gestion des groupes s'effectue dans la section « Utilisateurs » -> « Groupes ». iGalerie comporte trois groupes de base qu'on ne peut pas supprimer : les groupes « admin », « invités » et « membres ». Le groupe « admin » ne contient qu'un seul membre : l'administrateur. Il n'est pas possible de modifier les droits de ce groupe puisque l'administrateur possède bien sûr tous les droits ! Rappelons qu'il ne peut y avoir qu'un seul administrateur, donc il n'est pas possible à de "simples" membres d'accéder à la partie d'administration. Ce groupe figure dans la liste des groupes uniquement afin de permettre d'en changer le nom et le titre. Le nom d'un groupe ne sert que pour la partie admin afin d'identifier ce groupe, alors que le titre d'un groupe correspond à l'intitulé que se voit attribué chaque membre qui en fait partie (c'est pourquoi il vaut mieux mettre le nom du groupe au pluriel et le titre au singulier). Le titre est visible pour tous les visiteurs de la galerie, dans la liste des membres et dans le profil de chaque membre.
Vient ensuite le groupe « invités », qui correspond aux visiteurs non membres de la galerie. Ce groupe devra bien sûr avoir des droits plus faible que ceux des autres groupes. D'ailleurs, ce groupe ne dispose pas des fonctionnalités « newsletter » et « envoi d'images » (que nous verrons plus loin). Il y a enfin le troisième groupe « membres ». Ce groupe est lui aussi un groupe spécial : tous les utilisateurs qui s'enregistreront feront automatiquement partie de ce groupe, au moins dans un premier temps et avant que vous ne décidiez - éventuellement - de changer le groupe de ses membres.
En plus de ces trois groupes spéciaux, il est possible de créer de nouveaux groupes, via le champ « créer un nouveau groupe ». Tout nouveau groupe peut être modifié ou supprimé, via les liens « modifier » et « supprimer » dans le tableau des groupes. Une question peut se poser : que deviennent les membres d'un groupe que l'on a supprimé ? Rassurez-vous : les membres ne seront pas supprimés, il seront simplement "rétrogradés" et feront désormais partie du groupe « membres » (lequel ne peut pas être supprimé).
Créer des groupes est une chose, mais comment décider de qui fera partie de tel ou tel groupe ? Pour cela, il faut revenir sur la page des membres (section « Utilisateurs » -> « Membres »). Pour chaque membre est associé une liste déroulante contenant tous les groupes disponibles. C'est donc là que vous devrez changer le groupe d'un membre. Il ne reste ensuite qu'à enregistrer en cliquant sur le bouton « valider les changements », situé en bas de page.
Le réglage des droits sur les fonctionnalités s'effectue par la page des groupes, via les liens « modifier » du tableau des groupes. Il suffit ensuite de cocher les cases des fonctionnalités que l'on souhaite autoriser pour ce groupe, situées dans la partie « Autorisations ». Les deux premiers fonctionnalités sont l'envoi de commentaire et le vote. Si ces deux fonctionnalités sont désactivées, tous les membres de ce groupe ne pourront pas poster de commentaire ou voter. Mais ils pourront toujours lire tous les commentaires et afficher tous les votes envoyés par les membres qui en ont l'autorisation.
La case « Personnalisation » correspond à la fonctionnalité du même nom, que l'on peut régler dans la section « Options » -> « Personnalisation », et qui permet aux visiteurs de personnaliser l'apparence de la galerie. Pour la case « Recherche avancée », il s'agit là aussi de la fonctionnalité du même nom.
La fonctionnalité « Newsletter » permet aux membres qui sont abonnés de recevoir un mail chaque fois que de nouvelles images sont ajoutées à la galerie. Mais pour cela, il faut plusieurs conditions. Le membre doit avoir donné son courriel et doit avoir coché la case « S'abonner à la newsletter » de son profil. Et pour que le membre puisse être averti par mail sur de nouvelles images ajoutées dans un album, il faut qu'il ait le droit d'accès à cet album (voir plus bas).
La dernière fonctionnalité permet aux membres d'ajouter des images dans la galerie. En cochant la case « direct », les images seront directement ajoutées à la galerie après envoi par le formulaire d'ajout d'images (via le lien « Envoyer des images »). La case « en attente » permet de ne pas ajouter les images tout de suite, et de les placer en attente de validation de votre part. Ces images seront disponibles dans la section « Utilisateurs » -> « Images en attente ». Sur cette page, deux actions sont possibles : suppression ou validation. Vous pouvez voir l'image en taille réelle en cliquant sur sa vignette. Reste enfin la possibilité de donner à un membre le droit de créer des albums ou catégories, via la case « Création d'albums ». Si vous souhaitez être alerté par mail de toute nouvelle image envoyée par l'un des membres, il suffit de cocher la case « Être alerté par courriel de chaque nouvelle image envoyée », dans la section « Utilisateurs » -> « Général ».
Pour chaque groupe, il est possible de définir quels albums seront accessibles aux membres de ce groupe. Cela se règle dans la page des groupes, via les liens « modifier » du tableau des groupes, et dans la partie « Déverrouiller les albums protégés pour ». Comme son nom l'indique, on gère ici les albums protégés par mot de passe. Les albums protégés par mot de passe sont gérés différemment par iGalerie selon que l'on active ou non la gestion de membres. Si celle-ci est désactivée, les albums protégés seront visibles pour tous les visiteurs, et les stats de ces albums seront comptabilisés dans les stats globales de la galerie (visibles dans la partie « Statistiques » de la page d'accueil). En revanche, si la gestion de membres est activée, les albums protégés seront totalement invisibles pour les invités (les visiteurs non membres de la galerie) et pour les membres qui n'ont pas le droit d'accès à ces albums. De même, les stats de ces albums n'apparaîtront pas dans les stats globales de la galerie. Ce qui signifie qu'un simple visiteur ne pourra même pas savoir si des albums existent dans une galerie dont tous les albums sont protégés par mot de passe et avec gestion de membres activée, car aucune vignette ne sera visible et les stats de la galerie seront à 0 (0 image, 0 visite, etc.). Précisons également qu'un album protégé ne nécessitera aucun mot de passe de la part d'un membre autorisé : à partir du moment où il fait partie d'un groupe pour lequel le droit d'accès à un album à été défini, cet album lui apparaîtra exactement comme les autres. Seuls les flux RSS ne seront pas disponibles.
Maintenant que nous venons de préciser cela, trois choix s'offrent à vous pour gérer les droits d'accès aux albums protégés. Si vous choisissez la case « aucun album », alors aucun album protégé par mot de passe ne sera accessible ou visible pour les membres de ce groupe. Si vous choisissez la case « tous les albums », c'est l'inverse qui se produira : tous les albums protégés par mot de passe seront accessibles pour les membres de ce groupe. Enfin, la troisième case vous permet de régler les autorisations plus finement, en vous permettant de choisir quels albums seront accessibles pour les membres de ce groupe. Pour cela, deux listes sont disponibles : celle des mots de passe déverrouillés, correspondant aux albums protégés accessibles aux membres du groupe ; et celle des mots de passe verrouillés, correspondant aux albums protégés inaccessibles aux membres du groupe. Pour déverrouiller un mot de passe, il suffit de le sélectionner et de cocher la case « Déverrouiller les mots de passe sélectionnés », puis de cliquer sur le bouton « Enregistrer ». Même chose pour l'opération inverse. Chaque mot de passe est précédé d'un nombre et du caractère « : ». Ce nombre correspond à l'identifiant de l'album ou de la catégorie protégée par mot de passe.
Pour modifier le titre de la galerie, il faut aller dans la section « Options -> Textes ». Dans le champ « Titre de la galerie » il est possible de mettre du code HTML. Nous allons utiliser cette fonctionnalité pour mettre une bannière à la place d'un titre textuel. Tout d'abord, il faut savoir que le titre de votre galerie, affiché sur chaque page dans une balise <h1>, est repris pour être intégré dans la balise <title> de chaque page. Comme vous le savez, il est interdit de mettre du code HTML dans cette balise et c'est pourquoi iGalerie supprime toute balise HTML du titre de la galerie avant de le placer dans la balise <title>. Mais il existe une astuce et, depuis la version 1.0 finale, une exception qui permet de passer ce filtrage.
La première technique consiste à utiliser une balise <img> pour afficher une bannière, à coté de laquelle sera placée une balise <span> entourant le titre textuel et qui se chargera de cacher, via CSS, ce texte. Voici un exemple :
<img src="banniere.jpg" /><span style="display:none">Ma Galerie</span>
Ainsi, ce code HTML va bien afficher la bannière, mais ne pas afficher le texte, alors que ce sera l'inverse pour la balise <title> (puisque toute le code HTML sera supprimé, mais pas le texte "Ma galerie").
Depuis la version 1.0 finale, il existe cependant un moyen plus simple de procéder. Il suffit simplement d'utiliser la balise <img> et de mettre le titre de la galerie dans l'attribut alt de celle-ci :
<img alt="Ma galerie" src="banniere.jpg" />
L'attribut alt sert afficher un texte à la place de l'image lorsque celle-ci ne peut être affichée. iGalerie va ainsi se charger de prendre uniquement le texte de l'attribut alt pour le placer dans la balise <title>. Mais pour que ce procédé puisse fonctionner, il ne faut aucune autre balise ou aucun autre texte avant ou après la balise <img>.
Enfin, il convient de préciser que selon le type d'URL choisi, les exemples précédents pourront ne pas fonctionner. En effet, on suppose que le fichier banniere.jpg se trouve dans le répertoire d'iGalerie. Pour que cette image soit bien affichée quel que soit le type d'URL choisi, il faut indiquer son emplacement de façon relative à la racine du site, sans oulblier de placer d'abord un / comme premier caractère :
<img alt="Ma galerie" src="/galerie/banniere.jpg" />
En outre, pour bien faire les choses il faut également préciser les dimensions de la bannière. A noter également que le nom de fichier de votre bannière peut entrainer son blocage par certains filtres antipub utiliser par certains internautes à cause du mot-clé "banniere". C'est pourquoi il vaut mieux utiliser un autre nom, comme par exemple le titre de votre galerie. Au final la meilleure façon de procéder pour afficher une bannière dans iGalerie est de se baser sur l'exemple suivant :
<img alt="Ma galerie" src="/galerie/ma_galerie.jpg" width="400" height="60" />
Il est possible de mettre du code HTML dans la description de la galerie, dans celle des albums, catégories et images, dans le texte de bas de page, le titre de la galerie ainsi que dans le texte de la page contact. Cela permet de styler votre texte (couleur, taille, police, etc.). Le code du template étant en XHTML, il convient cependant de faire attention aux balises à utiliser afin de respecter ce standard. La balise <font> est notamment à bannir au profit, par exemple, de la balise <span> avec l'attribut style dans laquelle seront définis des propriétés CSS.
A titre d'exemples, voici quelques possibilités :
Mettre du texte en gras
<span style="font-weight:bold">Ce texte sera affiché en gras</span>
Mettre du texte en italique
<span style="font-style:italic">Ce texte sera affiché en italique</span>
Colorer du texte
<span style="color:red">Ce texte sera affiché en rouge</span>
(A la place de « red », vous pouvez également utiliser ces autre couleurs prédéfinies : blue, lime, purple, aqua, gray, navy, silver, fushia, marron, yellow, black, green, olive, teal. Pour toute autre couleur, il faudra entrer un code couleur HTML, que l'on peut récupérer dans un logiciel de retouche photo comme Photoshop par exemple. Ce code couleur devra être de cette forme : #F7EED9)
Changer la couleur de fond du texte
<span style="background:silver">Ce texte sera affiché avec un fond gris clair</span>
Changer la taille du texte
<span style="font-size:15px">Ce texte sera affiché en taille 15 pixels</span>
Changer la police de caractère du texte
<span style="font-family:Georgia">Ce texte sera affiché avec la police Georgia</span>
(Notez que si vous choisissez une police trop exotique, elle risque de ne pas s'afficher chez tout le monde car tout le monde n'a pas forcément les mêmes polices que celles installées sur votre ordinateur. C'est pourquoi il vaut mieux n'utilisez que des polices universelles présentes sur chaque ordinateur et dans chaque système d'exploitation, telles que celles-ci : Times New Roman, Georgia, Verdana, Arial, Trebuchet MS, Courier New, Comic Sans MS, Impact)
Espacer les caractères du texte
<span style="letter-spacing:0.05em">Ce texte sera affiché avec un espacement de lettres de 0.05em</span>
Combiner des propriétés CSS
Bien sûr, il est possible de combiner ces propriétés entre elles. Il suffit de les séparer par un point-virgule :
<span style="font-weight:bold;color:red;font-size:15px">Ce texte sera affiché en gras, en rouge et de taille 15px</span>
Vous avez la possibilité de modifier l'apparence de votre galerie en ajoutant ou modifiant templates et styles. Un template est un ensemble de fichier PHP contenant du code HTML mélangé aux fonctions PHP de template (ces fonctions se chargent d'afficher dynamiquement le contenu de la galerie). Un template (partie HTML) peut contenir plusieurs styles (partie CSS). Seuls les styles peuvent, si l'option « Style » est activée (section « Options -> Personnalisation »), être changés par les visiteurs.
Les templates se trouvent dans le répertoire « template » et les styles se trouvent dans un répertoire nommé « style » qui doit se trouver dans le répertoire de chaque template. Pour installer un nouveau template, il suffit d'ajouter un répertoire contenant les fichiers du template dans le répertoire « template ». Rendez-vous ensuite dans la section « Options -> Affichage » afin de choisir le template qui vous convient. Pour les styles, cela fonctionne de la même manière.
Le nom du répertoire des templates et des styles ne doit contenir que des caractères alphanumérique ou les caractères souligné et tiret. Dans le cas contraire, votre template ou style ne sera pas accepté.
Important ! Si vous souhaitez modifier un template ou un style existant, il est recommandé de le dupliquer dans un premier temps en lui donnant un nouveau nom, et ensuite de le modifier. Car sinon, toute mise à jour d'iGalerie écrasera les anciens fichiers et par conséquent vos modifications seront perdues.
Si vous possèdez déjà un site Web, vous pouvez intégrer facilement iGalerie à votre site. Voici les différentes étapes à suivre dans l'ordre :
La première doit être placée en tout début de votre fichier de template, à la toute première ligne (donc avant la balise <html> et tout ce qui peut éventuellement se trouver au dessus) :
<?php require_once(dirname(__FILE__) . '/galerie.php'); ?>
La deuxième (facultative) correspond au titre et doit être placée entre les balises <title> et </title> :
<?php $tpl->getInfo('title'); ?>
La troisième ligne doit être insérée entre les balises <head> et </head> :
<?php require_once(dirname(__FILE__) . '/entete.php'); ?>
Et la dernière devra être placée là où vous souhaitez inclure votre galerie :
<?php require_once(dirname(__FILE__) . '/' . IGAL_TEMPLATE); ?>
Important ! Dans cette configuration, toute mise à jour d'iGalerie vers une version supérieur par copier/remplacer écrasera votre fichier index.php. Il faudra donc, pour une prochaine mise à jour, veiller à d'abord renommer le fichier index.php de la nouvelle version d'iGalerie en index.inc avant de l'envoyer sur le serveur de votre galerie.
Au final, vous pouvez voir à quoi peut ressembler un fichier d'intégration en téléchargeant cet exemple.
Pour activer l'URL rewriting (version 0.7 ou supérieure), vous devez d'abord créer, s'il n'existe pas, un fichier .htaccess à la racine d'iGalerie et y placer le code suivant :
Options -Indexes
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule (.*) index.php?/$1 [QSA,L]
N'oubliez pas de remplacer index.php par le nom du fichier d'accès à la galerie si vous avez intégré iGalerie à un template de votre site.
Ensuite, il vous faudra sélectionner le type d'URL URL rewrite à la section Options -> Général de l'administration.
Notez également que tous les hébergeurs ne supportent pas l'URL rewriting.
Les tags sont des mots-clés (on parle aussi d'« étiquettes ») associés à des objets (dans le cas d'iGalerie, il s'agit bien sûr des images). Dans la galerie, ces tags sont regroupés sur une page (on parle alors de « nuage de tags ») et apparaissent plus ou moins gros selon le nombre d'images qui leurs sont liées. Autrement dit : plus le nombre d'images liées à un tag est grand, plus ce tag apparaitra gros, selon une hiérarchie qui s'établie de 1 (tags les moins fréquents, donc apparaissant en plus petit) à 10 (tags les plus fréquents, donc appraissant en plus gros).
Ceci permet, entre autres, de repérer d'un rapide coup d'oeil les mots-clés les plus importants d'une galerie. En outre, chaque tag possède un lien qui renvoie vers une page n'affichant que les images liées à ce tag, ce qui permet notamment de regrouper des images se trouvant dans des albums différents en fonction de mots-clés communs.
Dans iGalerie, une liste réduite de tags est affichée aux cotés des vignettes, ce qui permet de n'afficher que les 10 ou 20 tags les plus importants pour chaque catégorie. Un lien en dessous permet d'accèder au nuage de tags complet. La liste des tags liées à une image apparaît également sur la page de cette image. L'activation et le réglage du nombre de tags sur la page des catégorie se fait en admin, à la section « Options -> Fonctionnalités ». Pour associer un tag à chaque image, il faut se rendre dans la section « Albums », puis choisir un album par la liste déroulante « Accès direct » ou bien en cliquant sur les vignettes des catégories/albums. Ensuite, pour chaque image il faut cliquer sur le lien « tags » pour faire apparaitre une zone de texte dans laquelle il suffit d'entrer la liste des tags que l'on souhaite associer à l'image, chaque tag devant être séparé par une virgule. Quant à la section « Tags », elle permet d'afficher et de gérer tous les tags de la galerie (suppression, renommage).
Notez enfin que les tags sont sensibles à la casse. Par exemple « rouge » et « Rouge » seront considérés comme deux tags différents.