« Personnalisation de la langue » : différence entre les versions

De MoodleDocs
Aller à :navigation, rechercher
(Légères corrections)
Ligne 27 : Ligne 27 :
# Apportez vos modifications dans la zone "Modification locale".
# Apportez vos modifications dans la zone "Modification locale".
# Cliquez sur ''Enregistrer et continuer les modifications'' si vous souhaitez utiliser un autre filtre ou modifier un ou plusieurs fichiers ; sinon cliquez sur ''Enregistrer les modifications dans le paquetage de langue'' pour enregistrer toutes les modifications que vous avez apportées.
# Cliquez sur ''Enregistrer et continuer les modifications'' si vous souhaitez utiliser un autre filtre ou modifier un ou plusieurs fichiers ; sinon cliquez sur ''Enregistrer les modifications dans le paquetage de langue'' pour enregistrer toutes les modifications que vous avez apportées.
=== Importation et exportation des personnalisations de la langue ===
{{Moodle 3.10}}
Des chaînes de caractères personnalisées peuvent être importées, et, pour autant que la capacité tool/customlang:export soit autorisée pour l'utilisateur, exportées depuis ''Administration du site > Langue > Personnalisation de la langue''.


==Recherche du composant et de l'identificateur de chaîne==
==Recherche du composant et de l'identificateur de chaîne==

Version du 11 novembre 2020 à 09:23

Les mots ou phrases utilisées sur Moodle peuvent être facilement modifiées par un administrateur à l'aide de la fonctionnalité de Personnalisation de la langue. Par exemple, on peut changer le mot « Cours » par « Période » (ou une autre expression).

Instructions rapides pour les impatients

  1. Ouvrir la page Administration > Administration du site > Langue > Personnalisation de la langue.
  2. Sélectionner la langue à modifier dans le menu déroulant.
  3. Cliquer sur le bouton « Ouvrir le paquetage de langue pour modification » et patienter, car cela peut prendre un peu de temps. Cliquer sur « Continuer ».
  4. Sélectionner un ou des fichiers dans l'interface de filtrage des chaînes. Les fichiers sont groupés. On trouve par exemple les fichiers de l'activité Leçon dans « mod » et le fichier moodle.php sous « core ».
  5. Une fois un ou des fichiers sélectionnés, il est possible d'affiner la sélection des chaînes à l'aide d'autres filtres, par exemple « Chaînes contenant ». Cliquer sur « Afficher les chaînes ».
  6. Saisir dans l'interface le texte destiné à remplacer le terme standard. Pour référence, l'original en anglais est également affiché.
  7. Cliquer sur « Enregistrer et continuer les modifications » si vous voulez modifier des chaînes d'autres fichiers.
  8. Cliquer sur « Enregistrer les modifications dans le paquetage de langue » pour enregistrer toutes les modifications effectuées.
Astuce : vous ne voyez pas vos chaînes modifiées ? Avez-vous bien cliqué pour terminer sur le bouton « Enregistrer les chaînes dans le paquetage de langue »? Avez-vous actualisé l'affichage de votre navigateur ? Avez-vous bien modifié la chaîne utilisée dans ce cours ?
Astuce : impossible de trouver la chaîne que vous voulez modifier ? Cochez la case « Afficher l'origine des chaînes de caractères » dans Administration > Administration du site > Développement > Débogage, puis visitez la page contenant la chaîne que vous voulez modifier en ajoutant « &strings=1 » ou « ?strings=1 » à la fin de l'URL de la page, par exemple : http://monmoodle.fr/course/index.php?strings=1 ou http://monmoodle.fr/course/view.php?id=4&strings=1. Attention : cela ne fonctionne que lorsque l'on est connecté en tant qu'administrateur !

Changer les mots ou les phrases

Les mots ou expressions (de n'importe quelle langue) utilisés sur le site peuvent être facilement modifiés par un administrateur à l'aide de la fonction de personnalisation de la langue. Par exemple, vous souhaiterez peut-être remplacer le mot Cours par Unité.

  1. Allez sur Administration du site > Langue > Personnalisation de la langue et choisissez la langue que vous souhaitez personnaliser.
  2. Cliquez sur le bouton Ouvrir le paquetage de langue pour modification. (Cela peut prendre un peu de temps à traiter)
  3. Une fois le paquetage de langue chargé, cliquez sur le bouton Continuer.
  4. Recherchez la chaîne que vous souhaitez personnaliser à l'aide des paramètres de filtre, puis cliquez sur Afficher les chaînes. Voir ci-dessous pour savoir comment trouver l'identificateur de composant et de chaîne.
  5. Apportez vos modifications dans la zone "Modification locale".
  6. Cliquez sur Enregistrer et continuer les modifications si vous souhaitez utiliser un autre filtre ou modifier un ou plusieurs fichiers ; sinon cliquez sur Enregistrer les modifications dans le paquetage de langue pour enregistrer toutes les modifications que vous avez apportées.

Importation et exportation des personnalisations de la langue

Nouveauté
Moodle
3.10


Des chaînes de caractères personnalisées peuvent être importées, et, pour autant que la capacité tool/customlang:export soit autorisée pour l'utilisateur, exportées depuis Administration du site > Langue > Personnalisation de la langue.

Recherche du composant et de l'identificateur de chaîne

  • Nous allons utiliser un exemple où l'utilisateur souhaite remplacer 'Cours' par 'Évaluations' dans le tableau de bord du thème Boost.
Ceci est le texte à changer
  • Aller à Administration du site > Développement > Débogage.
  • Cocher la case Afficher l'origine des chaînes de caractères puis enregistrer les modifications.
  • À la page contenant la chaîne que vous souhaitez personnaliser et dans la barre d'adresse, ajouter ce qui suit à l'URL : soit
    ?strings=1
    ou
    &strings=1
    (s'il existe déjà un autre paramètre).
  • Recharger la page.

Ce sont les chaînes que nous devons changer

  • La page sera ensuite affichée avec composant et chaîne identifiée entre accolades après chaque chaîne, par exemple "{nocourses/block_myoverview}". La première partie, avant le /, est l'identifiant de la chaîne. La dernière partie est la composante, par exemple block_myoverview.php. S'il n'y a rien après le / (par exemple, {cours/}), la chaîne est dans moodle.php.
  • Vous utiliserez ensuite ces informations pour personnaliser vos chaînes de langue.

Utiliser les informations obtenues pour changer les chaînes souhaitées

  1. Aller sur Administration du site > Langue > Personnalisation de la langue
  2. Choisir le paquetage de langue Français (fr)
  3. Ouvrir le paquetage de langue pour modification
  4. Cliquer sur le bouton Continuer
  5. Sélectionner le composant moodle.php (dans ce cas particulier)
  6. Taper "cours" comme identifiant de chaîne (dans ce cas)
  7. Cliquer sur le bouton "Afficher les chaînes"
  8. Saisir la chaîne personnalisée, en remplaçant le texte standard 'Cours' par 'Évaluations'

Nous allons remplacer 'cours' par 'évaluations'

  • Après avoir enregistré les modifications dans le paquetage de langue, vous pouvez vérifier que vous avez atteint la modification souhaitée :

Nous avons remplacé 'Cours' par 'Évaluations'

  • N'oubliez pas de toujours vérifier que vous n'avez modifié que les chaînes prévues aux endroits prévus.
  • Répétez la procédure avec toutes les chaînes que vous souhaitez modifier (par exemple, cours, pas de cours...)
  • Effacer les caches de chaîne langue en allant sur Administration du site > Développement > Purger les caches.

Paramètres de filtrage

Filtre de langue
  • Afficher les chaînes de ces composants - Cliquer ou Ctrl + clic pour sélectionner un ou plusieurs fichiers.
  • Chaînes personnalisées seulement - Cocher la case pour afficher uniquement les chaînes déjà présentes dans votre paquetage xx_local.
  • Chaînes d'aide seulement - Cocher la case pour afficher uniquement les chaînes d'aide, c'est-à-dire les textes utilisés lorsque vous cliquez sur l'icône en point d'interrogation.
  • Chaînes modifiées seulement - Cocher la case pour afficher uniquement les chaînes modifiées depuis la dernière chaîne archivée dans le paquetage de langue.
  • Chaînes contenant - Insérer une phrase qui doit apparaître dans la chaîne. Par exemple, si vous mettez un mot 'étudiant' ici, vous n'obtiendrez que les chaînes contenant ce mot.
  • Identifiant de la chaîne - Voir ci-dessus.

Personnalisation locale en surbrillance

  • Les chaînes personnalisées (déjà enregistrées dans un fichier) sont surlignées en vert.
  • Les chaînes modifiées (non encore enregistrées dans un fichier) sont surlignées en bleu.
  • Les chaînes personnalisées à supprimer sont surlignées en rouge.

En savoir plus sur les paquetages de langue

Moodle est traduit dans de nombreuses langues - voir Paquetages de langue pour leur liste et l'état d'achèvement de la traduction. Les traductions sont distribuées sous forme de paquetages de langue gérés par de gentils volontaires, des contributeurs communautaires et des partenaires Moodle.

Les administrateurs de site Moodle peuvent personnaliser n'importe quel paquetage de langue en fonction de leurs besoins. La modification directe des fichiers du paquetage de langue n'est pas recommandée, car toutes les modifications seraient écrasées de manière silencieuse lors de la prochaine mise à jour des langues (par défaut, chaque nuit). Utiliser plutôt la fonction de personnalisation de la langue, qui crée automatiquement un paquetage de langue local contenant toutes les modifications du paquetage officiel.

Les paquetages de langues locaux ont la même structure que les paquetages officiels. Ils sont enregistrés dans votre répertoire de données Moodle dans le dossier moodledata/lang/xx_local/ où 'xx' est le code de la langue. Vous devez avoir installé le paquetage de langue officielle avant de pouvoir le personnaliser. Un paquetage de langue local doit contenir uniquement les chaînes que vous avez personnalisées. Il n'est pas nécessaire de créer une copie de l'ensemble du paquetage de langue officiel.

Lors de l'affichage d'une chaîne, Moodle commence par rechercher s'il existe une personnalisation locale dans moodledata/lang/xx_local/component_file.php. Si c'est le cas, il est utilisé. Sinon, la chaîne du paquetage de langue officiel est utilisée. (Si la chaîne n'a pas encore été traduite, la version originale anglaise est affichée). Notez que les chaînes sont mises en cache pour améliorer les performances. Par conséquent, si vous modifiez un fichier directement dans votre paquetage xx_local, vous devrez ensuite purger les caches Moodle. Les caches sont purgés automatiquement lors de l'utilisation de la fonction de personnalisation de la langue.

Flux de travail de la personnalisation de la langue (cliquez pour agrandir)


Comment sauvegarder et restaurer un paquetage de langue personnalisé

Cela s'avère pratique lorsque vous avez personnalisé votre paquetage de langue et que vous souhaitez installer ces modifications sur un autre serveur.

Si vous avez personnalisé un paquetage de langue xx, le seul dossier que vous devez sauvegarder est $CFG->dataroot/lang/xx_local. Tous les autres sans le suffixe _local sont des paquetages standard qui peuvent être installés et désinstallés via l'outil d'administration.

Une fois le dossier restauré sur un autre serveur, vous devrez purger manuellement les caches de l'interface d'administration pour permettre au gestionnaire de chaînes intégré de relire les dossiers *_local et de commencer à les utiliser.

Partage d'une personnalisation linguistique

  • Si vous avez créé une personnalisation de la langue pour un besoin spécifique, partagée par d'autres personnes (par exemple, une version pour enfants de votre langue nationale, destinée à votre école, mais également utile à d'autres écoles), envisagez de la partager en tant que langue enfant dans AMOS.
  • Si votre pays utilise une langue qui n'est pas exactement la même que celle d'un paquetage de langue existant répertorié dans les crédits de traduction, et que vous avez créé une personnalisation mieux adaptée aux besoins des utilisateurs de Moodle dans votre pays, vous pouvez envisager de démarrer un paquetage de langue enfant dans AMOS. (par exemple, le français canadien, qui contient plus de 1 000 modifications par rapport au paquetage de langue français standard).

Dans les deux cas, contactez le responsable du paquetage de langue parent indiqué dans les crédits de traduction et/ou le coordinateur des traductions de Moodle, Koen, translation@moodle.org.

Dépannage

Erreur de base de données

Database error while language customization.png Si vous rencontrez une erreur de base de données lorsque vous essayez de personnaliser un paquetage de langue, cela peut être dû à un plugin récent qui corrompt la base de données. Nous vous conseillons de vérifier tous les plugins récemment ajoutés à votre site et vérifier si la suppression d'un plugin évite cette erreur. Si tel est le cas, veuillez contacter le responsable du plugin impliqué et signalez l'erreur. La plupart des cas observés en 2013 ont été corrigés par les responsables de ces plugins. Un cas vu en 2014 était lié au thème (additionnel) Essential et les paquetages de langues autres que l'anglais ; il a été dû à un bogue avec la manipulation de langue de notification et a été corrigé avec une mise à jour du plugin.

Ou, vous pouvez lancer une requête de base de données sur votre serveur afin de localiser le plugin à l'origine du problème.

Changer la taille de la police et la couleur d'une chaîne de langue

Vous pouvez utiliser la personnalisation de la langue pour modifier la taille et la couleur de la police de toutes les chaînes Moodle (cœur ou plugin additionnel).

Voir l'exemple suivant tiré d'un forum espagnol, où l'utilisateur souhaite avoir un grand texte distinct de couleur rouge pour l'invite 'Répondez aux questions...' dans l'activité Feedback :

Language customization changing font size and colour.png

Vous pouvez également ajouter une image à une chaîne de langue personnalisée, comme dans cet article du forum (en anglais).

Personnalisation des chaînes de langue Moodle Mobile

Voir Chaînes de langue personnalisées dans le guide Moodle Mobile pour les administrateurs.

Voir aussi

Des questions ?

Merci de poster sur le forum Moodle en français sur moodle.org.