# Coppermine Photo Gallery v1.5.x: Documentation and Manual

# Langues

Coppermine possède un fichier langue séparé ce qui rends la traduction du script beaucoup plus facile. Les fichiers langues sont stockés dans le répertoire lang . Les fichiers sont encodés en Unicode (utf-8).

Si vous sélectionnez Unicode (utf-8) comme encodage par défaut dans la configuration de Coppermine, le script sera capable de sélectionner automatiquement le fichier langue correspondant à la langue configurée dans le navigateur du visiteur. Si la langue sélectionnée est disponible dans votre répertoire "lang", elle sera utilisée. Sinon, c'est le fichier langue par défaut qui sera utilisé.

Si le script détecte automatiquement la langue préférée, il stocke le résultat dans un cookie sur l'ordinateur du visiteur. Pour réinitialiser ce Cookie (et donc pour forcer le script à une nouvelle auto-détection) l'utilisateur doit appeler cette fonction d'auto-détection avec quelque chose comme: `http://votresite.com/coppermine_dir/index.php?lang=xxx`

L'utilisation d'utf-8 (unicode) est fortement recommandé - en fait, c'est pratiquement obligatoire. Nous (les membres de l'équipe de développement) pouvons difficilement voir une raison valable pour changer les paramètres d'encodage lors d'une nouvelle installation - La fonction permettant de changer l'encodage dans la page de configuration existe pour des raisons historiques et pourune compatibilité ascendante (pour les utilisateurs qui ont démaré avec Coppermine il y a longtemps et qui doivent maintenir le contenu de leur base de donnée non unicode).

C'est pourquoi la documentation que nous mettons à disposition explique uniquement comment gérer les langues en utilisant l'encodage utf8 par défaut. Si vous décidiez d'utiliser un autre encodage, vous seriez en train de faire quelque chose qui n'a pas vraiment de sens et qui par concéquent n'obtiendra pas d'aide et de conseils.

EN résumé: Ne changez pas l'encodage dans Coppermine de utf-8 vers autre chose sans vraiment, vraiement savoir ce que vous faites et comprenez que cette décision impliquera que vous n'obtiendrez aucune aide pour les problèmes concernant l'utilisation et la gestion des langues.

Si vous avez traduit Coppermine dans une langue qui n'est pas encore disponible, merci de lire le guide de traduction et visitez le Site Web de Coppermine et suivez les instructions et explications données. Traduire Coppermine dans une autre langue ets en fait assez simple - vous n'avez pas besoin d'avoir des connaissances en programmation (en fait vous n'aurez pas à programmer du tout).

## Comment fonctionne le système de langues dans Coppermine

Voici comment Coppermine détermine la langue de l'utilisateur: Lors de l'accès, coppermine vérifie si l'utilisateur à expressément défini une préférence pour la langue (cette préférence est stockée dans un cookie du côté client). Si une langue est définie, Coppermine est affiché dans cette langue.

Si aucune préférence n'a été définie, coppermine detecte la langue que l'utilisateur à défini dans le paramétrage de son navigateur web.(si l'encodage est paramétré sur utf-8 et l'option "Détection Automatique de la langue" est activé dans la configuration de Coppermine. Si la langue du navigateur est (par exemple) Anglais, Coppermine sera affiché en Anglais. Si la langue du navigateur est paramétrée sur Hindi (par exemple), du fait qu'il n'y a pas de fichier langue disponible pour cette langue en particulier dans Coppermine, alors le script utilisera la langue par défaut que vous aurez défini dans la configuration de Coppermine.

Comme vous pouvez le voir, la détermination de la définition des paramètres de la langue d'affichage suit un processus en trois points:

- Préférence et choix de l'utilisateur (cookie)
- Paramétrage du navigateur
- Paramétrage de la configuration de Coppermine

Ce processus en trois étapes est très pratique: en fait, vous définissez une langue par défaut dans la configuration de Coppermine (généralement la langue parlée par la majorité de vos visiteurs) et c'est tout: si un visiteur parlant une autre langue arrive sur votre galerie, les vérifications oppérées par Coppermine feront que la galerie sera affichée dans son language. Généralement, vous n'avez pas à fournir de sélécteur de langue sur votre page (mais il y a une option dans la configuration de Coppermine pour l'afficher si vous le préférez). Le sélecteur de langue ne fait qu'ajouter un paramètre à l'adresse URL, qui génerera un cookie su côté client. Vous (en tant qu'administrateur de Coppemrine) pouvez faire la même chose en ajoutant manuellement le paramètre à l'URL dans la barre d'adresse de votre navigateur. Observez comment l'URL change dans votre galerie Coppermine si vous avez activé le sélecteur de langue dans la configuration pour vous faire une idée de la manière dont cela fonctionne.

Si votre navigateur est paramétré sur Français et que vous avez spécifié Espagnol comme langue par défaut(remplacement), votre galerie s'affichera pour vous en Français. Pour la voir en Anglais, ajoutez le paramètre `lang=english` à l'URL de votre galerie dans la barre d'adresse de votre navigateur, de sorte que cela ressemble à ça: `http://votresite.com/votre_repertoire_coppermine/?lang=english`. En faisant ainsi, vous spécifiez une préférence de langue qui sera stockée dans un cookie qui prendra la main sur la détection de votre langue préférée paramétrée dans votre navigateur. Pour revenir au paramétrage précédent, videz simplement le cookie qui stocke vos préférences en entrant `http://votresite.com/votre_repertoire_coppermine/?lang=xxx`, ou "xxx" est un nom de langue innexistant (pous pouvez qussi utiliser lirérallement "xxx").

Si "l'auti-détection de la langue" a été désctivée dans la configuration de Coppermine, le script n'essayera pas de vérifier la alngue du navigateur. Il affichera la galerie dans la langue définie par l'administrateur comme langue par défaut. La seule chose qui va l'emporter sur la langue par défaut est une sélection explicite de l'utilisateur final, c'est-à-dire si l'administrateur du site choisi d'afficher un sélecteur de langue (en utilisant une liste déroulante ou une liste de drapeau) et que le visiteur a délibérément choisi une langue de cette liste.

### Se débarrasser d'une langue particulière

Il y a beaucoup de langues disponibles livrées avec Coppermine, et l nombre de fichiers langue augmente, du fait de contributions constantes venant de la communauté Coppermine. Le résultat est que Coppermine est livré avec une très grande quantité de fichiers langue que vous pouvez utiliser. La plupart des utilisateurs n'auront pas conscience de cela, la majorité deleurs visiteurs ne venant que de leur pays. De ce fait, il est possible que vous n'ayez pas besoin d'autant de langues additionnelles. Si c'est le cas pour vous, vous pouvez utiliser ans crainte votre client FTP et effacer les fichiers langues inutils du répertoire "lang" (`http://votresite.com/votre_repertoire_coppermine/lang/`). Mais dans tous les cas, il est indispenssable de laiser le fichier langue Anglaise (English.php).

### Langue de remplacement

De cpg1.3.x à cpg1.4.x il y avait une option de configuration nommée "Remplacer par l'Anglais si la traduction de la phrase n'est pas trouvée ?".

Cette option à été enlevée pour cpg1.5.x et remplacée par un méchanisme de remplacement de langue plus évolué ne nécessitant plus d'être configuré.

### Champ d'application de l'internationalisation

Les fichiers de langue livrés avec Coppermine ne peuvent contenir que des chaînes pré-définies qui composent les contrôles de votre galerie (par exemple les menus). Le passage à une autre langue n'aura aucun impact sur le contenu personnalisé qui se trouve dans la base de donnée (ex. Le nom des catégories que vous évez défini ou les informations sur les images). Coppermine n'est donc pas complêtement multilangue: il n'y a actuellement pas d'options pour avoir le contenu de Coppermine dans plus d'une langue.