Le minimum à comprendre après l’installation de PhpWebGallery.

Par défaut et pour débuter, à chaque fois que vous voulez proposer une nouvelle série d’images ou autres éléments, vous créerez un sous-répertoire de ./galleries/ et vous y déposerez vos éléments (en taille adaptée au web). Vous aurez optionnellement besoin de miniatures à placer dans un sous-répertoire de celui créé à l’instant. Puis à partir de l’administration en ligne, vous devrez synchroniser la base de données afin de lui faire connaître vos nouveaux éléments.
Au minimum: lire nos conseils.

Lire également: Vos images sur le web

Les éléments à présenter sur le site seront stockés physiquement dans un sous-répertoire du répertoire ./galleries/ de l’installation. Avec un peu plus d’expérience, vous découvrirez que les éléments peuvent être éventuellement stockés dans un sous-répertoire de l’url d’un site distant (Cf. Les sites distants). Pour ce document, afin d’en simplifier la lecture, nous en resterons à un sous-répertoire de ./galleries/.

A chaque sous-répertoire physique va correspondre ce que nous appellerons une catégorie physique. Ce sous-répertoire aura lui-même 3 sous-répertoires techniques plus ou moins facultatifs suivant la nature des fichiers:

• thumbnail
• pwg_representative
• pwg_high

L’organisation de tout répertoire n’a pas de réelle importance. Cependant il conviendra de ne jamais la modifier sans savoir ce que vous aller faire car les conséquences pour le site seraient pour le moins regrettables.

Vous allez commencer par mettre quelques images de taille raisonnable en ligne. Une tache qui va devenir répétitive sans aucun doute. Il sera important de disposer d’une méthode pour accélérer le processus.

Nous allons faire sans elle pour commencer. Ultérieurement pour vous décider sur une des méthodes actuellement disponibles, alors vous regarderez en premier la Méthodologie par défaut, et une fois que tout vous semblera plus clair votre choix sera bien plus simple pour Préparer les photos avant la synchronisation.

Prenons une photo simple et pas trop grande pour commencer.

• Via votre client FTP, transférez cette image ou une autre de taille raisonnable
  

dans le répertoire ./galeries/essai/ sous le nom Hybiscus.jpg par exemple.

C’est fait ? Bien ! Allez dans la partie administration de votre galerie.

Découvrons le menu, de haut en bas, et sous Catégories vous allez trouver « Synchroniser ». La page de la synchronisation sera réorganisée sans doute un jour mais pour l’instant ce n’est pas fait. Ne vous pressez pas et comprenez bien les principes.

Vous avez un paragraphe synchroniser la structure des fichiers avec la base de données.
Vous allez cocher répertoires uniquement et afficher un maximum d’informations (catégories ajoutées, éléments ajoutés, catégories et éléments supprimés).

• Validez ! ⇒ Vous n’avez rien fait du tout du coté de la base de données.

• Enlevez la coche de Simuler uniquement (aucun changement dans la base de données ne sera effectué)
• Validez ! ⇒ Vous venez de créer une catégorie physique pour l’instant elle est vide.

Retour au Menu: « Synchroniser ».
Au paragraphe synchroniser la structure des fichiers avec la base de données.
Cochez répertoires + fichiers cette fois, et afficher un maximum d’informations (catégories ajoutées, éléments ajoutés, catégories et éléments supprimés).
Au paragraphe traiter uniquement une catégorie sélectionner la catégorie créée précédemment (en principe nommée “essai”).

• Validez ! ⇒ Vous n’avez rien fait du tout du coté de la base de données.
  

Cependant vous avez une Liste des erreurs laquelle vous indique:

[../.....jpg] PWG-UPDATE-2 (miniature manquante)

Nous allons résoudre le problème en ligne cependant il faut éviter cette pratique (Inconvénients).

Retournons au Menu, mais cette fois dans la partie « Images ». Là, vous allez trouver « Miniatures »
Nous allons tenter de créer la miniature sur le serveur mais deux raisons au moins peuvent empêcher le processus. (Motifs possibles)

• Sur cet écran, tout simplement: Validez !

Si cela fonctionne, vous aurez:

Bravo! Notez le message en bas d’écran : [ Aucune miniature ne manque ]

Rappel: nous ne conseillons pas de généraliser cet usage.

Menu: « Synchroniser ».
Au paragraphe synchroniser la structure des fichiers avec la base de données.
Cochez répertoires + fichiers cette fois, et afficher un maximum d’informations (catégories ajoutées, éléments ajoutés, catégories et éléments supprimés).
Au paragraphe traiter uniquement une catégorie sélectionner la catégorie créée précédemment (en principe nommée “essai”).
Enlevez la coche de Simuler uniquement (aucun changement dans la base de données ne sera effectué)

• Validez ! ⇒ Vous venez d’ajouter l’élement dans la catégorie mais ce n’est pas fini pour autant.

Menu: « Synchroniser ».
Au paragraphe synchroniser les informations des éléments dans la base de données à partir des méta-données ... cochez uniquement les éléments jamais synchronisés
Au paragraphe traiter uniquement une catégorie sélectionner la catégorie créée précédemment (en principe nommée “essai”).

• Validez ! ⇒ Vous n’avez rien fait du tout du coté de la base de données.
• Enlevez la coche de Simuler uniquement (aucun changement dans la base de données ne sera effectué)
• Validez ! ⇒ Vous venez compléter la description de(s) image(s) récemment ajoutée(s).

Notez que tout ceci va progressivement se simplifier, exemple: Miniatures en ligne et pour en savoir plus, lire Préparer les photos avant la synchronisation.

La catégorie “essai” est pour l’instant publique.

1. Regardez votre galerie
2. Cliquez sur l’icone
3. Cherchez « Associer tous les éléments de la catégorie à une nouvelle catégorie »
4. Saisir un « Nom de la catégorie virtuelle », par exemple « Le potentiel de l’être » et validez.
5. Toujours sur cet écran, choisissez dans « Options » ⇒ Type d’accès ⇒ privé
6. Validez une seconde fois.
7. Regardez votre galerie

A quoi cela va vous servir? A vous organiser, et vous réorganiser indépendamment des répertoires existants, et cela aussi souvent que vous le voudrez, sans la moindre inquiétude de perdre un commentaire, une description d’une image (Cf. Les catégories virtuelles ou encore Les catégories virtuelles ).

• pwg_high : Usage facultatif mettre des images en résolution supérieure (Affichage ou télchargement). Dès lors une image peut exister sous le même nom dans son format d’origine par exemple et elle sera accessible aux utilisateurs autorisés.
• pwg_representative: Usage facultatif pour les éléments non image. exemple: un fichier zip, mais comme le fichier zip n’est pas une image c’est l’image jpg du même nom qui sera affichée dans la galerie, le zip sera téléchargeable par la disquette.
• thumbnail: Une vidéo n’a pas de miniature en standard, placez une miniature du même nom que la vidéo en respectant les règles, et celle-ci s’affichera dans la catégorie.

• Regardez par FTP le résultat de l’essai et suivez cet exemple.
• Ne jamais décocher Rechercher dans les sous-catégories.
• Par défaut les miniatures sont préfixées par TN- (format .jpg ou .png).
• Garder des noms simples, il y a des restrictions (dues au web, cf. ci-dessous).
• Règles de typographie, Noms des répertoires et images, c’est à dire:
  • pas d’espace et pas d’accents
  • donc uniquement des lettres, des chiffres, des -, des _, ou encore des ....
• Préparer vos éléments avant de les placer sur le serveur.

Appréciez par vous-même, c'est à vous de jouer.

Si vous tenez à générer vos miniatures sur une serveur web, vous devez mesurer les éventuelles conséquences d’une génération de miniatures en ligne.
Ci-dessous un exemple bien réel, extrait d’un courrier reçu:

Nous vous notifions que votre (vos) site(s) internet hébergé(s) sous le numéro de
contrat ******* consomment des ressources très importantes.

Pour cette raison, nous avons été dans l’obligation de déplacer votre compte sur des serveurs auxiliaires.
Nous vous recommandons pour une telle utilisation l’acquisition d’un serveur dédié ...

1. Peut-être que la configuration du serveur l’interdit (GD Support à faire activer dans php).
2. Les droits sur le répertoire peuvent être insuffisants (chmod insuffisant, Google est votre ami).
3. L’image de la première miniature à générer est peut-être corrompue (renommer l’image avec un “Z” en premier caractère pour voir).

Les images que vous présentez vont être accessibles par une adresse (URL)...

Par exemple, au niveau des catégories:

http://demo.phpwebgallery.net/index.php?/category/25
ou
http://demo.phpwebgallery.net/index.php?/category/America

Au lieu de category/25 vous observerez category/America. En d’autres termes, vous pouvez définir (via l’Admin) un « Permalink » (lien permanent) pour une catégorie.

Au travers de la galerie, il n’existe pas de liens permanents au niveau des images. Cependant vous pouvez changer le style de vos URLs.
http://demo.phpwebgallery.net/picture.php?/193/category/America.

Cela passe par des variables de configuration (variables $conf). Ces variables peuvent être modifiées depuis n’importe quel php de la galerie (à vos risques et périls). En réalité, nous avons prévu un emplacement pour changer ces variables. Cela doit être réalisé dans le config_local.inc.php. En aucune façon cela ne devra être fait dans le fichier config_default.inc.php.

Pour éviter toute erreur, vous utiliserez LocalFiles Editor, un plugin disponible dans les extensions.

Par défaut, vous avez:

$conf['picture_url_style'] = 'id';

Les commentaires expliquent en Anglais:

// picture_url_style : one of 'id' (default), 'id-file' or 'file'. 'id-file'
// or 'file' mean that the file name (without extension will appear in the
// url). Note that one additionnal sql query will occur if 'file' is choosen.
// Note that you might experience navigation issues if you choose 'file'
// and your file names are not unique
$conf['picture_url_style'] = 'id';

Donc si vous ne changez rien ou si vous codez ‘id’ vous aurez:

http://demo.phpwebgallery.net/picture.php?/193/category/America
ou
http://demo.phpwebgallery.net/picture.php?/193/category/25

Vous pouvez à tout moment abandonner la valeur par défaut, mais une fois que vos URLs seront modifiées et que votre site sera largement référencé, vous ne devrez plus changer les paramètres détaillés ci-dessous au risque d’avoir un très mauvais référencement de vos pages.

En codant ‘id-file’ vous aurez:

http://demo.phpwebgallery.net/picture.php?/193-DSC_3793/category/America

Avec ‘file’ vous obtiendrez:

http://demo.phpwebgallery.net/picture.php?/DSC_3793/category/America

Le commentaire en Anglais explique que si vous avez des noms de fichiers identiques dans différentes catégories vous pourriez avoir quelques problèmes de navigation. C’est pour cette raison que via les écrans d’Administration, vous trouverez parmi les Fonctions avancées, l’option:

• Fichiers portant le même nom dans plusieurs catégories physiques

En exécutant cette fonction, si vous trouvez des images alors notre conseil sera d’oublier

$conf['picture_url_style'] = 'file';

Fonctionnalités - Gestion des Elements