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
Nous recherchons des traducteurs !
Pourquoi traduire ?
Pour quelles langues a t'on pour besoin d'une traduction ?
Qui peut faire une traduction ?
Encodage des caractères
Éditeurs & Outils
Traduction complète uniquement
Pas à pas
Problèmes particuliers
Version du fichier langue
Travail en constante progression
Traduction initiale pour publication
Utilisation d'anciens fichiers langue
Traduction de la documentation
Étapes pour la traduction de la documentation dans votre langue
Assurez-vous que la traduction n'existe pas encore
Créez la structure
Copiez le noyau des fichiers langues
Commencer la traduction
Parties où il faut faire attention
Faites attention à la table des matières
Compressez votre traduction
Lectures complémentaires
Crédits
L'équipe de Coppermine
Contributeurs
Traducteurs
Fichiers langue
Documentation
Codes libres utilisés
Remerciements
Merci beaucoup
Licence & droits d'auteur
Droits d'auteur
Licence
Précédentes versions
Termes additionnels (ajouts à la licence)
Préservation des droits d'auteur
Marquage des versions modifiées
Liberté
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 sur les types de serveur web différents
Apache sur Unix/Linux (CHMOD)
Notions de base
Groupes dans Lunix
"Diablotins" des serveurs Web
Arithmétique binaire
A quoi bon tout cela ?
Application FTP
Panneau de contrôle de l'hébergement
Accès Shell
Ownership (CHOWN)
Apache sur Windows
IIS sur Windows
Demander de l'aide à propose de problèmes liés aux permissions
Permissions, sur le niveau des dossiers
L'écran d'installation
L'installateur 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 ?
Raisons de publication des paquetages
Changelog
Étapes nécessaires lors de la mise à jour de Coppermine
Action supplémentaires pour la mise à jour depuis une version particulière
Mise à jour depuis une version de cpg1.0, cpg1.1, cpg1.2.x ou cpg1.3.x vers cpg1.5.x
Mise à jour depuis cpg1.4.x vers cpg1.5.x
Plugins
Thème personnalisé
Fichiers de langue
Cryptage du mot de passe
Affichage de la FAQ
Fichiers obsolètes
Safe mode
Mise à jour depuis d’une ancienne version de cpg1.5.x vers la version la plus récente de cpg1.5.x
Mise à jour du script
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
Que fait t’il
Première utilisation
Options
Afficher la sortie
Montrer uniquement 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
Permissions
Version
Révision
Modifié
Commentaires
Lien vers le référentiel
Choses pouvant mal se passer avec le vérificateur de version
Fausses attentes
FAQ de mise à jour
Retour de cpg1.5.x vers une version plus ancienne
Démarrage
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 de 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 typiques
Téléchargeur unique sans interaction d'utilisateur (galerie monolithique)
Téléchargeur unique avec interaction des utilisateurs
Téléchargeurs multiples sans nouvelles inscriptions (groupe fermé)
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
Curve
Eyeball
Hardwired
Rainy Day
Sample
Waterdrop
Mise à jour de votre thème personnalisé
Convertir un thème de 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
Utilisation de la barre d'outils Web Developer
Éditeur
Liste des classes dans style.css
Feuille de style additionnelle
Modifiez theme.php
Types d'éléments
Le thème sample - un thème pour copier/coller
Méthode
Champ d'application
Liste des éléments de theme.php
Exemple de thèmes
Contenu additionnel
Contenu additionnel dans la page des vignettes
Nouvelle ligne entre les lignes de vignettes/a>
Nouvelle cellule de table sur chaque page de vignettes
Contenu additionnel sur la page des images intermédiaires
Directement après les images intermédiaires
Directement à côté du négatif de film
Contenu additionnel sur la fenêtre pop-up des images originales
Éléments de menu supplémentaires
Structure de menu entier défini dans un bloc
Sommaire
Comment fonctionne le moteur de thèmes
Thèmes: contribution des utilisateurs
Prévisualisation des contributions de thèmes d'utilisateurs
Télécharger des contributions de thèmes d'utilisateurs
Installer des thèmes provenant de contributions d'utilisateurs
Droits d'auteur des thèmes provenant de contributions d'utilisateurs
Demande d'aide pour les thèmes provenant de contributions d'utilisateurs
Contribuer avec votre propre thème
Création de votre thème personnalisé
Commencez par renommer votre thème
Trucs & astuces
Utilisation d'éditeurs WYSIWYG
Changer les couleurs & le design
Créer un thème pour Coppermine qui reprend l'aspect général de votre site
Introduction
Pré-requis
Outils
Connaissances
Exemple
Prenez d'abord un thème similaire
Commencez à modifier votre thème
Remplacer le contenu de l'exemple avec les appels aux conteneurs (Tokens)
Adapter le style
Test initial
Modifier template.html
Conteneurs (tokens) du thème
Important
Liste des conteneurs (tokens) dans template.html
Modifiez theme.php
Types d'éléments
Le thème sample - un thème pour copier/coller
Méthode
Champ d'application
Liste des éléments de theme.php
Modifier style.css
Outils
Liste des classes dans style.css
Feuille de style additionnelle
Exemples de thèmes
Sommaire
Contenu additionnel
Contenu additionnel dans la page des vignettes<
Nouvelle ligne entre les lignes de vignettes
Nouvelle cellule de table sur chaque page de vignettes
Contenu additionnel sur la page des images intermédiaires
Directement après les images intermédiaires
Directement à côté du négatif de film
Contenu additionnel sur la fenêtre pop-up des images originales
Affichage des droits d'auteurs et 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 concernant les thèmes
Icônes de menu
Images de la barre de navigation
Images de notation
Image du négatif de film
Image de progression (chargement)
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
Gestion d’utilisateurs
rechercher un/des utilisateur(s)
Créer de nouveaux utilisateurs
Modifier les utilisateurs
Appartenance à un groupe
Mot de passe perdu
Mot de passe de compte d'utilisateur de 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
Cible du lien (link_target)
Qui est en ligne ? (onlinestats)
OpenSearch (opensearch)
Sample Plugin (sample)
User Gallery Alphabetic Tabbing (Onglets alphabétiques pour les galeries utilisateurs) (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
Sauvegarde de la base de données: qu’est-ce qui doit être sauvegardé ?
Déplacement de votre galerie
Déplacement au sein de votre serveur
Déplacement d'un serveur à un autre
Inconvénients du renommage
Changer l'URL de Coppermine dans la configuration
Filigrane d'images
Alternatives
Interdire le clic droit
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
Érreurs classiques
L'ajout par lot ne fonctionne pas comme prévu
Les fichiers semblent corrompus
Ne les renommez pas
Ne les 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
Installation
Téléchargement d'images
Structure des fichiers
Suppression / 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
Option de configuration
Cible de la page
Historique
Nouvelles fonctions
Pas à pas
Basic.sql
Update.sql
Admin.inc.php
Fichier langue
Documentation
A faire
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
Mise à jour
Public visé
Fonctionnalité cachée
Variables & constantes
Système des variables globales
Constantes de Coppermine
Vérificateur de version
Fonctionnalité cachée
Structure XML
Liste des choses à faire