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

# 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 réglez "l'encodage des caractères" en "Unicode (utf-8)" alors, le script détectera automatiquement la langue préférée de vos visiteurs en fonction du langage qui est configuré par défaut dans leur navigateur. Si la langue correspondante est disponible dans votre répertoire de langue, elle sera utilisée. Sinon, le fichier de langue par défaut sera utilisé.

Lorsque le script détecte automatique 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 forcer le script à faire une nouvelle auto-détection), l'utilisateur doit appeler cette fonction d'auto-détection avec quelque chose comme: `http://votresite.fr/coppermine_dir/index.php?lang=xxx`

L’utilisation de l'UTF-8 (Unicode) est fortement recommandé- en faite, il est presque obligatoire. Nous (les membres de l’équipe de développement de Coppermine) pouvons difficilement voir une raison valable pour changer les paramètres d'encodage lors d'une nouvelle installation - La fonction qui vous permet de changer l'encodage dans la page de configuration existe essentiellement pour des raisons historiques et pour la compatibilité descendante (pour les utilisateurs qui ont commencé avec Coppermine il y a longtemps et qui ont besoin de maintenir le contenu de leur base de données en non unicode).

C'est pourquoi la documentation que nous mettons à disposition explique uniquement comment gérer les langues en utilisant l'encodage UTF-8 par défaut. Si vous décidiez d'utiliser un autre encodage, vous feriez quelque chose qui n'aurait pas vraiment de sens et qui par conséquence n'obtiendriez pas d'aide n’y de conseils.

En résumé: ne changez pas l'encodage UTF-8 dans Coppermine vers autre chose sans vraiment, vraiment 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 ou êtes prêts à commencer une traduction, s'il vous plaît lisez le guide du traducteur et suivez les instructions et explications. Traduire complètement Coppermine dans une autre langue est assez simple - Vous n'avez pas besoin d'être un programmeur qualifié (en fait, vous n'avez pas besoin d'être un programmeur 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 (bien entendu à condition qu’un fichier de langue pour cette langue soit disponible).

Si aucune préférence linguistique n’a été définie, Coppermine détecte 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ée dans la configuration de Coppermine). Si la langue du navigateur est (par exemple) en anglais, la galerie s'affiche 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 du paramètre de la langue d’affichage suit un processus en trois étapes:

- 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 opérées par Coppermine feront que la galerie sera affichée dans son langage. Généralement, vous n'avez pas à fournir de sélecteur 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énèrera un cookie du côté client. Vous (en tant qu'administrateur de Coppermine) 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.fr/votre_dossier_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.fr/votre_dossier_coppermine/?lang=xxx`, langue inexistant (vous pouvez aussi utiliser littéralement "xxx").

Si "auto-détection de la langue" a été désactivée dans la configuration de Coppermine, le script n'essayera pas de vérifier la langue 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 par 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 le 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é de leurs 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 sans crainte votre logiciel FTP et effacer les fichiers langues inutiles du répertoire "lang" (`http://votresite.fr/votre_dossier_coppermine/lang/`). Mais dans tous les cas, il est indispensable de laisser 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écanisme 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ées (ex. Le nom des catégories que vous avez défini ou les informations sur les images). Coppermine n'est donc pas complètement multilingue: il n'y a actuellement pas d'options pour avoir le contenu de Coppermine dans plus d'une langue.

## Le gestionnaire de langue

A partir de cpg1.5.x Coppermine est livré avec un gestionnaire de la langue que vous pouvez utiliser pour affiner vos préférences linguistiques. Ce qu’un gestionnaire de langue est essentiellement c’est l'ajout d'une interface de tous les fichiers de langue qui se trouvent dans le dossier `lang`. Pour accéder au gestionnaire de la langue, allez à la page de configuration de Coppermine, développez la section "Paramètres de la langue & jeu de caractères" et cliquez sur le lien nommé "Gérer les langues". Alternativement, vous pouvez entrer manuellement l'URL `http://votresite.fr/votre_dossier_coppermine/langmgr.php` dans la barre d'adresse de votre navigateur.

### Contrôles

Utilisez les boutons "Montrer les détails" / "Cacher les détails" en haut et le bas de la page pour basculer l'affichage du gestionnaire de la langue entre une vision condensée (où seules les données importantes sont affiché) et une vue avancée (là où des informations supplémentaires peuvent être trouvées).
Utilisez le bouton OK au bas de l'écran pour enregistrer les modifications.

### Colonnes

Le gestionnaire de langue affiche un tableau avec plusieurs colonnes. Ces colonnes ont la signification suivante:

- #### Défaut

  Spécifiez la langue par défaut de votre galerie, l’enregistrement est identique à celui que vous pouvez choisir dans le panneau de configuration en utilisant l'option "Langue par défaut".
  Vous ne pouvez choisir les langues qui sont activés en premier lieu. Ceux qui ne sont pas activés seront grisés.
  La langue par défaut sera celle qui est utilisé si la langue préférée du visiteur ne pouvait pas être détecté ou si la langue préférée du visiteur n'existe pas en tant que tel dans le fichier de langue de Coppermine.

- #### Nom de la langue

  La colonne "Nom de la langue" se compose de trois sous-colonnes. Chacune de ces colonnes contient un champ de texte où vous pouvez changer la valeur par défaut.

  - ##### Anglais

    Le nom de la langue en anglais. Il est recommandé de ne pas modifier l’enregistrement.

  - ##### Original

    Le nom de la langue dans la langue maternelle, c'est à dire le mot "français" qui signifie "français" en français

  - ##### Personnalisé

    Si votre langue ou la langue de la majorité de vos visiteurs sont d'une autre langue que l'anglais et que vous avez un sélecteur de langue en place, vous pouvez spécifier les noms des langues dans votre langue.
    Exemple
    Ceci est un exemple possible si votre galerie est pour un public allemand, avec les noms des langues en allemand qui sont entré dans le champ personnalisé:

    Anglais | Original | Personnalisé
    Bulgarian | Български | Bulgarisch
    Czech | Česky | Tschechisch
    English (US) | English (US) | Englisch
    Finnish | Suomea | Finnisch
    French | Français | Französisch
    German (informal) | Deutsch (Du) | Deutsch
    Greek | Ελληνικά | Griechisch
    Polish | Polski | Polnisch
    Russian | Русский | Russisch

    Si un texte est entré dans la colonne "Personnalisé", il sera prédominant sur les colonnes pré-remplis.

- #### Drapeau

  La colonne drapeau contient une liste déroulante où vous pouvez spécifier un autre drapeau que vous souhaiteriez utiliser pour représenter votre langue. L'icône de drapeau que vous choisissez sera applicable uniquement si vous activez un sélecteur de langue dans votre thème personnalisé (ce qui n'est pas recommandée et est désactivé par défaut). Habituellement, le drapeau peut être laissé, s’il y a une corrélation claire entre votre pays et votre langue.
  Prenez l'Allemand comme un exemple: le drapeau de l'Allemagne correspond à l'Allemand par défaut, mais bien sûr, l'Allemand est parlé dans d'autres pays également, par exemple, en Autriche et en Suisse. Donc, si vous êtes en provenance d'Autriche et avez un sélecteur de langue sur votre page, vous pouvez changer le drapeau représentant l’Allemand de l'Allemagne part l'Autriche.

- #### Fichier langue

  Il existe deux sous-colonnes dans la colonne fichier langue:

  - ##### Disponible

    Comme la plupart des autres paramètres de Coppermine, les préférences de langue sont stockées dans la base de données ainsi.
    - S'il y a seulement un enregistrement dans la base de données pour une langue particulière, mais que le fichier de langue correspondant n'est pas là, il y aura un icône stop dans cette colonne.
    - S’il y a la fois un enregistrement dans la base de données ainsi que d'un fichier de langue, l’icône OK sera affiché.
    - S'il existe un fichier de langue, mais que jusqu'ici il n'y a pas eu d’enregistrement dans la base de données de ce fichier, un icône plus sera affiché. Soumettez le formulaire pour créer un enregistrement dans la base de données
    Vous ne pouvez activer une langue que si le fichier langue correspondant existe.

  - ##### Complet

    La colonne "Complet" est le résultat d'une vérification détaillée de chaque fichier:
    - Si le fichier de langue a été conçu pour votre version de Coppermine, un icône OK sera affiché dans cette colonne.
    - Autrement, si votre fichier de langue a été conçu pour une version précédente de Coppermine, l'icône annuler s'affiche à la place. Cela ne signifie pas nécessairement que vous ne pouvez pas utiliser un fichier particulier - traductions manquantes (le cas échéant) fonctionnera en anglais à la place.

- #### Activé

  C'est la colonne la plus importante de la totalité de l'écran: ici, vous déterminer si une langue particulière sera prise en compte, si la langue peut être utilisée par les visiteurs. Ceci est indépendant de l'existence d'un sélecteur de langue: si une langue donnée n'est pas activé, c'est comme si le fichier de langue n'existait pas en premier lieu.