📍 Où trouver ce module ?
Paramètres > Gestion des modules > Langues et traductions
Introduction #
Kafinea est une application multilingue. L’interface, les libellés de champs et les menus peuvent être affichés dans différentes langues. La gestion des langues est accessible via Paramétrage > Langues et traductions.
Deux écrans travaillent ensemble :
- Langues : la liste des langues installées sur votre instance (français, anglais, etc.).
- Traductions : la liste de tous les textes affichés par l’application, langue par langue. C’est ici que vous adaptez le vocabulaire à votre métier.
1. Langues disponibles #
Kafinea est livré avec le français et l’anglais. D’autres langues peuvent être ajoutées selon les besoins. Chaque utilisateur choisit sa langue d’affichage dans ses préférences utilisateur.
2. Personnaliser un libellé #
Exemple : dans les comptes, afficher « Secteur d’activité » à la place de « Secteur ».
Raccourci : depuis l’éditeur de mise en page d’un module, le bouton Renommer un libellé de champ ? rappelle la procédure et ouvre directement la liste des traductions.
- Ouvrez Paramétrage > Langues et traductions > Traductions.
- Filtrez la liste sur la langue concernée (par exemple le français).
- Recherchez le libellé, soit dans la colonne Texte original (le libellé livré par Kafinea), soit dans la colonne Traduction (le texte actuellement affiché).
- Repérez la ligne dont la colonne Module correspond au module que vous voulez modifier.
- Modifiez la colonne Traduction et enregistrez.
La nouvelle traduction est appliquée dès l’enregistrement. Rechargez la page sur laquelle le libellé apparaît pour la voir.
Bon à savoir : une personnalisation s’applique à tous les utilisateurs qui utilisent la langue concernée. Si vous avez des utilisateurs en anglais, faites la même adaptation dans la langue anglaise.
3. Choisir la portée : un module ou toute l’application #
La colonne Module détermine où le nouveau libellé s’applique.
- Une ligne rattachée à un module ne change le libellé que dans ce module.
- Une ligne du module commun change le libellé partout où il apparaît, dans tous les modules.
Certains libellés très génériques, comme « Description » ou « Assigné à », sont partagés par de nombreux modules et n’existent que sur le module commun. Si vous modifiez cette ligne, tous les modules qui l’utilisent sont renommés en même temps.
Pour ne renommer un libellé que dans un seul module :
- Dans la liste Traductions, ouvrez une ligne existante du module visé (n’importe laquelle) et utilisez l’action Dupliquer : le nom technique du module est ainsi recopié sans risque d’erreur de saisie.
- Sur la copie, renseignez :
- Clé de traduction et Texte original : recopiez exactement les valeurs de la ligne du module commun que vous voulez surcharger.
- Contexte :
backendpour un libellé de champ, de vue liste ou de document imprimé. - Traduction : le libellé que vous souhaitez afficher.
- Enregistrez. Le module visé utilise désormais votre libellé, les autres modules conservent le libellé d’origine.
Vous pouvez aussi créer la ligne directement avec le bouton Ajouter, à condition de saisir le nom technique du module exactement comme il apparaît dans la colonne Module des autres lignes.
Bon à savoir : une ligne que vous créez vous appartient. Les mises à jour de Kafinea ne la modifient pas et ne la suppriment pas, et vous pouvez la supprimer à tout moment pour revenir au libellé d’origine.
4. Comprendre les colonnes de la liste #
Une bulle d’aide est disponible sur chaque champ de la fiche d’une traduction. En résumé :
| Colonne | À quoi elle sert |
|---|---|
| Langue | La langue dans laquelle le texte s’affiche. |
| Module | La portée du libellé, voir la section 3. |
| Dossier | Le sous-dossier d’où provient le libellé : vide pour l’application, « Settings » pour les écrans de paramétrage. Un même libellé peut exister dans les deux avec deux textes différents ; cette colonne indique lequel vous modifiez. Conservez la valeur telle quelle lorsque vous dupliquez une ligne. |
| Contexte | backend pour un texte affiché par le serveur (champ, vue liste, document imprimé), frontend pour un message affiché par le navigateur (notification, message de validation). |
| Clé de traduction | L’identifiant technique du libellé. À recopier exactement lorsque vous surchargez une ligne. |
| Texte original | Le libellé livré par Kafinea pour cette langue, avant toute personnalisation. Il sert de référence pour revenir au libellé standard. |
| Traduction | Le texte réellement affiché : c’est la seule colonne à modifier au quotidien. |
| Note | Un commentaire libre à l’usage de vos traducteurs (contrainte de longueur, contexte d’affichage, choix de vocabulaire). Ce texte n’est jamais affiché aux utilisateurs. |
| Livré par Kafinea | Renseigné automatiquement. Oui : la ligne provient des fichiers de langue de Kafinea ; elle n’est pas supprimable et son texte d’origine peut évoluer avec une nouvelle version. Non : la ligne a été créée sur votre instance ; elle est conservée telle quelle lors des mises à jour et supprimable à tout moment. |
| Libellé retiré du produit | Renseigné automatiquement. Oui : ce libellé n’existe plus dans Kafinea. La ligne est conservée pour ne pas perdre votre personnalisation, mais elle n’a plus d’effet et peut être supprimée. |
5. Traduction des listes de valeurs #
Les listes de valeurs (listes déroulantes) peuvent également être traduites. Cela permet d’afficher les valeurs dans la langue de chaque utilisateur tout en conservant une valeur technique unique en base de données.
6. Questions fréquentes #
La modification est-elle immédiate ?
Oui. La traduction est appliquée dès l’enregistrement de la ligne. Rechargez simplement la page concernée pour voir le nouveau libellé.
La langue affecte-t-elle les documents PDF ?
Les documents PDF (factures, devis) utilisent les traductions de la langue configurée pour la génération du document, qui peut différer de la langue de l’interface utilisateur.
Je ne trouve pas de ligne pour le module qui m’intéresse.
C’est le cas des libellés génériques, définis une seule fois sur le module commun. Créez la ligne pour votre module en suivant la section 3.
Puis-je ajouter une nouvelle langue ?
Oui, de nouvelles langues peuvent être ajoutées. Cela nécessite la création des fichiers de traduction correspondants. Contactez votre administrateur ou l’équipe Kafinea pour cette opération.
Les traductions personnalisées sont-elles conservées lors des mises à jour ?
Oui, les personnalisations sont stockées séparément et sont conservées lors des mises à jour de Kafinea.
Comment revenir au libellé d’origine ?
Sur une ligne que vous avez créée, supprimez la ligne. Sur une ligne standard, recopiez dans la colonne Traduction la valeur affichée dans la colonne Texte original.