Aller au contenu

Personnaliser les textes du panneau ​

Vous pouvez remplacer n'importe quel texte du panneau, des pages d'erreur et de test, et des fenêtres de connexion, sans modifier l'application. Par exemple pour indiquer le numéro de votre support dans un message d'erreur.

Mettre en place ​

  1. Créez un dossier pour vos textes, par exemple translations/ dans le dossier de l'application.

  2. Indiquez-le dans le .env :

    ini
    TRANSLATIONS_OVERRIDE_DIR=translations

    Avec Docker, montez le dossier dans le conteneur (ligne prévue en commentaire dans docker-compose.yml) et indiquez /app/translations.

  3. Dans ce dossier, créez un fichier par langue à modifier : fr.json, en.json, de.json ou it.json, tous facultatifs. Chacun ne contient que les textes à remplacer, avec la même structure que les fichiers de l'application (public/locales/<langue>.json) :

    json
    {
        "common": { "welcome": "Bienvenue dans\nSave2ERP Acme" },
        "errorMessage": {
            "systemUnavailable": { "action": "Contactez le support SAP au 021 123 45 67." }
        }
    }
  4. Redémarrez le serveur. Les logs indiquent le nombre de textes remplacés.

Règles ​

  • Ne recopiez pas un fichier entier : les autres textes restent ceux de l'application et suivent ainsi ses mises à jour.
  • Une erreur dans un fichier n'empêche jamais le démarrage : le texte concerné est ignoré et signalé dans les logs. C'est le cas d'un JSON invalide, d'une langue non disponible, d'une clé inconnue (faute de frappe, ou texte supprimé dans une nouvelle version).
  • Gardez les valeurs entre accolades (, …) : sans elles, la valeur ne serait pas affichée. Le serveur le signale dans les logs.
  • Après une mise à jour de Save2ERP, relisez les logs : un texte dont la clé a changé y est signalé.

Ce qui ne peut pas être modifié ​

  • Les textes du manifeste (nom du complément, bouton du ruban et son infobulle) : ils sont dans le manifeste remis par Swiss Computing.
  • Les messages renvoyés par le système cible, affichés tels quels.

Les textes personnalisés restent sous votre responsabilité : en particulier, ils ne doivent pas présenter le complément comme un produit de l'éditeur du système cible.