<-- $Id: _lisezmoi.html 757 2008-06-21 13:58:17Z mike007.devpwsphp $ -->

mg3 - Aide en ligne


Révision: 10/02/07

Introduction

Mg3 est une galerie photo que j'avais développé pour mon usage personnel : je souhaitais mettre à disposition sur le net une grande quantité de photos, et permettant de naviguer facilement dans cette base : recherches, affichages par dates, arborescence etc.

Cette galerie a été adaptée pour kws, et pour votre plus grand plaisir.

Remonter

Fonctionnalités

Le script mg3 permet :
Remonter

Installation

Pré-requis

Installation

  1. récupérer le dernier fichier "mg3.zip" disponible
  2. dé-zipper en local le fichier "mg3.zip"
  3. transférer le dossier "mg3" obtenu, ses fichiers et sous-dossiers dans le dossier "modules" du serveur http
  4. en utilisant le gestionnaire dans l'administration de KwsPHP, lancer l'installation, afin de créer les tables nécessaires au fonctionnement du module
  5. ajouter un lien vers la galerie dans le menu principal ( exemple de lien: index.php?mod=mg3 )

L'installation du module est achevée. Vous pouvez alors ajouter le bloc de la galerie ou démarrer la gestion de la galerie.

Remonter

Ajout du bloc de photos aléatoires

L'ajout du bloc de "mg3" se fait de la même façon que n'importe quel bloc de kws.

  1. sélectionner Mon Compte > Administration > Interface
  2. sélectionner le lien "Ajouter un module"
  3. sélectionner le module "mg3"

Le bloc est ainsi ajouté. Il ne s'affiche que lorsqu'il a des images à afficher...

Remonter

Utilisation de la galerie

La navigation dans la galerie se fait en cliquant sur les vignettes, qui représentent soit un sous-album ( l'intitulé est alors entouré par des crochets ), soit une image.

La barre de titre, ou fil d'ariane, est cliquable et présente votre position dans l'arborescence des albums. Elle reprend les intitulés des albums "parents", et contient une barre d'outils sur la droite.

Description des outils disponibles:

La description des images ( date, lieux, mots-clé ) est cliquable et permet de déclencher une recherche sur l'information sélectionnée.

Par ailleurs, en fonction des droits dont l'utilisateur dispose, une barre d'administration permet de réaliser certaines actions ( ajout d'une image etc... )

Enfin, il est possible de déposer des commentaires sur les albums et les images, en utilisant éventuellement les raccourcis de kws pour la saisie des smileys.

Remonter

Gestion de la galerie (simple)

La gestion de la galerie est assez intuitive, un menu contextuel d'administration apparaissant sous les albums et les images. Il vous est alors possible de :

Nota: c'est en éditant les propriétés d'un album que vous pourrez définir le caractère "privé" de celui-ci, et ouvrir l'accès à des utilisateurs ou des groupes ( cf. la partie permissions )

Remonter

Gestion de la galerie (FTP)

La gestion par FTP de la galerie permet de déposer / supprimer en masse les photos, en les organisant par répertoires. Chaque répertoire sera converti en "albums" de la galerie lors de la synchronisation.

Ce procédé a pour seule contrainte de générer en local les vignettes des photos, qui seront déposées dans un sous-répertoire nommé par défaut "thumbnail". En effet, la création "en masse" de vignettes par mg3 utilise l'extension GD2 de PHP, et consomme beaucoup de ressources du serveur.

Un certain nombre de logiciels gratuits et payants vous permettent de facilement générer ces vignettes, traitant parfois toute une arborescence de répertoires en une seule passe. Je vous recommande l'excellent "phpMyVignettes" (GOOgle est votre ami !).

Modus opérandi: Déposez vos répertoires et images sur le serveur, dans le dossier "mg3/albums" ; Ensuite, déclenchez une synchronisation en utilisant la partie "administration" de mg3.

Nota: vous pouvez automatiser certaines propriétés des images et albums, afin de saisir ces informations "une fois pour toutes".

Remonter

Les permissions

Autorisations globales: Les paramètres de mg3 permettent de définir deux permissions qui se basent sur le grade du user : un grade minimum pouvoir visiter la galerie, et un grade minimum pour pouvoir gérer la galerie ( "administrateur de la galerie" ).

L'administrateur de galerie Ce statut donne TOUS les droits au sein de la galerie : modifier, ajouter, supprimer, trier les albums, synchroniser la galerie, suivre la navigation des utilisateurs...

Le propriétaire d'album Ce statut est attribué à tout user qui a créé un album ( soit en ligne, soit lors d'une synchronisation ). Ce user a tous les droits sur son album et les images qu'il contient : éditer les propriétés, trier les sous-albums, déposer / supprimer des photos...

Le propriétaire d'image Ce statut est attribué à tout user qui a ajouté une image dans un album ( soit en ligne, soit lors d'une synchronisation ). Ce user a tous les droits sur son image : éditer ses propriétés, la supprimer.

Il est ensuite possible d'affiner les permissions en jouant sur les propriétés des albums. En tout premier lieu, un album peut être "public" ( accessible à tous ) ou "privé".
Ensuite, la personne habilitée à éditer les propriétés de l'album peut autoriser des users ou des groupes à accéder à l'album privé ( permission "VOIR" ), ou encore des groupes à uniquement déposer des images dans l'album ( permission "UPLOAD" ).
Cas particulier: l'administrateur de galerie peut modifier le propriétaire de l'album, ou désigner un groupe gestionnaire qui aura les mêmes droits que le propriétaire de l'album.

Un album privé ne s'affiche que pour les personnes autorisées à y accéder.
Le statut "privé" d'un album se propage à ses sous-albums.

Remonter

La trace

La galerie permet de tracer la navigation des utilisateurs. L'accès et la gestion de la trace se fait dans la partie administration du module.

Remonter

Propriétés des albums

Lorsque vous en avez la permission, un lien "[Propriétés]" est présent lorsque vous naviguez sur un album.
Voici la signification des données que vous y trouverez :
Intitulé : saisissez ici le titre de l'album
Commentaire : saisissez ici le commentaire de l'album. Celui s'affiche par défaut sous les vignettes de l'album.
Miniature fixe : saisissez ici le chemin vers la miniature qui représentera l'album, au lieu de la miniature par défaut.

Remonter

Questions fréquentes

Remonter

Automatiser l'import des propriétés d'images

mg3 utilise les données IPTC de l'image pour garnir les propriétés. Vous trouverez ICI des informations plus sympa sur le sujet

De plus en plus de logiciels vous proposent cette fonctionnalité, n'hésitez pas à en essayer plusieurs... "XnView", gratuit, réalise de façon très honorable ces opérations, permettant entre autres de propager une information sur une sélection d'images...

FAQ - Remonter

Automatiser l'import des propriétés d'albums

Il est possible d'automatiser les données définissant les albums, au moyen d'un ou 2 fichiers texte déposés dans le répertoire concerné.

commentaire.txt : Saisir dans ce fichier le commentaire que vous souhaitez voir associé à l'album

alb_params.txt : Saisir dans ce fichier l'un ou plusieurs des paramètres suivants:

FAQ - Remonter

Images de grande taille

Ainsi que vous l'avez remarqué, mg3 gère au moins deux tailles d'images : les miniatures et les images "standard" de la galerie. Vous n'avez pas intérêt à afficher des images de grande taille, car celà ralentirait considérablement la navigation dans la galerie ( en particulier pour vos visiteurs qui ne disposent pas d'une connexion à haut débit ).

Pour contourner cette limite, mg3 vous permet de gérer une "3e" taille d'image. Le principe est de stocker dans un sous-répertoire "maxidir" les images en grand format, avec le même nom que l'image standard. Lorsque'une pareille image est détectée, un lien "[image grand format]" apparait lors de l'affichage de l'image standard.

FAQ - Remonter

Peut-on afficher les albums interdits ?

OUI. Positionner le paramètre "$mg3p_alb_affint" à 1.

FAQ - Remonter

Peut-on changer le nombre de miniatures du bloc mg3 ?

OUI. Ajuster le paramètre "mg3p_bloc_nbtn".

FAQ - Remonter

Peut-on afficher ailleurs le commentaire des albums / images ?

OUI. Ajuster le paramètre "mg3p_pcomalb" / "mg3p_pcomimg". Il permet d'afficher les commentaires soit en haut de l'image (0), soit en bas de l'image (1, par défaut), soit en haut et en bas (2).

FAQ - Remonter

OUI. Par défaut, mg3 permet d'agrandir l'image dans une nouvelle fenêtre. Il est possible d'utiliser un affichage plus sophistiqué, un "pop-pop" qui se referme en cliquant en dehors de lui. Pour ce faire, positionner le paramètre mg3 : "mg3p_img_redim".

FAQ - Remonter

Comment gérer les images détaillées

L'idée est de pouvoir afficher des images contenant des zones sensibles qui, lorsque l'on les survole, affichent un texte et permettent éventuellement de déclencher une recherche dans la galerie.

Exemple: une photo de famille, où le nom s'affiche lorsque l'on survole le visage et où une recherche sur la personne se fait dans la galerie lorsque l'on clique sur le visage...

Principe: Lorsque l'on est positionné sur une image de la galerie, mg3 va détecter la présence dans le répertoire d'un fichier du même nom, avec l'extension ".xml", contenant les informations nécessaires à cet affichage particulier. Un lien "[Image détaillée]" s'affiche alors sous l'image en question.

Pour créer le fichier en question, l'admin de galerie a un lien "[Détailler]" qui s'affiche sous l'image.

Nota: le fichier xml ainsi généré est également valable pour les images qui ont été redimentionnées, car les coordonnées saisies sont stockées en format relatif. pensez à les sauvegarder.

FAQ - Remonter

Messages d'erreurs

Fatal error: Call to undefined function: imagecreatetruecolor()
Diagnostic: L'extension GD2 de PHP, nécessaire, n'est pas installée / activée sur le serveur http. Par conséquent, la création d'une miniature a échoué.

Fatal error: Maximum execution time of 30 seconds exceeded in(...)
Diagnostic: Le script a mis trop de temps à s'exécuter sur le serveur ( dépassement de ressource, de temps imparti ), et celui-ci a arrêté son exécution. Celà se produit généralement lors des synchronisations, et en particulier lorsque le script doit générer les vignettes. Solution : utiliser la touche "Actualiser" de votre navigateur autant de fois qu'il est nécessaire. Celà fonctionne dans 99% des cas.

Fatal error: Allowed memory size of ******* bytes exhausted (tried to allocate **** bytes)
Diagnostic: Ce message s'affiche parfois lors de l'upload d'images dans la galerie. L'image que vous transmettez au serveur dépasse la taille autorisée par celui-ci.
Attention: les serveurs prennent en compte la taille "décompressée" des images ( visible dans les propriétés de l'image, par exemple dans des freewares comme Irfanview ). Ainsi, une image jpeg de 400ko peut se retrouver à plus de 8Mo en décompressé...
Une solution: redimentionner l'image avant le transfert ( exemple en 800x600 pixels )

FAQ - Remonter

Mods et Hacks

Cette partie regroupe des modifications / personnalisations significatives de la galerie. Elles sont réservées à un public "averti"..

Remonter

Comment automatiser la création d'un album par nouveau membre ?

blabla

Mods et Hacks - Remonter

Limiter l'édition des propriétés d'albums aux admins

1. dans "mg3/index.php", vers la ligne 203
REMPLACER
$mg3_badmin.= ($mg3_infos_album->acces == 'A'
AND $mg3_album != 0 )
PAR
$mg3_badmin.= ($user->grade >= $mg3p_auth_admin AND $mg3_album != 0 )

2. dans "mg3/alb_edit.php", vers la ligne 29
REMPLACER
if ($mg3_infos->acces != 'A' ) {
PAR
if ($user->grade < $mg3p_auth_admin ) {

Mods et Hacks - Remonter

Enlever les crochets entourant le nom des albums

dans "mg3/fonctions.php", vers la ligne 167
modifier: $fn_textt = '[ '.$fn_textl.$fn_liste_albums[$fn_sousalbum]->alb_intitule.'</a> ]';

Mods et Hacks - Remonter

Désinstallation

  1. en utilisant le gestionnaire dans l'administration de KwsPHP, lancer la désinstallation,
  2. supprimer le dossier "modules/mg3" du serveur http

La désinstallation du module est alors complète.

Remonter

Glossaire

FTP pour File Transfert Protocol. Le mot désigne l'utilisation d'un logiciel spécifique de transfert de fichiers entre votre ordinateur et votre hébergeur. Il vous est possible d'utiliser la galerie "mg3" après un transfert en masse de vos images ( jusqu'à plusieurs milliers ) chez votre hébergeur.

Local. L'expression "en local" désigne votre ordinateur, par opposition au serveur http

Serveur http. L'expression "serveur http" désigne l'endroit où va s'exécuter le script, en général le serveur de votre hébergeur. Les échanges de fichiers entre votre ordinateur et le serveur de votre hébergeur se réalisent par FTP

Synchronisation. Dans le menu d'administration de mg3, vous pouvez déclencher une action de synchronisation, qui mettra les bases de données en adéquation avec les répertoires et fichiers présents sur le serveur.

Remonter