Paramétrage d'un site distant

Les paramètres suivants peuvent être modifiés pour adapter le script create_listing_file.php au besoin de l’utilisateur ou au serveur sur lequel il est installé.

Certains paramètres exigent plus de compétences techniques que d’autres pour être manipulés. N’hésitez pas à utiliser le forum pour en discuter.

$conf['gallery'] = 'http://www.mon.domaine/ma/galerie';

C’est l’adresse de votre galerie principale. Elle sert à afficher un lien de retour et les images des différent boutons.

$conf['prefix_thumbnail'] = 'TN-';

C’est le préfixe utilisé pour le nom des miniatures.

Il DOIT être identique au préfixe utilisé sur la galerie principale.

Par défaut, PhpWegGallery utilise le préfixe TN-.

$conf['file_ext'] = array('jpg','JPG','jpeg','JPEG','png','PNG','gif','GIF','mpg','zip', 'avi','mp3','ogg');

C’est la liste des extensions de fichier supportées par PhpWebGallery.

Les majuscules/minuscules DOIVENT être respectées. Vous ne listerez pas les fichiers ayant l’extention ‘pDf’, en ajoutant ‘pdf’ ou ‘PDF‘.

$conf['picture_ext'] = array('jpg','JPG','jpeg','JPEG','png','PNG','gif','GIF');

C’est la liste des extensions de fichier d’images supportées par PhpWebGallery.

Cette liste ne DEVRAIT pas être modifiée sans demander conseil.

Un serveur web correctement configuré autorise l’exécution d’un script pour un durée déterminée. C’est le paramètre max_execution_time de PHP (Plus d'informations) qui est généralement fixé à 30 secondes.

Si ce serveur est vraiment bien configuré, le mode SAFE est activé. C’est le paramètre safe_mode de PHP (Plus d'informations) qui est généralement fixé à 1 (true).

Dans ce contexte, un script dispose de 30 secondes pour générer le fichier listing.xml avant de planter, ce qui arrivait avec des galeries très importantes en nombre de photos avec les versions de PhpWebGallery antérieures à 1.7.0.

La version 1.7.0 de PhpWebGallery contourne cette restriction en affichant une page intermédiaire avant le max_execution_time fatidique. Cette page intermédiaire va être rafraîchie (après quelques secondes) jusqu’à ce que le fichier listing.xml soit complet.

$conf['max_execution_time'] = (5*ini_get('max_execution_time'))/6;

C’est le temps maximum entre le début du script et l’affichage de la page intermédiaire.

Par défaut, il est égal à 5/6^èmes du temps autorisé par le serveur.

Il ne DEVRAIT pas être modifié sans demander conseil.
Il DEVRAIT être fonction du temps autorisé par le serveur. Il ne DOIT pas être égal à 0.

$conf['refresh_delay'] = 0;

C’est le temps entre l’affichage de la page intermédiaire et son rafraîchissement.

Par défaut, il est égal à 0 secondes.

Si vous voulez en savoir plus sur l’EXIF : Wikipedia :: EXIF

$conf['use_exif'] = false;

Ce paramètre détermine si le script doit extraire les informations EXIF des images listées (true) ou non (false).

Il DOIT être égal à ‘true’ ou ‘false‘.

Par défaut, il est égal à false.

$conf['use_exif_mapping'] = array(
  'date_creation' => 'DateTimeOriginal'
  );

Ce paramètre liste les informations EXIF à extraire des images.

Lister les champs standards EXIF, faire le lien avec la configuration de la galerie principale.

Si vous voulez en savoir plus sur l’IPTC : Wikipedia :: IPTC

$conf['use_iptc'] = false;

Ce paramètre détermine si le script doit extraire les informations IPTC des images listées (true) ou non (false).

Il DOIT être égal à ‘true’ ou ‘false‘.

Par défaut, il est égal à false.

$conf['use_iptc_mapping'] = array(
  'keywords'        => '2#025',
  'date_creation'   => '2#055',
  'author'          => '2#122',
  'name'            => '2#005',
  'comment'         => '2#120');

Ce paramètre liste les informations IPTC à extraire des images.

Lister les champs standards IPTC, faire le lien avec la configuration de la galerie principale.

$conf['protect'] = false;

Ce paramètre détermine si les répertoires listés doivent être protégés automatiquement (true) ou non (false).

Il DOIT être égal à ‘true’ ou ‘false‘.

Par défaut il est égal à false.

$conf['protect_content'] = '<?php header("Location: '.$conf['gallery'].'") ?>';

C’est le contenu du fichier index.php, créé dans chaque répertoire listé pour le protéger.

Par défaut il redirige automatiquement les visiteurs à l’adresse indiquée dans les paramètres de la galerie.

$conf['protect_warnings'] = true;

Ce paramètre détermine si le script affiche un message (true) ou non (false) quand un répertoire est déjà protégé.

Il DOIT être égal à ‘true’ ou ‘false‘.

Par défaut il est égal à false.

$conf['thumbnail'] = false;

Ce paramètre détermine si la miniature d’une image doit être générée automatiquement (true) ou non (false) lorsqu’elle n’existe pas.

Il DOIT être égal à ‘true’ ou ‘false‘. Le script désactive automatiquement la génération des miniatures si le serveur ne supporte la génération d’image ou si les autres paramètres de configuration sont erronés.

Par défaut la valeur est égale à false.

$conf['thumbnail_method'] = 'ratio';

C’est la méthode employé pour déterminer la taille de la miniature à générer :

• ‘fixed’ : la taille de la miniature est fixée par les paramètres thumbnail_width et thumbnail_height.
• ‘width’ : la largeur de la miniature est fixée par le paramètre thumbnail_width. La hauteur respectera les proportions largeur/hauteur de l’original.
• ‘height’ : la hauteur de la miniature est fixée par le paramètre thumbnail_height. La largeur respectera les proportions largeur/hauteur de l’original.
• ‘ratio’ : la largeur/hauteur de la miniature sera égale à la largeur/hauteur de l’original multipliée par thumbnail_ratio.
• ‘exif’ : la miniature est extraite directement de l’image qui la contient.
• Toute autre valeur désactive la génération automatique des miniatures.

Par défaut elle est égale à ratio.

$conf['thumbnail_height'] = 128;

C’est la hauteur en pixels des miniatures.

Si elle est utilisée, elle DOIT être numérique et supérieure à 0. Dans le cas contraire, la génération automatique des miniatures est désactivée.
Elle est OBLIGATOIRE quand la méthode de génération est ‘fixed’ ou ‘height.

Par défaut elle est égale à 128 pixels, comme la hauteur par défaut des miniatures sur une galerie principale.

$conf['thumbnail_width'] = 128;

C’est la largeur en pixels des miniatures.

Si elle est utilisée, elle DOIT être numérique et supérieure à 0. Dans le cas contraire, la génération automatique des miniatures est désactivée.
Elle est OBLIGATOIRE quand la méthode de génération est ‘fixed’ ou ‘width.

Par défaut elle est égale à 128 pixels, comme la largeur par défaut des miniatures sur une galerie principale.

$conf['thumbnail_ratio'] = 0.2;

C’est la proportion entre entre les dimensions de l’image et celles de la miniature.

Si elle est utilisée, elle DOIT être numérique et strictement comprise entre 0 et 1. Dans le cas contraire, la génération automatique des miniatures est désactivée.
Elle est OBLIGATOIRE quand la méthode de génération est ‘ratio‘.

Par défaut elle est égale à 0.2 (soit 20%).

$conf['thumbnail_format'] = 'jpeg';

C’est à la fois le format d’image de la miniature générée et l’extension de son nom.

Il PEUT avoir les valeurs ‘jpeg‘, ‘gif’ ou ‘png‘. Toute autre valeur désactive la génération automatique des miniatures.
Il DOIT être supportée par le serveur. Dans le cas contraire, la génération automatique des miniatures est désactivée.

Par défaut il est égal à jpeg.