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

# Fichiers

Avec Coppermine, les fichiers téléchargés sont placés dans des albums. Les albums peuvent contenir des fichiers, mais pas de sous-albums. Les albums peuvent aller dans d'autres catégories. Les catégories peuvent contenir des sous-catégories et des albums, mais elles ne peuvent pas contenir de fichiers.

Coppermine (dans la version 1.0) a été conçu en premier lieu pour afficher des images. Plus tard dans le processus de développement sont venu des fichiers multimédia (fichiers audio et vidéo ainsi que des documents), c'est pourquoi le terme "images" a été abandonné au profit de "fichiers". Dans certains endroits (par exemple dans les noms des tables ou dans certains endroits de la documentation), le terme "image" peut apparaitre à la place de "fichiers".

Vous pourriez être tenté de croire que Coppermine est en fait un éditeur de fichier, car il a la capacité de modifier (redimensionner) et créer des images. Toutefois, ce n'est le cas que dans une mesure limitée: Coppermine n'est pas un éditeur d'image et ne peut être utilisé comme remplacement d'une telle application de bureautique. C'est plutôt une galerie web qui fonctionne bien pour afficher vos fichiers sur internet.

## Editer les fichiers

Utilisez ce lien pour modifier le titre de votre fichier, la description, les mots clés et des champs personnalisés (s'ils sont utilisés).

Utilisez le menu déroulant en face d’album dans la page afin de déplacer le fichier entre les albums. Utilisez des mots clefs pour lier des fichiers à d'autres albums (voir description dans la section albums ci-dessus).

## Editer les videos

Ici, vous pouvez modifier le titre, la description, les mots-clés et les champs personnalisés (s'ils sont utilisés) de vos fichiers vidéo.

Utilisez le menu déroulant en face d’album dans la page afin de déplacer la vidéo entre les albums.

Utilisez les champs de hauteur et de largeur pour définir la taille de la vidéo.

La possibilité de mettre des vidéos existe depuis cpg1.3.0 (et plus) et est inclue par défaut dans le pack de la distribution.

## Vignettes personnalisées

### Ordre des vignettes

Les vignettes sont définis par différents niveaux (il s'agit de: définie par l'utilisateur, de thème ou globalement) puis dans l'ordre de leur type (fichiers spécifiques, l'extension spécifique, spécifique aux médias).

Les vignettes définies par l'utilisateur sont stockés dans le dossier où le fichier parent est situé. Les vignettes thématiques définies sont stockés dans les thèmes à l’intérieur du dossier "images". Vignette global stock dans le dossier "images" de la racine de Coppermine.

Les vignettes peuvent être d'un des types de fichiers suivants: 'gif', 'png', ou 'jpg'.

### Types de vignettes

Une vignette spécifique à un fichier doit avoir le même nom que le fichier.

Utilisation de la capture d'écran ci-dessus d'un fichier vidéo à titre d'exemple, l'image de ce fichier peut être "thumb_Fleuron1.gif", "thumb_Fleuron1.png" ou "thumb_Fleuron1.jpg" et recherchées par CPG dans cet ordre.

L’extension des vignettes spécifiques sont nommées d'après l'extension du fichier. (Exemples: 'thumb_wmv.jpg', 'thumb_wav.jpg'.)

Le nom de base pour les vignettes spécifiques aux médias est 'thumb_movie', 'thumb_document', et 'thumb_audio'. Pour les fichiers de type images, c'est la vignette spécifique à chaque fichier qui est utilisée par défaut.

### Transfert de vignette personnalisée

Il y a 2 façons de télécharger des vignettes personnalisées:

- Avoir une image déjà téléchargé puis télécharger une vidéo via la page de téléchargement. (Ou vice versa) La vidéo se partagera la vignette avec l'image.
- Télécharger par FTP la vidéo et (vignette ou l'image), puis ajoutez par lot. Si vous avez téléchargé par FTP la vignette, elle sera affichée dans le lot, puis ajouter sur dans la page au lieu de la vignette par défaut de Coppermine. Si vous téléchargez une image, elle ressemblera à la capture d'écran ci-dessus. Toutefois, lorsque les fichiers sont ajoutés à la base de données, la vignette de l'image sera utilisée par la vidéo.

Note: Si la première méthode est utilisée et l'image supprimé plus tard, la vignette sera également supprimé et la vignette du type de fichier par défaut de Coppermine s’affichera à la place

Si une vidéo déjà envoyée doit être transféré à nouveau, via FTP, la vignette d'accompagnement doit également être transférée, via FTP, dans le même dossier.

En suivant les instructions ci-dessus, une vignette personnalisée peut être appliquée à tous les fichiers, pas seulement aux vidéos.

### Comment ça marche ?

Comme indiqué plus haut, il existe différents types de vignettes. La plupart des utilisateurs ne se soucient pas de la vignette générique qui représente un type de fichier particulier (comme les films avec l'extension. `.mov`) - ils ne veulent pas voir cette vignette générique du tout, mais juste un bel aperçu qui représente bien le contenu du fichier téléchargé. Pour comprendre comment cela fonctionne, il vous suffit de jeter un œil à la façon de fonctionner de Coppermine: les fichiers téléchargés sont placés dans des dossiers particuliers. Coppermine "regarde" dans le dossier où votre fichier est stocké pour voir s'il y a une vignette qui "s'adapte" au fichier, en respectant le schéma de nommage. S’il en trouve une, il l'utilisera. Si ce n'est pas le cas, il utilisera la vignette générique qui a été conçu pour représenter le type de média.

### Schéma de nommage

Le schéma est assez simple: vous pouvez spécifier un préfixe pour les vignettes dans la configuration de Coppermine. Ce préfixe est `thumbs_`, par défaut et c'est très bien - ne modifiez pas ce paramètre à moins de ne savoir vraiment ce que vous faites. Pour l'instant, supposons que vous ne l'avez pas changé, c'est le préfixe par défaut `thumbs_`.

Maintenant, supposons que vous essayez de créer une vignette personnalisée pour le fichier `mavideo.avi` qui se trouve dans le dossier `/albums/userpics/10235/`. Par la suite, Coppermine se penchera sur ce dossier et regardera s'il y a un fichier nommé `thumb_mavideo.jpg`. Si ce fichier existe, il sera utilisé comme une vignette pour représenter la vidéo. S’il n'existe pas, Coppermine utilisera le générique.

Par conséquent, le schéma est le préfixe de la vignette plus le nom du fichier de la vidéo (sans l'extension), ainsi que d'un point (pour séparer le nom réel du fichier de l'extension) plus l'extension `jpg`.

Importance des Majuscules: de nombreux utilisateurs ne savent pas qu'il y a une différence sur un ordinateur fonctionnant sous Unix / Linux entre les lettres minuscules et majuscules, tout simplement parce que sous Windows, il n'y a pas de différence. Il faut garder à l'esprit cet aspect: car la plupart des serveurs web sont sous Unix / Linux, d'ou l'importance des Majuscules ! C'est pourquoi `thumb_mavideo.jpg` et `thumb_maVideo.JPG` sont deux choses totalement différentes qu'importe la façon dont vous nommez votre vignette personnalisée. Si le fichier que vous essayez de représenter avec une vignette personnalisée est nommé `maVideo.avi`, la vignette personnalisée doit être nommé `thumb_maVideo.jpg` ! D'autres variantes avec une capitale différents (comme `thumb_maVideo.JPG`, `thumb_mavideo.jpg`, `Thumb_maVideo.jpg`, `thumb_maVideo.Jpg` ou similaire) ne fonctionneront pas comme prévu !

### Pourquoi Coppermine ne créer pas de vignette pour mes vidéos ?

Toute cette affaire d’aperçu personnalisé peut paraître très compliquée aux débutants, et en fait vous avez raison: c'est un processus compliqué. Par conséquent, de nombreux utilisateurs se demandent pourquoi cela doit être si compliqué. Coppermine peut créer des vignettes pour les images, alors pourquoi ne pas créer des vignettes pour les vidéos ? La raison est assez simple: parce que les bibliothèques graphiques qu’utilise Coppermine (GD ou ImageMagick, voir "minimum requis") pour créer des vignettes à partir d'images ne supportent pas les vidéos. Ce n'est pas que les développeurs Coppermine ont été réticents à proposer un code qui crée automatiquement les vignettes pour les vidéos - c'est juste qu'ils ne peuvent pas parce que la technologie qui est disponible sur votre serveur web ne le peut pas.

### Instructions étape par étape

Voici un tutoriel étape par étape pour vous permettre de continuer:

- Créer la vignette personnalisée sur votre ordinateur
  1. Prendre une capture d'écran du film à l'aide de votre application favorite qui est capable d'accomplir cela, utiliser une image qui représente le contenu de votre vidéo ou par exemple un gribouillage fait avec MS Paint: vous devez créer la vignette personnalisée d'abord sur votre ordinateur. Nous ne pouvons vraiment pas vous aider avec ça, car il y a tellement d’applications différentes disponibles.
  Veillez à ce que votre vignette personnalisée obtenue ait les mêmes dimensions que les autres vignettes (selon les dimensions que vous avez définis à l’intérieur des Paramètres des vignettes dans la configuration de Coppermine).
  Une fois que vous en avez fini avec cela, vous devez avoir une vignette (en .jpg) sur votre ordinateur qui a les dimensions appropriées. Ne pas la télécharger pour l'instant - Faisons d'abord les premiers contrôles.
- Trouvez l'emplacement exact ainsi que le nom de la vidéo pour laquelle vous essayez de créer une vignette personnalisée
  Maintenant, c'est peut être la partie la plus délicate pour les débutants: supposons que la vidéo ait déjà été transférée dans Coppermine. Si c'est vous qui avez téléchargé le film à l'aide du FTP en faisant un ajout par lot, vous devez connaitre le dossier exact et le nom du fichier, mais pour cet exemple nous supposons que l'un de vos utilisateurs a utilisé le téléchargement HTTP pour télécharger la vidéo, si vous n'avez aucune idée où le fichier est réellement allé.
  Pas de panique, démarrez votre navigateur, allez sur votre galerie et commencez à la parcourir. Allez à la page qui inclue les vidéos, de manière à voir les vidéos jouées au travers de l'interface de Coppermine. Maintenant, faites un clic droit n'importe ou dans la fenêtre du navigateur, et demandez à voir le code source. Ne faites pas de clic droit sur la vidéo, mais sur un espace vide à côté. La sortie HTML de la page que vous êtes en train de regarder devrait s'afficher. Maintenant cherchez dans cette sortie HTML le terme `class="imageborder"` - cela devrait vous amener juste en face du bloc que nous cherchons, déroulez doucement la page vers le bas (4 ou 5 lignes). Nous cherchons un bloc de code qui ressemble à çà:

      <param name="src" value="albums/userpics/10235/mavideo.avi" />

  La valeur donnée pour ce paramètre (`albums/userpics/10235/mavideo.avi` dans cet exemple) est ce que nous recherchons. Elle indique dans quel dossier le fichier est actuellement placé (`albums/userpics/10235/` dans cet exemple) et le nom du fichier est (`mavideo.avi` dans cet exemple). Mémorisez ces informations (ou laissez la fenêtre avec le code source ouverte, avec la section que nous venons de trouver surlignée) - nous aurons besoin de ces informations dans les deux étapes suivantes.
- Renommez votre vignette personnalisée sur votre ordinateur
  Retour à votre ordinateur, vous devez avoir votre nom personnalisé correspondant à la convention de nommage. Pour l'exemple ci-dessus (et en supposant que vous n'avez pas changé le préfixe des vignettes dans la configuration), vous devez renommer la vignette personnalisée sur votre ordinateur en `thumb_mavideo.jpg`. Gardez à l'esprit les questions de majuscules !
- Envoyer la vignette personnalisée
  Enfin, la vignette personnalisée est prête à être transférée - nous avons juste à faire en sorte que cela parte dans le dossier où votre vidéo originale est placée. Dans l'exemple ci-dessus, le dossier relatif (vu du dossier racine de Coppermine) serait `albums/userpics/10235/`.
  Démarrez votre application FTP préféré (comme Filezilla ou similaire), connectez vous à votre serveur web et téléchargez votre vignette personnalisé de votre ordinateur vers le dossier qui représente l'url `http://votresite.com/votre_dossier_coppermine/albums/userpics/10235/`
- Pour finir
  Si tout fonctionne comme prévu, çà devrait être bon. Assurez-vous en, en commençant par ouvrir votre navigateur une fois de plus, allez à la page de votre galerie et naviguez à l'album qui contient la vidéo pour laquelle nous venons de créer une vignette personnalisée. Vous devriez maintenant voir la vignette personnalisé au lieu de la vignette générique. Si ce n'est pas immédiatement le cas pour vous, assurez-vous qu’il ne s’agit pas d’une image en cache de votre page – Vous feriez mieux de forcer le rafraîchissement de votre navigateur ([Ctrl] + [F5]) quand vous regardez la page des vignettes.
- Les choses que vous ne devriez pas faire
  Si dans le même dossier, une vignette personnalisée correspond à un fichier vidéo selon le schéma de nommage existant, elle sera utilisée. Par conséquent, vous ne devriez pas (et ne devez pas) utiliser le mécanisme de téléchargement HTTP intégré dans Coppermine pour télécharger la vignette personnalisée, vous n’êtes pas censé ajouté par lot la vignette personnalisée. Vous venez de l’envoyer par FTP et c'est tout ! Nous ne voulons pas qu’elle réside dans la base de données.

### FAQ pour les vignettes personnalisées

- #### J'ai une vidéo de nom `movie.wmv`, quand je télécharge pour une vignette `thumb_movie.jpg` elle remplace les vignettes pour de multiples vidéos !

  Heuu. `thumb_movie.jpg` est une vignette générique à un type de média. Renommez la vidéo et la miniature avec autre chose que simplement "movie".

- #### Je ne trouve pas mon dossier utilisateur !

  A l'intérieur de Coppermine, accédez à l'album de l'utilisateur. Regarder dans votre navigateur URL et vous devriez voir le nom du dossier(voir capture d'écran pour un exemple).
  Vos utilisateurs peuvent télécharger leurs propres vignettes en utilisant cette astuce: Créez un album. Modifier les autorisations pour que personne ne puisse le voir, sauf l'utilisateur spécifique. Puis télécharger les images en taille réelle dans ce dossier. Les fichiers hors de cet album seront en mesure d'utiliser les vignettes de ces images (voir ci-dessus pour la dénomination).

- #### Comment puis-je empêcher mes utilisateurs de créer leurs propres vignettes personnalisées ?

  Cela n'est pas possible actuellement.