Questions fréquentes

Réponses aux questions que nous recevons le plus souvent.

Installation et utilisation

J'ai des objets masqués dans ma visualisation - est-ce gênant ? #

Gênant, non - mais cela coûte des traductions inutiles. Simple Locale lit tout ce qui se trouve sous votre arborescence de visualisation, y compris les objets momentanément masqués, et suit les liens jusqu'à leur cible. C'est voulu : la visibilité d'un objet n'est pas un état figé - beaucoup de visualisations affichent et masquent dynamiquement selon une condition, l'heure ou l'utilisateur. Si nous ignorions ce qui est masqué, le texte original non traduit s'afficherait précisément au moment où l'objet apparaît.

Le prix à payer : si vous rangez des scripts, des actions ou de simples variables auxiliaires comme objets masqués dans la visualisation (ou des liens vers ceux-ci), leurs noms et leurs textes sont traduits avec le reste. Cela consomme du quota chez votre fournisseur de traduction et coûte un peu de temps à chaque nouveau scan, pour des contenus que personne ne verra jamais.

Le conseil : faites le premier scan avec une seule langue cible. Parcourez ensuite une fois les tableaux de traduction et excluez tout ce que personne ne lit via la case « Traduction active » (la colonne « Chemin » vous indique où se situe une ligne dans l'arborescence). N'ajoutez les autres langues cibles qu'après : chaque nouvelle langue ne traduira plus que le reste. Les lignes, elles, restent en place : le scan les trouve toujours, elles ne sont simplement plus traduites.

La case fait partie de l'édition Pro (voir la question juste au-dessus). Sans elle, la seule solution est de ranger ces objets auxiliaires en dehors de l'arborescence traduite, dans la mesure où votre visualisation le permet.

Je vois plusieurs entrées vides dans les tableaux de traduction - pourquoi ? #

C'est généralement l'une de trois raisons tout à fait normales, pas un bug : si le contenu surveillé est actuellement vide (par ex. un texte d'indication qui n'affiche quelque chose que sous certaines conditions), la ligne est correctement créée avec un texte source vide - et reste vide dans chaque langue, puisqu'il n'y a rien à traduire. Dès que la variable fournit à nouveau une vraie valeur, toutes les langues se remplissent automatiquement.

Si en revanche une variable surveillée contient des données de configuration/contrôle structurées pour un autre module plutôt qu'un vrai texte affiché (reconnu techniquement comme du JSON valide, par ex. {"musicProvider":"CLOUDPLAYER"}), Simple Locale la laisse volontairement intacte : une traduction automatique réencoderait les guillemets/caractères spéciaux et détruirait ainsi la structure pour le script qui l'exploite.

Si tous les fournisseurs de traduction configurés sont actuellement en pause (quota quotidien épuisé, limite de débit) ou qu'une tentative de traduction a échoué, une cellule jamais encore remplie reste temporairement vide et se remplit automatiquement dès qu'un fournisseur redevient disponible.

Si vous souhaitez au contraire traduire un texte qui n'est pas une variable Symcon dans l'arborescence surveillée - par exemple parce qu'il est généré directement dans le code PHP de votre propre tuile ou de votre propre script -, il n'apparaîtra logiquement jamais dans les tableaux. C'est exactement à cela que sert la commande PHP SLOC_TranslateExternalText(), que vous appelez directement depuis votre propre code - voir la documentation.

Je ne veux pas qu'une variable précise soit traduite, est-ce possible ? #

Oui : chaque ligne des tableaux de traduction analysés (noms d'objets, textes personnalisés, Automatisations, message d'accueil, énumérations, graphiques) possède une case « Traduction active » - désactivez-la pour une ligne et ce texte reste dans la langue d'origine partout, par exemple pour les noms propres, les marques ou les abréviations techniques. Cela n'utilise plus non plus d'appel de traduction.

Fait partie de l'édition Pro (la même colonne de cases que la modification directe des cellules). Une désactivation déjà définie continue de fonctionner même après un downgrade - seule son activation/modification nécessite Pro. Votre propre table de traduction n'est pas concernée, puisque rien n'y est jamais traduit automatiquement.

Je trouve la solution convaincante, y a-t-il des alternatives que je devrais regarder ? #

Le mieux est de vous en convaincre vous-même : notre version d'essai de 30 jours vous permet de tester Simple Locale en profondeur sans aucun engagement - pas de carte bancaire, pas de renouvellement automatique, il vous suffit de l'installer et de voir si cela correspond à votre visualisation.

Oui, il y en a une : Symcon propose sa propre solution avec IP-Symcon Enterprise Localization - n'hésitez pas à la comparer. Nous sommes convaincus par les fonctionnalités et le prix de Simple Locale, mais au final, ce qui compte, c'est ce qui correspond le mieux à votre cas d'usage précis.

Traduction

Combien de traductions un compte gratuit Google ou DeepL couvre-t-il généralement ? #

Le fournisseur gratuit inclus dans toutes les éditions (MyMemory, aucun compte requis) autorise 5 000 caractères par jour, ou 50 000 par jour avec une adresse e-mail de contact renseignée. Comme chaque texte n'est traduit qu'une seule fois puis stocké localement, cela suffit pour de nombreuses installations - mais avec des arborescences plus grandes, plusieurs langues cibles à la fois, ou des "textes personnalisés" changeant fréquemment, la limite journalière peut se faire sentir.

À partir de l'édition Standard, vous pouvez ajouter Google Cloud Translate et/ou DeepL : Google propose actuellement 500 000 caractères par mois gratuitement (de façon récurrente), DeepL 1 000 000 de caractères gratuits sous forme de crédit de départ unique (plus de quota mensuel récurrent) - situation d'août 2026 ; les conditions des fournisseurs peuvent changer, voir leurs pages tarifaires. À ne pas confondre avec le crédit de départ de 300 $ pour 90 jours : celui-ci est une période d'essai unique et expire, tandis que les 500 000 caractères mensuels demeurent.

Le véritable avantage : les fournisseurs se complètent au lieu de se remplacer (voir "Résistant aux pannes" dans Fonctionnalités). Si, par exemple, votre quota unique DeepL est épuisé, Simple Locale continue automatiquement à traduire via Google - et si son quota mensuel vient lui aussi à manquer, le fournisseur gratuit MyMemory prend le relais en dernier recours. Même calculé de manière prudente (le quota gratuit de DeepL est un crédit de départ unique, tandis que celui de Google se renouvelle chaque mois, donc ils ne s'additionnent pas simplement 1 pour 1), combiner les deux fournisseurs vous donne nettement plus de marge qu'un seul fournisseur ou que le fournisseur gratuit seul.

Cela allège aussi votre quota quotidien : pour les « textes personnalisés » qui changent fréquemment, le cache intégré (voir « Retraduction automatique lors de modifications externes » sous Fonctionnalités) ne retraduit que les valeurs réellement modifiées au lieu de tout redemander à chaque mise à jour - ce qui économise généralement plus de 80 % des appels de traduction qui seraient sinon nécessaires, préservant ainsi encore davantage votre quota quotidien.

Google indique que ma période d'essai a expiré. Mes traductions fonctionnent-elles encore ? #

En bref : votre visualisation continue de traduire - mais vous devez intervenir une fois chez Google, sinon ce ne sera plus via Google. L'essentiel est de distinguer deux choses appelées toutes deux « gratuites » : le crédit de départ de 300 $ pour 90 jours est une période d'essai et il expire. Le quota mensuel de 500 000 caractères pour la traduction est autre chose : il demeure.

Si la période d'essai se termine et que vous ne faites rien, Google ferme le compte de facturation et arrête les projets associés : l'accès à l'API s'arrête avec eux. Vous devez donc passer au compte normal (« complet »). Cela ne veut pas dire que vous payez : après le passage, le quota mensuel s'applique toujours, et qui reste en dessous ne paie rien.

Par sécurité, vous pouvez créer dans Google Cloud un budget avec plafond de dépenses et le fixer à 0 €. Dès que des coûts apparaîtraient réellement, Google met l'usage en pause au lieu de le facturer. Google signale lui-même deux réserves : ce n'est pas un plafond strict, et son application n'est pas instantanée, le relevé des coûts ayant du retard. Une simple alerte budgétaire sans plafond, elle, ne limite rien du tout : elle envoie seulement des e-mails.

Et si Google venait à échouer ou à être mis en pause : Simple Locale bascule automatiquement sur le fournisseur gratuit. Vos visiteurs voient toujours des textes traduits, simplement d'une qualité un peu moindre, et ce qui est déjà traduit reste stocké localement, inchangé.

Sans garantie : ces informations reflètent notre connaissance en septembre 2026. Google peut modifier à tout moment ses conditions, ses quotas gratuits et le fonctionnement de ses garde-fous de coûts. La configuration, la surveillance et la protection de votre compte Google relèvent de votre seule responsabilité : nous ne garantissons pas l'absence de coûts et déclinons toute responsabilité pour les frais engagés chez Google.

J'ai des textes longs qui ne sont pas traduits - pourquoi ? #

Le fournisseur gratuit (MyMemory) accepte au maximum 500 octets de texte par requête - il refuse délibérément les contenus plus longs plutôt que de les tronquer de façon incorrecte. Dans la pratique, cela concerne surtout les "Textes personnalisés" plus longs (par ex. un widget HTMLBox complet avec plusieurs paragraphes), plus rarement de courts noms d'objets ou libellés.

Si un fournisseur avec votre propre clé d'API (Google Cloud Translate ou DeepL, à partir de l'édition Standard) est également configuré, Simple Locale transmet automatiquement à celui-ci un texte refusé par MyMemory - aucun des deux n'a de limite de caractères comparable. Si seul le fournisseur gratuit est disponible, cette cellule reste simplement non traduite (la tuile affiche entre-temps le texte original, sans plantage) - la raison exacte est consignée dans le journal des messages Symcon de l'instance ("tous les fournisseurs de la chaîne ... refusé").

Ma visualisation contient un mélange de plusieurs langues - Simple Locale peut-il gérer cela ? #

Oui, cela fonctionne - avec un peu de travail manuel. La langue source n'est pas enregistrée une seule fois pour toute l'installation, mais élément par élément - vous pouvez donc tout à fait avoir plusieurs langues d'origine au sein d'une même installation.

Si vous avez actuellement un mélange non trié, la méthode la plus simple est la suivante : effectuez d'abord une analyse complète avec votre langue la plus utilisée comme langue source. Supprimez ensuite manuellement toutes les lignes dont le contenu est en réalité rédigé dans une autre langue. Changez la langue source pour votre deuxième langue la plus utilisée et relancez une analyse - les objets que vous venez de supprimer seront automatiquement redétectés comme de nouvelles lignes, cette fois correctement capturées dans la nouvelle langue. Répétez l'opération pour chaque langue supplémentaire jusqu'à ce que tout soit couvert.

Licence et paiement

Comment puis-je payer ? #

Par carte bancaire via Stripe Checkout - une page de paiement sécurisée et conforme PCI hébergée par Stripe. Nous ne voyons ni ne stockons jamais vos données de carte.

Combien de temps prend la livraison de la licence ? #

Entièrement automatisée, généralement en quelques minutes après le paiement réussi : la clé de licence et la facture (en PDF) arrivent directement par e-mail.

Je ne retrouve plus ma licence et dois réinstaller. Puis-je en obtenir une nouvelle ? #

Oui, très simplement : sur notre page de renvoi, saisissez simplement l'adresse e-mail avec laquelle vous avez commandé - nous vous renverrons par e-mail toutes vos clés de licence existantes. Saisissez ensuite la clé comme d'habitude dans le formulaire de configuration du module et cliquez sur « Activer la licence ».

Réinstaller avec la même clé déjà achetée est tout à fait normal et n'est jamais bloqué - chaque activation est simplement enregistrée à des fins de détection d'abus : quelle installation Symcon (via son e-mail de titulaire de licence configuré) a activé quelle clé. Cela sert uniquement à repérer l'utilisation simultanée d'une même clé dans plusieurs installations (apparaissant sous plusieurs adresses différentes) ; une cession que vous nous avez signalée ne pose aucun problème - une réinstallation normale sur votre propre système ne déclenche pas cela.

Seule exception : si votre ancienne clé a déjà été échangée contre une mise à niveau d'édition, elle continue de fonctionner normalement pendant une période de transition et reçoit une date d'expiration - le module l'affiche donc comme une licence valable avec une date de fin, ce qui vous signale qu'il reste à saisir la clé plus récente. Ensuite, elle est expirée.

Comment puis-je me rétracter du contrat d'achat ? #

Tout simplement : en tant que consommateur, vous avez le droit légal de vous rétracter de votre achat dans un délai de 14 jours, sans avoir à justifier de motif. Pour les clés de licence numériques, nous pourrions vous demander de renoncer à ce droit en échange d'une livraison immédiate - nous ne le faisons délibérément pas, car nous sommes convaincus de l'utilité de Simple Locale. Contactez-nous simplement par e-mail (voir Mentions légales) et nous réglerons cela sans complication. Vous trouverez ici les instructions de rétractation complètes et formelles.

Que se passe-t-il techniquement lors d'une rétractation - ma clé de licence est-elle bloquée instantanément ? #

Pas immédiatement. La validité de votre clé, Simple Locale la vérifie entièrement hors ligne au moyen d'une signature numérique - aucune connexion n'est nécessaire pour cela. Une fois par jour, le module nous demande toutefois si la clé est toujours active. Après une rétractation, nous la marquons comme désactivée dans notre système, et le module applique le blocage lors de la prochaine de ces vérifications.

Si votre installation est hors ligne à ce moment-là, le blocage ne prend effet qu'une fois qu'elle est de nouveau en ligne et que cette vérification quotidienne aboutit - une erreur réseau ne déclenche jamais de blocage par erreur (le dernier état connu est simplement conservé). Contrairement à une mise à niveau d'édition (voir la documentation), cela ne déclenche pas non plus une nouvelle période d'essai - une licence rétractée reste bloquée.

Technique

Simple Locale envoie-t-il des données à un serveur ? #

Dans une mesure limitée, oui : pour traduire, le texte à traduire est envoyé au fournisseur que vous avez choisi (gratuit via MyMemory, en option Google Cloud Translate et/ou DeepL, selon votre configuration). C'est nécessaire pour que la traduction fonctionne.

Lors de la première activation d'une clé de licence, un hash de la clé (pas la clé elle-même) ainsi qu'un identifiant du titulaire de licence sont également signalés à notre propre serveur - pour repérer une même clé utilisée simultanément dans plusieurs installations. Céder ou vendre une licence est autorisé : signalez-le nous, et nous attribuerons la clé au nouveau titulaire. Ensuite, le module interroge une fois par jour ce même serveur pour vérifier si la licence est toujours active (pertinent par exemple après une révocation, voir FAQ) - là encore, seul le hash de la clé est transmis, aucune autre donnée. Aucun suivi, aucune analyse, aucun cookie publicitaire. Le changement entre langues déjà traduites continue de fonctionner entièrement en local, sans délai réseau - seule cette brève vérification quotidienne en arrière-plan nécessite une connexion, et une erreur réseau à ce moment-là ne bloque jamais rien par erreur. La connexion à notre serveur est chiffrée (HTTPS). Voir notre politique de confidentialité pour plus de détails.

Dans l'autre sens, lors de l'activation, votre installation télécharge les icônes et les modèles de tuile inclus dans votre édition - ainsi une édition spéciale en a vraiment l'apparence, sans nouvelle version du module à chaque fois. Il peut y en avoir plusieurs, et un téléchargement ultérieur en récupère les mises à jour. Le paquet porte la même signature qu'une clé de licence : votre module n'accepte donc que ce qui passe cette vérification. Il est stocké en local : un design déjà reçu vous reste acquis, même si nous le retirons plus tard. La vérification quotidienne ne le télécharge pas - seule une activation, ou un clic explicite sur „activer/mettre à jour la licence“, le récupère.

De combien d'espace de stockage local Simple Locale a-t-il besoin ? #

Cela dépend naturellement du nombre d'objets et de langues - mais nous pouvons affirmer avec confiance : très peu. À titre de repère issu de notre expérience avec des installations réelles : >500 noms d'objets, >40 textes personnalisés et >200 libellés sur 7 langues occupent ensemble environ 1,5 Mo de configuration d'instance. Les installations petites/moyennes (de quelques dizaines à quelques centaines d'objets, 2 à 4 langues) restent généralement bien en dessous, dans la plage basse à moyenne des dizaines de Ko.

Le cache n'ajoute quasiment rien de plus : par objet et par langue, seule la valeur traduite la plus récente est stockée, pas son historique - même une tuile météo dont les valeurs changent toutes les 10 minutes écrase donc toujours le même emplacement de stockage au lieu de croître avec le temps.

De combien de bande passante Simple Locale a-t-il besoin en fonctionnement normal ? #

Cela dépend de ce qui se passe : changer de langue entre contenus déjà traduits fonctionne entièrement en local - aucune connexion internet n'est nécessaire pour cela. Simple Locale a en revanche besoin d'internet dès que quelque chose est réellement traduit pour la première fois : l'analyse initiale de l'arborescence, chaque nouvelle analyse (manuelle ou automatique), et la retraduction automatique en direct dès qu'un "texte personnalisé" surveillé change de l'extérieur. À ces moments-là, le texte nouveau/modifié est envoyé au fournisseur de traduction choisi - généralement seulement quelques kilo-octets par opération, et uniquement du texte - les images ou fichiers de votre visualisation ne sont jamais transmis. Lors de l'activation de la licence, un petit paquet circule en sens inverse : les icônes et les modèles de tuile de votre édition, ensemble généralement quelques kilo-octets. Ensuite ils restent en local ; seule une nouvelle activation récupère les mises à jour. Si la connexion est justement indisponible à ce moment précis, seule cette tentative de traduction échoue (la tuile affiche alors temporairement le texte original non traduit au lieu de planter) et elle est automatiquement retentée lors de la prochaine analyse ou du prochain changement.

Combien de "variables utilisables" IP-Symcon Simple Locale utilise-t-il ? #

Bonne nouvelle : 0. C'est important car les licences IP-Symcon ont une limite de "variables utilisables" - mais Simple Locale ne crée pas la moindre variable Symcon qui lui soit propre. Il ne fait que traduire et réécrire le nom et la valeur d'objets que vous avez déjà créés dans la catégorie racine choisie (la configuration du module lui-même est stockée comme propriété d'instance, pas comme variable). Simple Locale ne compte donc absolument pas dans la limite de votre licence IP-Symcon.

J'ai programmé moi-même des fonctions qui dépendent du nom d'un objet - est-ce que ça fonctionne toujours ? #

Ici, la prudence est de mise : lors d'un changement de langue, Simple Locale réécrit précisément les noms d'objets de votre catégorie racine. Si votre propre script se base sur un nom fixe précis (par ex. une comparaison de chaînes, ou un déclencheur accroché à IPS_SetName), ce changement de nom peut déclencher votre fonction involontairement ou la faire échouer silencieusement - Simple Locale ne connaît pas l'objectif de votre script et ne peut pas en tenir compte. Dans ce cas, vous devrez adapter vous-même votre script pour le rendre compatible multilingue, par exemple en vous basant sur l'ID d'objet stable plutôt que sur le nom (qui change désormais selon la langue), ou en reconnaissant et acceptant toutes les traductions pertinentes du nom.

J'obtiens le message « An uncaught error occured … ResizeObserver loop completed with undelivered notifications » - qu'est-ce que c'est ? #

Ce message provient de la console IP-Symcon elle-même, pas de Simple Locale. Derrière se cache un avertissement de navigateur bien connu et sans gravité : le navigateur signale qu'un calcul de taille de la mise en page ne s'est pas terminé en une seule image. Aucune donnée n'est perdue, rien n'est traduit de travers et votre configuration reste intacte - la console se contente d'afficher cet avertissement sous forme de boîte de dialogue rouge. Un clic sur « OK » suffit.

Nous l'avons signalé à IP-Symcon. Leur réponse (en allemand) : « In der aktuellen 9.0 Beta soll dieser Fehler eigentlich korrigiert sein. » - autrement dit, le défaut est censé être corrigé dans la bêta 9.0 actuelle. Si vous utilisez encore une version plus ancienne, le message peut donc encore apparaître - il disparaît dès la mise à jour vers une version dans laquelle Symcon l'a corrigé.

Le message tel que l'affiche la console IP-Symcon.
Le message tel que l'affiche la console IP-Symcon.
Je suis développeur et je souhaite intégrer mon module de visualisation à Simple Locale. Est-ce possible ? #

Oui. Si votre module produit sa propre tuile HTML via GetVisualizationTile(), son texte peut être traduit en direct dans la langue active de la visualisation - et sans compte à vous chez un fournisseur de traduction : SLOC_TranslateExternalText() réutilise la clé de l'instance Simple Locale qui tourne déjà sur ce système.

L'appel doit rester défensif, car la plupart des utilisateurs n'ont pas (encore) installé Simple Locale : vérifiez d'abord function_exists("SLOC_TranslateExternalText"), puis cherchez l'instance avec IPS_GetInstanceListByModuleID("{1A2E3892-FE35-9E4E-A3A8-B983B0C41F64}") plutôt que de figer un identifiant d'instance. Si rien n'est trouvé, renvoyez le texte tel quel - ce n'est pas une erreur, il n'y a simplement pas de traduction.

Le meilleur endroit est chaque appel de GetVisualizationTile() : la tuile est de toute façon regénérée à chaque appel, aucun texte obsolète ne peut donc s'y installer. Les noms et les valeurs des objets présents dans la visualisation sont de toute manière traduits par Simple Locale lui-même. L'exemple complet figure à la section 10 de la documentation du module.

Nous ne proposons pas d'édition Developer distincte pour le moment - l'édition Pro couvre déjà tout ce dont vous avez besoin pour l'intégration. Si vous pensez malgré tout avoir un besoin particulier, écrivez-nous.

J'ai trouvé un bug ! Que dois-je faire ? #

N'importe quel logiciel peut contenir des erreurs - Simple Locale est testé de manière approfondie avant chaque version, et nous n'avons actuellement connaissance d'aucun bug ouvert. Ce qui existe, ce sont des limites délibérées du périmètre fonctionnel actuel (voir "Limitations connues" sur la page d'aperçu) - ce ne sont pas des bugs, mais des choix de conception.

Si vous trouvez malgré tout quelque chose qui ne fonctionne pas comme décrit : nous vous sommes sincèrement reconnaissants de nous le signaler et ferons notre possible pour proposer une solution le plus rapidement possible. Contactez-nous simplement via le Support avec une brève description de ce que vous attendiez et de ce qui s'est réellement passé - plus c'est précis, plus vite nous pourrons vous aider.

Question sans réponse ?

Contactez-nous - nous serons ravis de vous aider.

Aller au support