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

Table des matières

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:

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: