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

Table des matières

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

Et maintenant ?

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