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

# A propos de Coppermine

Coppermine Photo Gallery (CPG) 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 optionnel de sélection de thème par l'utilisateur avec de nombreux thèmes 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 accéder 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 nécessaire à 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 standard. Le script d'installation (install.php) rend 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 gratuit et open source et peut être utilisé aussi bien pour les sites personnels ainsi que pour un usage commercial. Il est publié sous la licence 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 pourrez allez dans le chapitre de la documentation que vous souhaitez.

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

### Convention de la documentation

Tout au long de la documentation des conventions ont été appliquées:

#### Boites de textes

Il ya des zones de texte dans cette documentation qui ont une signification particulière:

Les exemples qui sont destinés à illustrer les instructions données sont affichés 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ées 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.

Les longues sections d'exemples de code (cela peut être du PHP, HTML, CSS ou du JavaScript) sont affichées en utilisant l'icône de machine à écrire au début.

#### Liens

Tous les liens "normaux" (qui n'ont pas d'icônes spéciales affichées juste après) sont des liens internes, c'est à dire, qu'ils font référence à des sections de cette documentation et par conséquent vous permettent de naviguer à travers celle-ci. Les exceptions à cette règle sont les liens suivants:

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

  Il y a certaines 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 petite 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'icône n'aura aucune action.

- ##### Liens externes

  Les liens externes qui pointent vers une page hors de cette documentation sont suivis par une petite icône 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 la documentation concernant des termes techniques du langage de programmation PHP. Les liens sont repérés par une petite icône 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 icônes 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 facilité l’aide: 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 utiles si vous voulez 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élioration, 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) (cpg1.5.x)
  - Approbation de l'enregistrement par l'administrateur
  - Notification des enregistrements pour l'administrateur
  - Création optionnelle d'albums personnels lors de l'enregistrement (cpg1.5.x)
  - Fonction: l’utilisateur peut effacer son propre compte feature (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): intégration 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 assistant d'intégration (gestionnaire d'intégration)
  - Adhésion des utilisateurs en plusieurs groupes
  - plus de champs paramétrables par l'administrateur pour le profil utilisateur
- Gestion des catégories et des albums
  - Classement des images dans catégories, 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ées)
  - 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'approbation 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 lignes et des colonnes
  - Redimensionnement des images au téléchargement
  - Prévisualisation des vignettes pendant le processus d'ajout par lot (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ères non-latins dans les noms de fichiers sont remplacés par leur translitération si possible ou par un caractère de soulignement s‘il n'existe pas de translitération pour une utilisation web sécurisée au regard des connaissances des utilisateurs (cpg1.5.x)
- Affichage des images
  - Meta-albums:
    L'administrateur peut définir quel album complémentaire virtuel peut être utilisé pour proposer une "vue" alternative ou méthode pour naviguer dans la galerie:
    - Derniers commentaires
    - Derniers ajouts
    - Images alé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 thèmes
  - 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 inapproprié 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 systèmes d’exploitation 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és cliquables
  - Fonction de nuage de mots-clés (cpg1.5.x)
- Administration
  - Outils d'administration
  - Authentification 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ésapprouvés temporairement par l'administrateur pour les cacher (cpg1.5.x)
  - Option de bannissement direct sur l'écran d'approbation 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
  - Icônes 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 les images stockées dans la base de données
  - 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
  - Paramètres 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 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 des moteurs de recherche pour l'indexation des Méta-albums (cpg1.5.x)
- Apparence visuelle
  - Système de Template/thèmes
  - Séparation du bloc de navigation afin de pouvoir le placer indépendamment des catégories dans le thème
  - 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'icône "Privé" pour les utilisateurs non identifiés ou n'ayant pas les bons privilè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)
  - Couleurs 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:

- Minimum requis
- Installation et configuration
- Démarrage
- Langues
- Crédits
- Licence & droit d'auteur
- Problèmes connus