# Coppermine Photo Gallery v1.5.x: Documentation et manuel

# Téléchargement des images par FTP / Ajout des images par lot

Le téléchargement par FTP plus l'ajout par lots est la méthode recommandée de téléchargement des fichiers pour les administrateurs de galeries Coppermine. Seul l'administrateur peur utiliser cette méthode pour des raisons de sécurité; les non-administrateurs ne peuvent pas utiliser cette méthode, et doivent en utiliser une autre pour télécharger des fichiers.

## Ce que fait l'ajout par lot

Coppermine est une application gérée par une base de données. Cela signifie que les fichiers téléchargés physiquement se trouvent quelque part sur l'espace web. Cela peut être n’ importe où - les noms de répertoire et de fichiers qui sont téléchargés n'ont pas besoin d'être triés d'une manière particulière. Le tri et le groupement est l'affaire d'une réflexion logique: Coppermine utilise les catégories, des sous-catégories et des albums pour organiser l'affichage des fichiers qui ont été téléchargés. Pour être capable de faire cela, Coppermine stocke les emplacements physiques des fichiers (les chemins qui mènent aux fichiers) dans la base de données, de même que d'autres informations logiques (par exemple dans quel album se trouve le fichier).

Lorsqu'un fichier est téléchargé par un client FTP, Coppermine ne sait pas ou il est, donc vous devrez indiquer au script l'emplacement pour lui permettre de le retenir en utilisant la base de données. C'est là que le processus d'ajouts par lot entre en jeu. Ce que fait le processus d'ajout par lots est: créer des copies de l'image redimensionnées (vignettes et images intermédiaires) du fichier original que vous avez téléchargé et d'ajouter cet enregistrement à la base de donnée (un enregistrement par fichier ajouté) afin de garder une trace de l'endroit sur le serveur ou le fichier se trouve. Cela dit, c'est relativement simple: Coppermine ne déplace pas les fichiers - ils restent là ou vous les avez placés.

C'est la raison pour laquelle vous devrez réfléchir à l'avance de la structure de fichiers et de répertoires pour vos téléchargements FTP. Ils doivent aller dans le répertoire albums, et il est recommandé d'y créer une structure claire de répertoires et de sous répertoires.

Il est recommandé à l'administrateur d'utiliser le FTP pour ajouter plusieurs images/fichiers en une seule fois. Utilisez votre application FTP pour créer des sous-répertoires dans votre_repertoire_coppermine/albums/, ou vos fichiers téléchargés peuvent être sauvegardés. Même si ce n'est pas obligatoire, c'est une bonne idée d'avoir une structure de répertoires dans le répertoire albums qui reprennent ou copie la structure de vos catégories et albums de votre galerie Coppermine.

Important: ne créez pas de dossiers ou ne téléchargez pas dans les répertoires userpics ou edit par ftp: ces répertoires sont utilisés en interne par Coppermine et ne doivent pas être utilisés pour une autre raison !Les noms de dossiers ne doivent pas contenir de points. Nous recommandons aussi de proscrire l'utilisation de tout autre caractère spécial - n'utilisez que les caractères a-z, les chiffres et les `-` (tirets) ou `_` (soulignements) pour remplir les espaces vides. Assurez-vous de télécharger en mode binaire ou auto.

## Comment fonctionne l'ajout par lots

Un fois que vous avez téléchargé vos photos par FTP, cliquez sur le bouton "Chargement FTP" L'ajout par lots se fait en trois étapes:

- Trouvez le répertoire dans lequel vous avez téléchargé vos photos. Sélectionnez ce répertoire en cliquant dessus.
- Sélectionnez les photos que vous voulez placer dans la galerie (en cochant la case correspondante). Les nouvelles images sont automatiquement présélectionnées, celles qui sont déjà dans la base de données de Coppermine ne sont pas sélectionnées. Puis sélectionnez l'album dans lequel vous voulez placer les photos. Cliquez sur "Insérer les images sélectionnées" pour lancer le processus d'ajout par lots.
- CPG affiche alors le résultat de l'ajout par lots (cela demande un peu de temps pour afficher les résultats).
  Si les 'signes' OK, DP, ou PB n'apparaissent pas, cliquez sur l'image de fichier brisé pour voir si un message d'erreur a été produit par PHP.
  Si vous deviez rencontrer des times-out, cliquez sur le bouton de rechargement de la page.
  - : Signifie que le fichier a été ajouté avec succès
  - : Signifie que le ficher est dupliqué et existe déjà dans la base de données
  - : Signifie que le fichier n'a pas pu être ajouté, vérifiez votre configuration et les droits des répertoires ou sont placés les fichiers
  - : Signifie que vous n'avez pas sélectionné d'album de destination pour le fichier, cliquez sur 'retour' et sélectionnez un album. Si vous n'avez pas encore d'albums, créez en un d'abord
  - : Le fichier est corrompu ou inaccessible
  - : Type de fichier inconnu
  - : Le fichier est un GIF et à juste été renommé (ex. en JPG ou PNG)

Donner un accès FTP à d'autres utilisateurs peut poser de gros problèmes de sécurité, c'est pourquoi le processus d'ajout par lots n'est disponible que pour les administrateurs de votre galerie Coppermine.

Une fois que les fichiers ont été ajoutés dans votre base de données Coppermine, assurez-vous de ne jamais les renommer ou les effacer par le FTP - utilisez plutôt les options du menu administrateur de Coppermine pour effacer ou renommer les fichiers. C'est la seule manière d'effacer les fichiers à la fois du système de fichiers et de la base de données.

## Erreurs classiques

Il y a plusieurs choses qui peuvent mal se passer lors de l'ajout pas lots, voici une liste de choses à vérifier d'abord:

- ### L'ajout par lots ne fonctionne pas comme prévu:

  - #### Droits

    Assurez-vous que vous avez appliqué les droits au niveau du sytème des fichiers

  - #### Changez d'interface

    L'ajout par lots peut avoir deux interfaces; la classique et l'interface d'exploration. Si vous avez des problèmes avec l'une, essayez l'autre

  - #### Majuscules

    Enlevez les majuscules des noms de fichiers et de répertoires: Coppermine peut fonctionner avec les majuscules, mais il peut y avoir certaines petites choses qui ne fonctionnent pas avec les majuscules. C'est la raison pour laquelle vous ne devez pas utiliser de majuscules c.à.d. que tous vos noms de dossiers ou de fichiers doivent être en minuscules

  - #### Espaces

    Enlevez les espaces dans les noms de fichiers et de dossiers. Les espaces ne font pas partie de la liste des caractères normaux, ne les utilisez pas !

  - #### Caractères spéciaux

    Les systèmes de fichiers utilisés en informatique ont étés crées en ne tenant compte que des caractères latins. Internet et les règles de nommages qu'il utilise ont été crées en n'utilisant que les caractères latins. Beaucoup plus tard, les développeurs se sont rendus compte de leur erreur et ont essayé d'autoriser d'autre caractères, mais c'était trop tard: la technologie et les standards utilisés sur le web sont très anciens, et ne fonctionnent correctement que si vous utilisez uniquement les caractères latins (a à z) et les chiffres. Les caractères spéciaux (comme les caractères accentués, les trémas ou les caractères provenant d'alphabets non latins) ne font pas partie des caractères normaux d'internet. Ne les utilisez pas !

  - #### Caractères interdits

    Il y a une option de configuration qui vous permet de compléter une liste de caractères interdits dans les noms de fichiers. Il est recommandé de ne pas la modifier (ou en tout cas de ne pas effacer ceux qui s'y trouvent par défaut), parce que ces caractères ont une signification spéciale. Bien entendu vous ne devez pas utiliser de caractères interdits dans vos noms de fichiers ou de dossiers.

  - #### Noms réservés

    N'utilisez pas de noms réservés: il y a un certain nombre de préfixes utilisés en interne par Coppermine, vous devez vous assurez de ne pas utiliser ces noms de fichiers ou préfixes réservés. N'utilisez pas "thumb_", "normal_", "original_" dans les noms de fichiers, ce sont ceux par défaut pour les fichiers de Coppermine

  - #### Les points

    N'utilisez pas les points dans les noms de dossiers: les fichiers commençant par un point sont des fichiers cachés sur la plupart des systèmes d’exploitation des serveurs d'hébergement, c'est la raison pour laquelle l'utilisation des points peut s'avérer problématique. N'utilisez pas de points pour le début des noms des fichiers - en fait, les noms de fichiers ne doivent contenir qu'un seul point: celui qui sépare le nom du fichier de son extension.

  #### Demander de l'aide pour des problèmes d'ajout par lots

  Si vous avez des problèmes avec l'ajout par lots, assurez-vous d'abord que le téléchargement par HTTP fonctionne correctement. Si vous voulez demander de l'aide pour des problèmes d'ajout par lots sur le forum d'aide de Coppermine, référez-vous au guide "Demande d'aide pour les problèmes de téléchargement" - il s'applique aux problèmes d'ajouts par lots aussi bien qu'aux autres méthodes de téléchargement. En plus des suggestions faites sur cette page, ajoutez à votre post un lien direct vers un des fichiers avec lequel vous avez des problèmes d'ajout par lots.

- ### Les fichiers semblent corrompus:

  Assurez-vous de les avoir téléchargé en utilisant le bon mode FTP

- ### Ne les renommez pas

  Ne renommez pas les fichiers une fois qu'ils ont été ajoutés dans la base de données de Coppermine. Bien entendu vous ne devez pas non plus renommer le dossier contenant les fichiers !

- ### Ne les effacez pas

  N'effacez pas de fichiers en utilisant votre client FTP après les avoir ajoutés à Coppermine. Si vous voulez effacer des fichiers, utilisez l'interface utilisateur de Coppermine pour le faire.
  Certains utilisateurs pensent à tord qu'ils peuvent effacer les fichiers originaux une fois l'ajout par lot effectué: ce n'est pas le cas - tout ce que fait le processus d'ajout par lots est la création d'images redimensionnées (intermédiaires, vignettes, filigrane) et d'ajouter un enregistrement dans la base de données correspondant à votre fichier. Vous ne pouvez pas effacer le fichier pas effacer le fichier pour gagner de la place. Si vous effacez le fichier, vous aurez un enregistrement corrompu, ce qui n'est pas bien du tout.

## tri

L'ordre de tri par défaut des fichiers peut être paramétré dans la configuration de Coppermine. Par défaut, il est paramétré à "Ascendant par nom", ce qui est simplement la meilleure option pour la plupart et doit être préservée pour cela. En conséquence, tous les fichiers qui sont utilisés par Coppermine avec la fonction d'ajout par lots sont triés dans leur album de destination par nom de fichier. Il est recommandé d'avoir un schéma de nom de fichiers (que vous devez appliquer aux fichiers avant de les télécharger sur votre serveur) qui prend en compte la manière dont le serveur va trier ces fichiers.

Gardez en mémoire que:

- ### Les majuscules comptent

  Sur la plupart des serveurs il y a un système d'exploitation Unix-/Linux. A l'inverse des systèmes d'exploitation Windows, les majuscules comptent en matière de tri. C'est la raison pour laquelle les fichiers peuvent être triés de manière "bizarre" si vous venez du monde Windows.

- ### Les ordinateurs voient les nombres différemment

  Les ordinateurs (et les serveurs sur lesquelles tournent votre galerie) perçoivent une liste de nombre d'une autre manière que les hommes: le zéro de commencement peut être oublié par l'homme, mais pas par l'ordinateur. Admettons que vous ayez une liste de 12 fichiers simplement nommés en utilisant un nombre comme ceci:
  `1.jpg`, `2.jpg`, `3.jpg`, `4.jpg`, `5.jpg`, `6.jpg`, `7.jpg`, `8.jpg`, `9.jpg`, `10.jpg`, `11.jpg`, `12.jpg`
  Un homme les triera de cette manière:
  - 1.jpg
  - 2.jpg
  - 3.jpg
  - 4.jpg
  - 5.jpg
  - 6.jpg
  - 7.jpg
  - 8.jpg
  - 9.jpg
  - 10.jpg
  - 11.jpg
  - 12.jpg
  , mais pas l'ordinateur: votre serveur web les triera comme ça:
  - 1.jpg
  - 10.jpg
  - 11.jpg
  - 12.jpg
  - 2.jpg
  - 3.jpg
  - 4.jpg
  - 5.jpg
  - 6.jpg
  - 7.jpg
  - 8.jpg
  - 9.jpg
  C'est pourquoi il est conseillé de mettre dans les noms de fichiers des zéro en première place. Pour cela, vous devrez estimer le nombre maximum de fichiers qui vont aller dans ce dossier. Ce maximum détermine le nombre de chiffre nécessaire au nom de fichier: si le nombre maximum est de 99 fichiers dans un dossier, vous pouvez utiliser 01 à 99. Si le nombre maximum de fichiers est 200, vous devrez avoir 3 chiffres, votre premier fichier devra alors s'appeler 001.jpg, le second 002.jpg etc... Bien entendu les noms de fichiers peuvent être alphanumériques, vous pouvez donc avoir une combinaison de chiffres et de lettres comme par exemple
  - brussels001.jpg
  - brussels002.jpg
  - brussels003.jpg
  - brussels004.jpg
  - brussels005.jpg
  - brussels006.jpg
  - brussels007.jpg
  - brussels008.jpg
  - brussels009.jpg
  - brussels010.jpg
  - brussels011.jpg
  - brussels012.jpg