Traductions
La langue affichée au visiteur se règle par un petit nombre de canaux, chacun responsable d’une surface différente : l’interface du widget lui-même, la page d’enregistrement autonome et les documents générés côté serveur.
La prop et l’attribut lang
Le composant React prend une prop lang, et le Custom Element observe l’attribut lang correspondant : définissez-le directement ou modifiez-le à l’exécution, l’interface du widget suit.
<livstick-widget-v2 uid="code" domain="example.com" lang="fr"></livstick-widget-v2>fullpage.html et le paramètre d’URL de langue
La page autonome fullpage.html lit sa configuration dans un template intégré, mais accepte aussi des paramètres de requête dans l’URL — et la langue est le seul d’entre eux qui puisse changer quoi que ce soit. Aucun paramètre de requête ne peut remplacer la clé d’API, le domaine ou une capacité de reprise lus dans cette même configuration ; la langue est délibérément la seule exception.
language à la création du conteneur
Côté API, la langue transmise à la création d’un conteneur détermine la langue du parcours d’enregistrement présenté au destinataire, ainsi que celle des documents que Livstick génère pour ce conteneur : le PDF de la carte, par exemple, porte un texte traduit dans cette langue, et pas seulement une mise en page neutre.
Ce qui n’est pas documenté ici
Le catalogue exact des clés de traduction utilisées dans le widget, et le mécanisme permettant de fournir des traductions personnalisées pour une langue que le widget ne couvre pas encore, ne sont pas établis dans le dépôt à l’heure où nous écrivons. Plutôt que de deviner une liste ou un format de fichier, cette page s’en tient à ce qui est vérifié ci-dessus : considérez l’existence d’un catalogue de traductions et d’un mécanisme de personnalisation comme probable, mais non confirmée.