Coppermine Photo Gallery v1.5.x: Documentation et manuel
Table des matières
Sélection de la langue de la documentation
Documentation de Coppermine
A Propos de Coppermine
A propos de cette documentation
Conventions de la documentation
Fonctions
Guide de démarrage rapide
Table des matières
Minimum requis
Minimum requis côté serveur
Serveur Web
Support PHP
Base de données MySQL
Librairie graphique
Auto hébergement & paramétrage du serveur web
Requis personnels
FAQ du minimum requis
Test
Pas d'aide pour les versions alpha et beta
Parties à regarder de manière particulièrement précise
Liste des fonctions
Format des rapports
Disponibilité
Langues
Comment les langues fonctionnent dans Coppermine
Se débarrasser d'une langue particulière
Langue de remplacement
Champ d'application de l'internationalisation
Le gestionnaire de langue
Contrôles
Colonnes
Défaut
Nom de la langue
Anglais
Original
Personnalisé
Drapeau
Fichier langue
Disponible
Complet
Activé
Guide de traduction
Demande de traducteurs !
Pourquoi traduire ?
Traduction demandées pour quels langues ?
Qui peut traduire ?
Encodage des caractères
Editeurs & Outils
Traductions complètes uniquement
Pas à pas
Problèmes particuliers
Version de la langue
Travail en cours
Traduction initiale pour la publication
Utilisation d'anciens fichiers langue
Traduction de la documentation
Etapes pour la traduction de la documentation dans votre langue
Assurez vous que la traduction n'existe pas déjà
Créez la structure
Copiez le noyeau du ficheir langue
Commencez la traduction
Choses ou il faut faire attention
Attention à la table des matières
Compressez (Zip) votre traduction
Lectures complémentaires
Crédits
L'équipe de Coppermine
Contributeurs
Traducteurs
Fichiers langue
Documentation
Codes libres utilisés
Remerciements
Merci beaucoup
Licence & Copyright
Copyrights
Licence
Versions précédentes
Termes additionnels (ajouts à la licence)
Preservation des droits d'auteur
Marquages des versions modifiées
Freedom
Problèmes connus
Installation et configuration
Comment installer le script
Ce que fait l'installeur
Informations Complémentaires
Configuration du serveur
register_globals
Configurer les permissions
Permissions on different webserver types
Apache sur Unix/Linux (CHMOD)
Base
Groupes dans Lunix
Services sur les serveurs Web
Arithmétique binaire
Ce qu'il y a de bien avec ça?
Application FTP
Panneau de controles des sites
Accès Shell
Problèmes de Propriétés (CHOWN)
Apache sur Windows
IIS sur Windows
Demander de l'aide sur les problèmes liés aux permissions
Droits au niveau du sytème de fichiers
L'écran d'installation
L'installeur classique
L'assistant d'installation
Les auto-installateurs
Que sont les auto-installateurs ?
La triste histoire
Pourquoi il ne faut pas utiliser d'auto-installateurs
Pas d'aide
FAQ d'installation
Désinstallation
Mise à jour
Pourquoi mettre à jour ?
Raison de publication de mises à jour par package
Changelog
Raison de publication de mises à jour par package
Etapes supplémentaires pour une mise à jour depuis une version particulière
Mise à jour depuis les versions cpg1.0,1.1,1.2.x ou 1.3.x
Mise à jour depuis cpg1.4.x vers cpg1.5.x
Plugins
Thèmes personnalisés
Fichiers langues
Cryptage des mots de passe
Affichage de la FAQ
Fichiers obsolètes
Safe mode
Mise à jour d'une ancienne versions de cpg1.5.x vers la version la plus récente de cpg1.5.x
Le script de mise à jour
Ce qu'il fait
Objectif
Vérification des autorisation
Quand faut'il lancer le script de mise à jour ?
L'outil de vérification de version
Ce qu'il fait
Première utilisation
Options
Affichage de la sortie
Ne monrer que les erreurs potentielles
Cacher les images
Ne pas vérifier les fichiers modifiés
Ne pas se connecter au référentiel en ligne
Comparaison de version
Chemin
Manquant
Droits
Version
Revision
Modifié
Commentaire
Lien du référentiel
Choses qui peuvent mal se passer en utilisant le vérificateur de version
Fausses attentes
FAQ de mise à Jour
Retour de cpg1.5.x vers une version antérieurs
Démarage
Concepts de Base
Configuration initiale
Structure des Catégories/Albums/Fichiers
Images redimensionnées
Vignettes
Images intermédiaires
Originales
Réglages recommandés pour le redimensionnement
pas d'images grande taille dans une fenêtre pop up
Autoriser les images de grande taille en préservant le maximum d'espace
Réglages "Standards" avec utilisation modérée de l'espace
Votre compte administrateur
Vérification des téléchargements
Penser à l'intégration
Qu'est ce que vos visiteurs sont autorisés à faire ?
Changez l'aspect de votre galerie Coppermine
Réglages particuliers
Téléchargeur unique sans interaction d'utilisateur (galerie monolithique)
Téléchargeur unique avec interaction des utilisateurs
Multiple uploaders without new registrations (closed group)
FAQ (Questions fréquemment posées)
Réglages / Configuration
Ajouts / Modifications / Hacks
Forum d'aide de Coppermine
Thèmes
Thèmes livrés avec Coppermine
Mise à jour de votre thème personnalisé
Convertir un thème cpg1.4.x pour cpg1.5.x
Modifier style.css
Modifier template.html
Modifier theme.php
Méthode de validation
Contenu d'un thème
Modifier template.html
Conteneurs (tokens) du thème
Important
Liste des conteneurs (tokens) dans template.html
Modifier style.css
Outils
Web Developer Toolbar usage
Editor
Liste des classes dans style.css
Feuilles de style additionnelles
Modifier theme.php
Type d'éléments
Le thème sample - un thème pour copier/coller
Méthode
Point de vue
Liste des items dans theme.php
Exemple de thèmes
Contenu additionnel
Contenu additionnel sur la page des vignettes
Nouvelle colonne entre les colonnes de vignettes
Nouvelle celulle de table sur chaque page de vignette
Contenu additionnel sur la page des images intermédiaires
Directement à côté des images intermédiaires
Directement à côté du négatif de film
Contenu aditionnel de la fenêtre pop-up des images originales
Conclusions
Comment fonctionne le moteur de thèmes
Thèmes: Contributions d'utilisateurs
Visualisation de thèmes provenant de la contribution d'utilisateurs
Téléchargement de thèmes provenant de la contribution d'utilisateurs
Installation de thèmes provenant de la contribution d'utilisateurs
Copyrights de thèmes provenant de la contribution d'utilisateurs
Demande d'aide pour les thèmes provenant de la contribution d'utilisateurs
Contribuer avec votre propre thème
Créez votre thème personnalisé
Commencez par renommer votre thème
Trucs & astuces
Utilisation d'éditeurs WYSIWYG
Changer les couleurs
Créer un thème pour Coppermine qui reprend l'aspect général de votre site
Introduction
Pre-requisites
Tools
Skills
Example
Pick a similar theme first
Start editing your theme
Replace the content from the sample with placeholder tokens
Adapting the style
Initial test
Editing template.html
Template tokens
Important
List of tokens in template.html
Editing theme.php
Item types
The sample theme - a template to copy from
Method
Scope
List of items in theme.php
Editing style.css
Tools
List of classes in style.css
Additional stylesheet
Theme examples
Summary
Additional content
Additional content on the thumbnail page
Extra row between thumbnail rows
Extra table cell on each thumbnail page
Additional content on the intermediate-image pages (displayimage.php)
Directly next to the intermediate image
Directly next to the film strip
Additional content on the full-size pop-up
Copyright-clause de non responsabilité dans le pied de page
Utilisation acceptable
Utilisation inacceptable
Contenu Dynamique (piloté par PHP)
Utiliser anycontent.php
Haut de page et pied de page personnalisés
Contenu dynamique basé sur le thème (theme.php)
Modifier les fichiers du noyau
Ressources graphiques dans les thèmes
Icones de menu
Images de la barre de navigation
Images de notation
Images du Négatif de film
Progress image (loader)
Administration
Eléments du menu Administrateur
Activer/Désactiver les contôles administrateurs
Fichiers à valider
Configuration
Catégories
Albums
Tri des images
Groupes
Utilisateurs
Bannir des utilisateurs
Mon profil
Voir les commentaires
Afficher les e-cartes
Ajout d'images par lot (FTP)
Outils administrateur (redimensionnements des images)
Gestionnaire de mots-clés
Gestionnaire de plugins
Gestionnaire d'intégration
Voir les logs
Statistiques générales
Vérificateur de version
Mise à jour de la base de données
Export
phpinfo
Montrer les news
Documentation
Mode administrateur pour les utilisateurs normaux
Eléments de menu administrateur pour les utilisateurs normaux
Bannissement
Quoi de neuf ?
Point de vue
Comment fonctionne le bannissement
Pourquoi le bannissement par adresse IP n'est pas recommandé
Contrôles de la Page
Pas de bannissement s'il y a une passerelle
A faire
Configuration
Paramètres généraux
Paramètres de langue & de jeu de caractères
Paramètres des thèmes
Affichage de la liste des albums
Affichage des vignettes
Affichage des images
Paramètres des commentaires
Paramètres du formulaire de contacts
Paramètres des vignettes
Paramètres des fichiers
Filigrane d'image
Enregistrement
Paramètres des utilisateurs
Champs personnalisés pour le profil utilisateur
Champs personnalisés pour la description d'images
Paramètres du cookie
Paramètres des courriels
Logging & statistiques
Paramètres de maintenance
Utilisation de cette page
Restaure les paramètres par défaut
Groupes
Le panneau d'administration des groupes
Noms des groupes
Type de groupes
Quotas
Droits (Note/Cartes électronique/Commentaires)
Téléchargement dans les albums publics
Galerie personnelle
Méthode de téléchargement
Albums assignés
Création de groupes personnalisés
Suppression de groupes personnalisés
Déclenchement de synchronisation (passerelle avec une autre application uniquement)
Membre dans plus d'un groupe
Utilisateurs
Le panneau de contrôle des utilisateurs
Page de gestion
rechercher un/des utilisateur(s)
Créer de nouveaux utilisateurs
Modifier les utilisateurs
Appartenance à un groupe
Mot de passe perdu
Mot de passe du compte utilisateur Coppermine
Coppermine en mode autonome
Coppermine avec une passerelle
Mot de passe du compte MySQL
Catégories
Le panneau de gestion des catégories
Panneau de contrôle
Partie haute "Tri aplphabétique des catégories"
Section centrale "Gestion des catégories"
Section basse "Mettre à jour / Créer des catégories"
Catégorie spéciale "Galerie des utilisateurs (User galleries)"
Albums
Le gestionnaire d'albums
Créer des albums
Renommer des albums
Changer l'ordre des albums
Effacer des albums
Modifier les albums/fichiers
Propriétés des albums
Restauration des propriétés des albums
Administrateur vs. utilisateur
FAQ des albums
Fichiers
Editer les fichiers
Editer les vidéos
Vignettes personnalisées
Ordre des vignettes
Types de vignettes
Télécharger des vignettes personnalisées
Comment ça marche
Schéma de nommage
Pourquoi Coppermine ne peut pas créer des vignettes pour les vidéos ?
Instructions pas à pas
FAQ pour les vignettes personnalisées
Mots-clés
Attribuer les mots-clés
Séparateur ou délimiteur de mots-clés
Modifier/ajouter des mots-clés
Gestionnaire de mots-clés
Mots-clés d'albums
BBCODE
But
Balises BBCode disponibles
Dangers
Plus de contrôles
Métadonnées EXIF
Que sont les métadonnées EXIF
Différentes versions
Comment ça marche
Pas de suppot des Exifs sur le serveur
Limites
Gestionnaire d'EXIF
Plugins
Quest ce qu'un plugin?
L'API plugin
Ou truver des plugins?
Plugins fournis avec Coppermine
Link Target (link_target)
Who is online? (onlinestats)
OpenSearch (opensearch)
Sample Plugin (sample)
User Gallery Alphabetic Tabbing (usergal_alphatabs)
Visible HookPoints (visiblehookpoints)
SEF_URLS plugin
Le gestionnaire de plugins
Télécharger un plugin
Installer un plugin
Configurer un Plugin
Désinstaller un plugin
Ecrire des plugins
Performance
Paramètres de configuration
Géneral
Dopage
Paramètres serveur
Paramètres PHP
Paramètres MySQL
Outils externes
YSlow
Utilitaires d'administration
Outils disponibles
Mettre à jour les Vignettes et/ou les photos redimensionnées
Nom du fichier → Titre de l'image
Supprimer le titre des photos
Supprimer les photos dans leur taille d'origine
Supprimer les images intermédiaires
Effacer les fichiers plus anciens qu'un nombre de jours déterminé
Supprimer les commentaires orphelins (fonctionne pour tous les albums)
Effacer la copie de l'image originale (Mod filigrane)
Recharger les informations de poids et de taille
Réinitialisation du compteur de vues
Convertir le séparteur de mots-clés
Utilisation
Erreurs
Types d'erreurs
Erreurs légères
Erreurs graves
Erreurs non traitées
Erreur Fatale
Activer le mode de débogage dans la configuration
Activer manuellement le mode de débogage
Désactiver le mode de débogage
Messages d'erreurs communs
Messages d'erreur relatifs à la base de données
Erreurs PHP communes
Messages d'erreur relatifs aux téléchargements
Codes réponses des serveurs
Sauvegarde & Déplacement
Sauvegarder votre galerie
Sauvegarde des fichiers
Sauvegarde complète des fichiers
Sauvegarde partielle des fichiers
Sauvegarde incrémentielle
Sauvegarde de la base de données
Ce qui doit être sauvegardé
Outils de sauvegarde de la base de données
phpMyAdmin
mySqlDumper
mysqldump
mysqlhotcopy
Après la sauvegarde de la base de données
Déplacer votre galerie
Déplacer la galerie sur votre serveur
Déplacement d'un serveur vers un autre
Désagréments liés au renommage
Changer l'URL de Coppermine dans la configuration
Filigrane d'images
Alternatives
Désactiver le menu contextuel
N'afficher votre précieux contenu qu'aux visiteurs légitimes
Afficher un recouvrement
Filigrane côté client
Téléchargement
Téléchargement des images par FTP / Ajout les images par lot
Ce que fait le téléchargement par lot
Comment fonctionne le téléchargement par lot
Erreurs communes
L'ajout par lot ne fonctionne pas comme prévu
Les Fichiers semblent corrompus
Ne les renommez pas
N'effacez pas
Tri
Importance des majuscules
Les ordinateurs voient les nombres différemment
Téléchargement par HTTP
Interface de téléchargement
Interface de téléchargement de fichiers multiples géré par flash
Utilisation
Interface de téléchargement de fichier unique par HTML
Utilisation
Assistant Windows XP Web Publisher
Requis
Configuration
Téléchargement d'images
Structure des fichiers
Effacement / Désinstallation
Dépannage du téléchargement
Droits
Activer les paramètres de dépannage
Demander de l'aide pour des problèmes de téléchargement
Guide pas à pas de demande d'aide
Exemple de support d'aide
Messages d'erreur
Failed to create stream: Operation not permitted
Impossible to move x to y
failed to open dir: No such file or directory
Sorry there is no album where you are allowed to upload files
Allowed memory size of X bytes exhausted
Exec() has been disabled
Not a GD extension
Error executing ImageMagick - Return value 127
PHP running on your server does not support the GD image library
No file was uploaded ! If you have really selected a file to upload, check that the server allows file uploads
Destination directory x is not writable by the script
Restrictions côté serveur
Le fichier de configuration de PHP php.ini
Les choses à vérifier
Mécanismes/méthodes de téléchargement
Utilisation de la mémoire pendant le redimensionnement
Commentaires
Permettre les commentaires
Commentaires options
Questions spam
Captcha
Approbation
Akismet
Résumé
Vérifier les commentaires
Commentaires individuels
Intégration/Passerelle
Ce que fait l'intégration
Fichiers d'intégration disponibles
Pré-requis
Authentification par cookie
Version autonome d'abord
Les utilisateurs, groupes et fichiers téléchargés par les utilisateurs sont perdus lors de l'intégration
Sauvegarde
Etapes de l'intégration
Utiliser le gestionnaire d'intégration
Choisir l'application à intégrer
Chemin(s) utilisés par votre application intégrée
URL de l'application intégrée
Chemin absolu de l'application intégrée
Chemin relatif vers le fichier de configuration de votre application intégrée
Préfixe du cookie
Paramètres spécifiques de l'application intégrée
Utiliser les groupes personnalisés de l'application intégrée ?
Activer/Désactiver l'intégration
Restauration après l'échec de l'intégration
Synchronisation des groupes de l'application intégrée avec ceux de Coppermine
Aide sur l'intégration
Certaines options de configuration sont désactivées
Fichiers d'intégration
Créer un fichier d'intégration personnalisé
Philosophie de l'intégration
Problèmes d'intégrations particulières
phpBB3
PunBB1.1.5
PunBB1.2
XMB
Problèmes de sous-domaines
Système de fichiers
Cookies
Sous-domaine www
Documentation des développeurs
Ajout/renommage/effacement de fichiers
Cible visée
But
Conventions de nommage
Ajouts de fichiers
Fichiers langues
Rennomage de fichiers
Effacement de fichiers
Guide et règles de codage
Public ciblé
But
Indentation
Encodage
Règles générales
Code PHP
Formatage
Structures de contrôle
Appel des fonctions
Définition des fonctions
Balise de code PHP
HTML imbriqué dans PHP
Fin de ligne
Conventions de nommage
Requêtes de base de donnée
Documentation
Sortie HTML
Balise Image dans les sorties HTML
Liens dans les sorties HTML
Eléments de formulaires dans les sorties HTML
Balises dépréciées
Balises populaires
Credits pour les règles de codage
Facilités d'utilisation
Formulaires
Config options
Target audience
History
New features
Step by Step
Basic.sql
Update.sql
Admin.inc.php
Language file
Documentation
To Do
Database schema
Configuration file
Database reference within coppermine code
cpg15x_albums
cpg15x_banned
cpg15x_bridge
cpg15x_categories
cpg15x_categorymap
cpg15x_comments
cpg15x_config
cpg15x_dict
cpg15x_ecards
cpg15x_exif
cpg15x_favpics
cpg15x_filetypes
cpg15x_hit_stats
cpg15x_languages
cpg15x_pictures
cpg15x_plugins
cpg15x_sessions
cpg15x_temp_messages
cpg15x_usergroups
cpg15x_users
cpg15x_votes
cpg15x_vote_stats
Editing the documentation
Target audience
Edit existing documents
Add new documents
Moving content from one document to the other
Hidden features
Database structure
Header & footer blocks
Documentation internationalization
Expandable/collapsible "detail"-blocks
Help
Start and end anchors needed
Adding anchors to headings
Code
CSS class "code"
HTML-tag "pre"
CSS class "cpg_code"
CSS class "smallcode"
HTML-tag "textarea"
Combining HTML tags and CSS classes
No syntax highlighting
Javascript in Coppermine
Target audience
Javascript files location and organization
TODO
How to include javascript files
How to include JavaScript files in plugins
How to pass PHP variables to included javascript
Autostart JavaScript
Packaging a new release
Target audience
Subversion repository
Steps
Check out
Replace version number in all files
Linux
Windows
Remove Byte Order Marks
Prepare an announcement thread
Edit the upgrade section of the docs
Edit the changelog
Edit the version number
Commit your changes
Update the versioncheck data
Completeness
Update revision numbers and hashes
Update cpg15x.files.xml on the Coppermine home page
Export from subversion
RapidSVN
Tortoise SVN
Create a tag in subversion
RapidSVN
Tortoise SVN
Create the archive
Upload the archive
Publish announcement thread
Create news items
News item on sf.net
News item on forum
News item on home page
News embedded into existing galleries
Update the demo
Plugin Writing for Coppermine
Quick Start Guide
Intended Audience
People who should read this documentation
People who do not need to read this documentation
Why write plugins?
Preparations
Choose a name
Consider translations
Consider a config screen
Database changes
Support issues
Plugin versions
Core files
Naming conventions
Folders
Files
Archives
Coding
Use of Superglobals
Database access
Direct queries
Accessing database tables
Creating database tables
Deleting database tables
Storing your plugin's config values
Plugin Types
Using includes
Plugin Writing: Tutorial, API
Intended Audience
Required Skills & Knowledge
Recommended Software & Support Forums
"Hello, world" Plugin Tutorial
My First Plugin
Installation, Configuration, and Clean-Up
Installation with Simple Configuration
Installation with Configuration Parameters
Adding a config section to your plugin
Uninstallation & Clean-Up
Linking to Custom Plugin Scripts
Adding a Button to Coppermine
Adding a Button to the admin menu
Adding a Button to the overall menu
Adding JavaScript to plugins
Multi-language Support
Distributing Your Plugin
Plugin Hooks
Plugin Class Properties & Methods
Global Variables & Constants
Creating plugins: step by step
Getting started with the plugin template
1. Extract the plugin template
2. Choose a name
3. Rename the folder
4. Rename the placeholders inside the files
5. Copy the new plugin folder to the target
Creating a config record for your plugin
1. Decide for an option type
2. Choose a record name
3. Create the record during plugin install
4. Create the uninstall query
5. Specify the scope of your config record
6. Populate form options
7. Output the form elements (rows)
a. Checkbox
b. Radio button
c. Dropdown (select/option list)
d. Text input field (one line), both for numerical input (integers) as well as any other textual input
e. Text input field (multiple lines, aka textarea)
8. Create the needed translation strings
Reference list of plugin hooks
Target audience
Choosing Plugin Hooks
Finding Plugin Hooks
Plugin Hooks by File Name
Script: index.php
Filter: 'anycontent'
Filter: 'user_caption_params'
Filter: 'plugin_block'
Script: displayimage.php
Filter: 'file_info'
Filter: 'post_breadcrumb'
Script: thumbnails.php
Filter: 'post_breadcrumb'
Script: functions.inc.php
Filters: 'gallery_header' and 'gallery_footer'
Filter: 'thumb_data'
Filter: 'template_html'
Filter: 'page_meta'
Filters: 'thumb_caption' and all derivatives
Script: themes.inc.php
Filter: 'file_data'
Script: usermgr.php
Filter: 'usermgr_header'
Filter: 'usermgr_footer'
Script: pluginmgr.php
Filter: 'plugin_configure'
Filter: 'plugin_cleanup'
Script: plugin_api.inc.php
Filter: 'page_html'
Filter: 'page_end'
Filter: 'plugin_install'
Filter: 'plugin_uninstall'
Filter: 'plugin_wakeup'
Filter: 'plugin_sleep'
Script: init.inc.php
Filter: 'page_start'
Script: picmgmt.inc.php
Filter: 'add_file_data'
Plugin Hooks Alphabetically
Plugin Hooks by Hook Type
Plugin Hook Examples
Adding an upload method
Add tags for thumbnails display
Sanitization of Superglobals using Inspekt
Target audience
What's new?
Reason
What Inspekt does
Inspekt accessor methods
How to use Inspekt with Coppermine Photo Gallery
Using Inspekt
Inspekt in Coppermine
Consider the methods to use
Examples
Regular Expressions
Links
Subversion
Target audience
Caveats
What is subversion?
Where is the subversion repository hosted?
Recommended software
Alternative access using Web SVN
Repository structure
Coppermine core files
Plugins
Checking out
Checking out the entire repository
Checking out a particular Package
Checking out a particular file
Refering to files downloaded from the subversion repository
Is there no single package that I could download instead?
Download Tarball archives
Developers-only
Check out before checking in
Committing your code
Changelog
Obtaining write access
Step by step
Download the client application
Initial checkout
Revisions
Subversion file headers
Tools recommended by the devs
Database manipulation
FTP clients
Web development
Text editors
Picture Editors
Updating
Target audience
Hidden feature
Variables & Constants
System Global Variables
Coppermine Constants
Versioncheck
Hidden features
XML structure
To do list