Coppermine Photo Gallery v1.5.x: Documentation et Manuel

Table des Matières

Téléchargement d'images/de fichiers

Coppermine est une galerie web, donc un des aspects clé de son utilisation est la possibilité pour l'administrateur(ou les utilisateurs si l'administrateur les autorise à télécharger) de télécharges des images (ou plus généralement des fichiers) dans cette galerie - sans fichiers téléchargés, une galerie n'a pas de sens. Ce qui se passe lors du téléchargement, est que l'image téléchargée est redimensionnée et une vignette est crée. En plus de l'image qui est stockée sur le serveur web, un enregistrement est créer dans la base de donnée pour chaque fichier téléchargé. Tout ceci se passe "en arrière plan" - Coppermine prend soin de celà, vous n'avez donc pas à savoir exactement ce qui se passe. Néanmoins, la possibilité de télécharger est limitée par un certain nombre de facteurs que Coppermine n'a pas le pouvoir de changer. C'est à ce moment que cette partie de la documentation entre en jeu: si certaines choses vont de travers ou ne se passent pas comme prévu, vous devriez lire cette documentation pour être en mesure de corriger les choses qui ne fonctionnent pas comme prévu. Donc, s'il vous plait, lisez la documentation - surtout si vous avez des problèmes avec le téléchargement.

Il y a différentes methodes de téléchargement de fichiers dans Coppermine. Vous (en tant qu'administrateur) devriez utiliser le téléchargement par FTP plus l'ajout par lot (seul l'administrateur peut le faire). Les utilisateurs normaux sont supposés utiliser le methode "normale" de téléchargement HTTP ou (si ils ont Windows XP) l'assistant XP Publisher.

Un client de téléchargement pour Linux utilisant le bureau KDE est disponible aussi: Aditya Mooley, un des développeurs de Coppermine, à créer "Koppermine" qui est recommandé pour les utilisateurs de Linux.

Si vous avez des problèmes avec le téléchargement, lisez très attentivement la section de Dépannage des téléchargements.

Sous-sections de la documentation sur le téléchargement

Il y a différents sous-sections qui expliquent les détails à propos du téléchargement:

Comment Coppermine stocke les fichiers

Comme expliqué plus haut, il ya plusieurs manière que vous puvez utiliser pour télécharger des fichiers dans Coppermine: en fonction de la méthode que vous utilisez, les fichiers sont stockés de différentes manières. Pour les utilisateurs normaux de votre galerie, ce n'est pas important du tout, puisque Coppermine (ou plutôt la base de donnée utilisée par Coppermine) garde une trace de l'endroit pu est placé le fichier - l'homme n'a pas besoin de le faire. Ceci dit: si vous n'avez pas d'intérets à la structure des répertoires et des fichiers sur votre serveur, vous pouvez ignorer cette section de la documentation.

Le répertoire albums

Au départ, Coppermine stocke tous les fichiers téléchargés dans un répertoire nommé albums qui se trouve à la racine de votre répertoire Coppermine. Ce nom de répertoire est un peu trompeusen et existe pour des raisons historiques (pour une compatibilité descendante avec des anciennes versions de Coppermine). Il est important de comprendre que ce nom de répertoire ne doit pas être confondu avec la structure logique des albums; les fichiers téléchargés peuvent être ordonnés en reprennant la strcuture logique des catégories et des albums, mais ce n'est pas nécessaire. Vous pouvez changer le nom et l'emplacement du répertoire dans lequel vos téléchargements irons de albums à ce que vous voulez en utilisant l'option de configuration "Répertoire albums", mais si vous ne savez pas réellement ce que vou sfaites, il est recommandé de laisser la valeur par défaut. Faites attention aux messages d'alerte lorsque vous changez cette option.

Les téléchargements HTTP vont dans le répertoire userpics

En utilisant le téléchargement HTTP (la méthode de téléchargement "normale" qui est utilisées lorsque vous utilisez le lien "Téléchargement" du menu Coppermine), tous les fichiers téléchargés seront placés dans un sous-dossier du répertoire userpics. Le répertoire userpics est lui même un sous-répertoire du répertoire albums.
Le nom du répertoire userpics peut lui aussi être changé (réferez vous à l'option de configuration "Répertoire pour les ficheirs utilisateurs"), mais là aussi prêtez attention aux messages d'alerte pour cette option de configuration! Le nom du fichier ou les fichiers téléchargés seront placés est calculé sur la base de l'ID de l'utilisateur qui télécharge le fichier initialement (10,000 plus l'ID de l'utilisateur). Cela donne une structure comme ceci: http://exemple.com/votre_repertoire_coppermine/albums/userpics/10001/un fichier.jpg, ou le sous-répertoire 10001 est relatif à l'utilisateur qu a l'ID "1". Si vous avez plus de 10,000 utilisateurs, le compte continue (comme le nom de répertoire est l'ID de l'utilisateur plus 10,000), donc, l'utilisateur qui a pour ID 10000 aura le sous-répertoire 20000 du répertoire userpics.

La seule exeption à cette règle est l'utilisation du safe_mode: si votre serveur tourne en safe_mode et que vous avez activé l'option silly safe_mode dans la configuration, le script PHP n epeut généralement pas créer de osus-répertoires. C'est pourquoi, dans ce cas, tous les téléchargements de tous les utilisateurs iront directement dans le répertoire userpicsn sans sous-répertoire créer pour chaque utilisateur.

Le répertoire temporaire edit

Dans le répertoire albums, vous trouverez un sous-répertoire nommé "edit" - c'est l'unique dossier temporaire utilisé par Coppermine. Il est utilisé pour des raisons internes uniquement: si vous utilisez le téléchargement par HTTP et que l'utilisateur a déjà téléchargé plusieurs fichiers, ils vont d'abbord dans ce répertoire. L'utilisateu doit alors assigner les fichiers téléchargés à des albums, ensuite les fichiers téléchargés sont déplacés du répertoire temporaire vers le sous-répertoire du répertoire userpics. Si il n'assigne pas d'albums (ou si quelque chose ne se passe pas correctement), le répertoire temporaire garde le fichier dans le répertoire edit, ou l'utilitaire de corbeille ira de temps en temps pour effacer les fichiers temporaires anciens. C'est un mecanisme nécessaire, parceque le mecanisme de téléchargement par HTTP peut devenir difficile à gérer, vu du côté du programmeur: toutes sortes de choses bizarres qui peuvent arriver (les fichiers peuvent devenir trop grands, il peut ne pas avoir assez d'espace web, le répertoire cible n'a pas les droits d'écriture nécessaire au script). L'utilisation du fichier temporaire pour le téléchargement par HTTP permets simplement de rendre le mecanisme de téléchargement HTTP de Coppermine plus fiable, ce qui est la raison de sa création. Ne touchez pas au répertoire edit manuellement: ne le renommez pas, ne l'effacez pas, ne téléchargez pas de fichiers à l'intérieur - laissez le juste tel quel et laissez Coppermine l'utiliser comme c'est prévu.

Téléchargement par FTP

Le téléchargement par FTP est un animal totalement différent: du fait que le téléchargement initial n'est pas réalisé par Coppermine, mais par l'utilisateur administrateur lui même (utilisant un client FTP), c'est son travail de vérifier que les fichiers qu'il essaye de télécharger sont bien là ou il le veut. Ce que fait l'ajout par lots est d'ajouter les fichiers physiquement présents là ou vous le voulez dans la base de donnée. Pour vous assurer que vous compreniez bien ce concept: la base de donnée elle même ne contient pas de fichiers - pensez y uniquement comme une structure logique, qui garde une trace de l'emplacement physique des fichiers ainsi que certains autres paramètres (comme les dimensions, l'album dans lequel le fichier est placé etc...). Voyez la base de donnée comme un annuaire qui ne contient pas les gens qu'il liste ni leut téléphoes: ce en quoi consiste un annuaire téléphonique est uniquement un enregistrement qui pointe vers quelque chose de réel (le nom d'une personne & une adresse & un numéro de téléphone).

Ceci dit, vos téléchargements par FTP doivent aller dans une strcuture de répertoire dans le répertoire albums. Ils ne doivent pas être placés dans le répertoire userpics, mais dans une strcture de répertoire propre. Ces répertoires que vous aurez créer avec votre client FTP ne sont pas des réeprtoires temporaires, mais sont permanents: Coppermine ne dépacent pas de fichiers, mais restent là ou vous les uarez téléchargés par FTP en premier lieu.

Téléchargement par XP Publisher

En utilisant XP Publisher pour télécharger, c'est une autre structure de stockage qui est utilisée: les fichiers vont dans des sous-répertoires du répertoire albums qui sont nommés wpw-yyyymmdd, ou "wpw" représente "Windows Publishing Wizard" et "yyyy" l'année, "mm" pour le mois et "dd" pour le jour du téléchargement. La aussi, Coppermine ne déplace pas les fichiers, ils restent là ou ils sont.