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

# A Propos de Coppermine

Coppermine Photo Gallery est un script de galerie photo facile à utiliser supportant d'autres fichiers multimédia. La galerie peut être privée, uniquement accessible aux membres enregistrés, et/ou ouvert à tous les visiteurs de votre site. Les utilisateurs, si vous l'avez autorisé, peuvent télécharger des images depuis leur navigateur internet (Les vignettes et les images intermédiaires sont crées à la volée), noter les images, ajouter des commentaires et même envoyer des e-cartes. L'administrateur du site détermine quelles fonctions citées précédemment seront accessibles par les utilisateurs enregistrée ou non enregistrés. L'administrateur peut aussi gérer la galerie et ajouter par lot un grand nombre d'images téléchargées sur le serveur par FTP.

Les fichiers Image sont stockés dans des albums et les albums peuvent être regroupés dans des catégories, qui elles même, peuvent elles aussi être groupées dans des catégories mêres. Le script supporte de multiples utilisateurs et offre à l'administrateur du site des outils pour gérer les permissions de chaque groupe d'utilisateur concernant la possibilité d'avoir ou pas d'albums personnels, d'envoyer des e-cartes ou d'ajouter des commentaires. Les utilisateurs peuvent aussi télécharger dans les albums publics si l'administrateur l'autorise. L'autorisation de créer des albums, de télécharger et d'effacer des fichiers est déterminée par l'administrateur du site.

Coppermine comporte un système optionel de sélection de theme par l'utilisateur avec de nombreux themes préinstallés. Le script supporte aussi de multiples langues et contient sa propre librairie de langues. Ces fichiers langues permettent à vos visiteurs d'y acceder avec leur langue préférée. Coppermine utilise PHP, une base de donnée MySQL, et soit la librairie graphique GD (version 1.x ou 2.x) ou ImageMagick pour générer et conserver les informations des fichiers pour les vignettes, les images intermédiaires et les images originales. Coppermine génère le code html necessaire à l'affichage dynamique des différentes catégories, sous-catégories, albums, images intermédiaires ou originales. Cela réduit de manière drastique le nombre de fichiers et la place que votre galerie utiliserait avec un codage HTML standart. Le script d'installation (install.php) rends le démarrage facile et rapide.
Coppermine Utilise la librairie JavaScript/Ajax jquery pour une personnalisation et une utilisation plus facile pour les utilisateurs.

Coppermine est un logiciel Open Source libre et gratuit qui peut être utilisé aussi bien pour des sites personnels que commerciaux. Il est publié sous license GNU GPL version 3, qui a été approuvée par la OSI.

## A Propos de cette documentation

Utilisez le menu en haut à gauche de l'écran pour naviguer dans la documentation de Coppermine. Le menu est disponible dans l'ensemble de la documentation. Le menu utilise le JavaScript. Si vous avez désactivé JavaScript ou si vous ne pouvez pas l'utiliser pour quelque raison que ce soit, Utilisez le lien en haut qui vous mènera à la table des matières depuis laquelle vous pourez allez dans le chapitre de la documentation que vous souhaitez.

L'équipe de développement de Coppermine recommande fortement d'aciver JavaScript et d'utiliser un navigateur moderne (avec CSS et JavaScript suivant le standart DOM) pour lire cette documentation plus facilement.

### Convention de la Documentation

#### Boites de textes

Voici les puces et bandeaux de cette documentation qui ont une signification spécialeThere are text boxes in this documentation that have special meanings:

Les Exemples qui sont destinés à illustrer les instructions données sont affichées comme ceci!

Les Informations complémentaires qui ne doivent pas être négligées sont affichées comme ceci.

Les Conseils qui, généralement, conduisent à une meilleure compréhension des mécanismes de fonctionnement de Coppermine ou qui vous aideront à appliquer avec succès les fonctionnalités sont mis en évidence comme ça.

Les Alertes sur les choses qui peuvent facilement aller mal si une erreur est faite sont affichées de cette façon. Il est conseillé de porter une attention particulière au texte de ces bandeaux.

Les Choses qui peuvent mal se passer en fonction de l'interaction de l'utilisateur ou des saisies de l'utilisateur sont affichés comme ça.

Les Erreurs actuelles ou les problèmes pouvant avoir un grand impact sont affichés comme ceci. C'est la sorte de bandeau la plus importante - Son contenu est à lire très attentivement.

#### Liens

Tous les liens "normaux" (qui n'ont pas d'icones spéciales affichées juste après) sont des liens internes, ex. ils font référence à des sections de cette documentation et par concéquent vous permettent de naviguer à travers celle-ci. Les exeptions à cette règle sont les liens suivants:

- ##### Sections déroulables/repliables

  Il y a cetraines sections qui peuvent être déroulées ou repliées (si le Javascript est autorisé par votre navigateur) pour une lecture plus facile. Généralement les sections déroulables contiennent des détails à propos du paragraphe précédent. Les sections déroulables sont signalées avec une betite boite contenant un plus () juste après lorsqu'elle peut être déroulée, et avec une boite contenant un moins () si elle est déroulée. Si JavaScript est désactivé dans votre navigateur, le fait de cliquer sur l'icone n'aura aucune action.

- ##### Lien externes

  Les liens externes qui pointent vers une page hors de cette documentation sont suivis par une petite icone représentant une fenêtre avec une flêche à l'intérieur: .

- ##### documentation PHP

  Comme Coppermine est une application écrite en php, il y a un certain nombre de références dans sa documentation à des termes techniques du language de programmation PHP. Les liens sont repérés par une petite icone PHP () qui pointent vers la documentation officielle de PHP sur le site php.net qui contient des informations complémentaires ou des définitions du mot utilisé dans la documentation de Coppermine.

- ##### Ancres

  Dans chaque page de la documentation de Coppermine, vous trouverez des icones d'ancres () à côté de beaucoup de têtes de chapitres. Ils sont cliquables et pointent exactement vers le paragraphe correspondant. Leur fonction est essentiellement pour une aide plus facile: si un supporter veut pointer vers une section particulière de la documentation dans son post, il/elle peut facilement faire un clic droit, "copier l'URL du lien" dans la documentation de Coppermine et coller ce lien dans son post. Pour vous, utilisateurs finaux, ces ancres peuvent être utilse si vous voullez mettre en marque page certaines sections particulières de la documentation.

## Fonctions

Coppermine propose beaucoup de fonctions. Ci-dessous vous en trouverez une liste incomplête . Les nouvelles fonctions de cpg1.5.x (par rapport à cpg1.4.x) sont signalées.

Details

- Installeur
  - installation facile (Grace à un installeur)
  - amélioré, de type assistant d'installation (cpg1.5.x)
- Enregistrement & Identification
  - termes et conditions d'utilisation (cpg1.5.x)
  - fonction paramétrable dans la configuration pour un mot de passe global pour l'enregistrement (cpg1.5.x)
  - Confirmation visuelle (captcha) pour l'enregistrement (cpg1.5.x)
  - vérification de l'adresse courriel (lien d'activation)
  - Fonction de réenvoi du lien d'activation (cpg1.5.x)
  - Approbation de l'enregistrement par l'administrateur
  - Notification des enregistrements pour l'administrateur
  - creation optionnelle d'albums personnels lors de l'enregistrement (cpg1.5.x)
  - Fonction: l'utilisateur peut effacer son propre compte (cpg1.5.x)
  - Possibilité de s'identifier par le nom d'utilisateur ou par l'adresse courriel (cpg1.5.x)
- Gestion des Utilisateurs
  - Gestion des utilisateurs (galeries privées, groupes)
    les visiteurs peuvent s'enregistrer eux même (si l'administrateur autorise les enregistrements). Alternativement, l'administrateur peut créer des comptes utilisateurs.
  - La gestion des Utilisateurs est basée sur les groupes
  - Les permissions sont gérées/assignées par groupe
  - intégration (bridge): integration de la gestion des utilisateurs avec plusieurs applications de forums (comme phpBB, YaBB SE, SMF, Invisionboard, vbulletin)
  - Intégration des forums paramétrable avec un assitant d'intéhration (gestionnaire d'intégration)
  - Adhésion des utilisateurs en plusieurs groupes
  - plus de champs paramétrables par l'administrateur pour le profil utilisateur
  - Modérateur optionnel pour les albums (cpg1.5.x)
- Gestion des catégories et des albums
  - classement des images dans des categories, des sous-catégories (optionnelles) et des albums
  - Les utilisateurs peuvent créer des albums dans les catégories ou l'administrateur l'a autorisé (cpg1.5.x)
  - Nouveau système de hiérarchie des catégories (cpg1.5.x)
- Téléchargement
  - Les utilisateurs peuvent télécharger les images/fichiers avec une interface web (et l'administrateur peut les télécharger par FTP et les ajouter en masse dans la base de donnée)
  - création de vignettes et d'images intermédiaires
  - Légende, titre, description et champs définis par l'utilisateur pour chaque image (utilisables pour la recherche)
  - Notification d'aprobation de téléchargement pour l'administrateur
  - rotation des images
  - téléchargement d'images multiples
  - option pour choisir la hauteur ou la largeur maximale pour les vignettes permettant de créer un meilleur aspect des lognes et des colonnes
  - Redimenssionnement des images au téléchagement
  - prévisualisation des vignettes pendant le processus d'ajout par lotp (optionnel)(cpg1.5.x)
  - Type de fichiers autorisés affichés sur l'écran de téléchargement (cpg1.5.x)
  - barre de progression animée sur l'écran de téléchargement pour indiquer la progression du processus de téléchargement (cpg1.5.x)
  - Les caractère non-latins dans les noms de fichiers sont remplacés par leur translitération si possible ou par un caractère de soulignement si il n'existe pas de transliteration pour une utilisation web sécurisée au regard des connaissances des utilisateurs (cpg1.5.x)
- Affichage des images
  - Meta albums:
    L'adimistrateur peut définir quel album complémentaire virtuel peut être utilisé pour proposer une "vue" alternative ou methode pour naviguer dans la galerie:
    - Derniers commentaires
    - Derniers ajouts
    - Images alléatoires
    - meta-album de Navigation par date (cpg1.5.x)
    - Les plus visualisées
    - Les mieux notées
    - favoris
  - Diaporama
  - option pour afficher un négatif cliquable avec les vignettes sous l'affichage des images
  - option de filigrane (cpg1.5.x)
  - recadrage et amélioration de la netteté des vignettes (cpg1.5.x)
- Actions des Utilisateurs
  - Commentaires des utilisateurs
  - Option d'approbation des commentaires (cpg1.5.x)
  - confirmation visuelle (captcha) pour les commentaires (cpg1.5.x)
  - utilisation d'Akismet pour le filtrage des commentaires (cpg1.5.x)
  - Obligation d'enregistrement pour la section des commentaires (cpg1.5.x)
  - fonction d'e-carte
  - Support de Flash pour les e-cartes (cpg1.5.x)
  - Option de sélection de langue dans les themes
  - protection des albums par mots de passe
  - Vote/Evaluation
  - Affichage des votes sur la page des vignettes (optionnel)(cpg1.5.x)
  - Niveau de vote personnalisable et piloté par Ajax (cpg1.5.x)
  - formulaire de contact avec captcha (optionnel)(cpg1.5.x)
  - L'utilisateur peut rapporter un contenu innaproprié ou déplacé à l'administrateur
  - favoris: les visiteurs peuvent placer des images dans leurs favoris pour leurs prochaines visites
- Statistiques
  - Affichage public du nombre d'images de vues et derniers téléchargements
  - Statistiques sur les navigateurs et les sytsèmes d'exploitations pour les administrateurs (cpg1.5.x)
  - Statistiques globales (cpg1.5.x)
  - compteur de hits pour les albums (cpg1.5.x)
  - Les statistiques publiques peuvent être désactivées (cpg1.5.x)
- Recherche
  - Recherche avancée (opérateurs booléens)
  - expressions régulières dans la recherche (cpg1.5.x)
  - Mots clé cliquables
  - Fonction de nuage de mots clés (cpg1.5.x)
- Administration
  - Outils d'administration
  - Autentification basique pour le script de mise à jour (cpg1.5.x)
  - Retour à la configuration par défaut pour chaque option de configuration (individuellement) (cpg1.5.x)
  - Les fichiers téléchargés peuventêtre désaprouvés temporairement par l'administrateur pour les cacher (cpg1.5.x)
  - Option de bannissement direct sur l'écran d'aprobation des commentaires (cpg1.5.x)
  - Ecran de Gestion des utilisateurs avec des critères complémentaires, montrant l'interaction des utilisateurs(cpg1.5.x)
- Plugins
  - plugin-API pour permettre la création d'améliorations par le biais de contributions des utilisateurs
  - Plusieurs plugins disponibles
  - Gestionnaire de plugins
- Documentation
  - Fonction d'aide en ligne pour le page d'administration
  - icones d'aide bbcode pour les commentaires (cpg1.5.x)
  - Documentation complête accessible aux administrateurs
  - Documentation multi-langue
  - Documentation séparée en sections pour une meilleure lisibilité (cpg1.5.x)
- Divers
  - Informations sur le images stockées dans la base de donnée
  - Support multimédia complet
  - multi-langue
  - Anglais comme langue par défaut pour les entrées non traduites dans un fichier langue
  - Personnalisation de toutes les fonctions par une interface web (section administration)
  - Support EXIF/IPTC
  - Parametres d'URL se référant au chemin absolu plutôt qu'au chemin relatif pour une meilleure accessibilité aux moteurs de recherche (cpg1.5.x)
  - API pour Coppermine pouvant être utilisée avec des applications comme Koppermine et autres (cpg1.5.x)
  - Nouvelle section pour les administrateurs pour les alerter des mises à jour (cpg1.5.x)
  - Utilisation d'Inspekt pour assainissement des superglobales, un outil pour créer des applications PHP plus sures (cpg1.5.x)
  - Contrôle granulaire pour l'accès des visiteurs: pas d'accès, uniquement les vignettes, vignettes + images intermédiaires, vignettes + intermédiaires + images originales (cpg1.5.x)
  - Prévention des robots de moteurs de recherche pour l'indexation des Méta Albums (cpg1.5.x)
- Apparence visuelle
  - Système de templates/themes
  - Séparation du bloc de navigation afin de pouvoir le placer indépendament des catégories dans le theme
  - option pour montrer le premier niveau d'album d'une catégorie au lieu de juste les statistiques de cette catégorie
  - option pour activer ou désactiver l'affichage de l'icone "Privé" pour les utilisateurs non identifiés ou n'ayant pas les bons provilèges
  - option pour envoyer directement les visiteurs des vignettes aux images originales (cpg1.5.x)
  - lien optionnel de téléchargement des animations (cpg1.5.x)
  - Couluers alternées pour les lignes des tables (cpg1.5.x)
  - Nuage de tags (mots clés) optionnel (cpg1.5.x)
  - barre latérale pour une navigation plus facile (cpg1.5.x)
  - Négatif de film piloté par ajax (cpg1.5.x)

## Et maintenant?

Il y a un certain nombre de pages de la documentation que les débutants devraient lire pour commencer:

- Guide de démarrage rapide
- Minimum requis
- Test (alpha/beta versions!)
- Langues
- Credits
- License & Copyright
- Problèmes connus