{"id":46744,"date":"2020-08-19T09:10:41","date_gmt":"2020-08-19T16:10:41","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?p=46744"},"modified":"2022-12-15T10:21:20","modified_gmt":"2022-12-15T17:21:20","slug":"how-do-i-add-a-new-translation-to-transact","status":"publish","type":"post","link":"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/","title":{"rendered":"How to Add a New Translation to Transact"},"content":{"rendered":"<p><span style=\"color: #333333\"><strong>Applies to:\u00a0<\/strong>All versions of Ephesoft Transact<\/span><\/p>\n<p><span style=\"color: #333333\">If a language you\u2019re looking for is not<\/span> <a href=\"https:\/\/ephesoft.com\/docs\/products\/transact\/getting-started\/global-languages\/#ui-supported-languages\">supported by Ephesoft<\/a>,<span style=\"color: #333333\"> you can add your own translations to the Transact UI by editing the locale files.<\/span><\/p>\n<ul>\n<li><a href=\"#post-46744-_mt45w4f69l3f\">What are locale files?<\/a><\/li>\n<li><a href=\"#post-46744-_3q7zc9wuhirm\">Where are the locale files?<\/a><\/li>\n<li><a href=\"#post-46744-_fzjelphw097q\">How do I add a new translation?<\/a><\/li>\n<\/ul>\n<h2><a id=\"post-46744-_mt45w4f69l3f\"><\/a><span style=\"color: #333333\"><strong>What <\/strong>are l<strong>ocale <\/strong>f<strong>iles?<\/strong><\/span><\/h2>\n<p><span style=\"color: #333333\">A locale file is a JavaScript (.js) file that contains a set of translations for the text strings used in Transact. In the Ephesoft file structure, there are separate locale files for each UI screen. The locale files contain an entry for each language.<\/span><\/p>\n<h2><span style=\"color: #333333\"><a id=\"post-46744-_3q7zc9wuhirm\" style=\"color: #333333\"><\/a>Where are the locale files?<\/span><\/h2>\n<p><span style=\"color: #333333\">The locale files are located at [<em>Ephesoft_Directory<\/em>]\\Application\\i18n and [<em>Ephesoft_Directory<\/em>]\\Application\\custom\\i18n. The <strong>i18n <\/strong>folder contains the following folders, each of which contains their respective <strong>locale.js<\/strong> file:<\/span><\/p>\n<ul>\n<li><span style=\"color: #333333\">batchClassManagement<\/span><\/li>\n<li><span style=\"color: #333333\">batchInstance<\/span><\/li>\n<li><span style=\"color: #333333\">batchlist<\/span><\/li>\n<li><span style=\"color: #333333\">common<\/span><\/li>\n<li><span style=\"color: #333333\">customWorkflow<\/span><\/li>\n<li><span style=\"color: #333333\">folderManager<\/span><\/li>\n<li><span style=\"color: #333333\">licenseGenerator<\/span><\/li>\n<li><span style=\"color: #333333\">login<\/span><\/li>\n<li><span style=\"color: #333333\">report<\/span><\/li>\n<li><span style=\"color: #333333\">rv<\/span><\/li>\n<li><span style=\"color: #333333\">systemConfig<\/span><\/li>\n<li><span style=\"color: #333333\">theme<\/span><\/li>\n<li><span style=\"color: #333333\">uploadbatch<\/span><\/li>\n<li><span style=\"color: #333333\">webscanner<\/span><\/li>\n<\/ul>\n<h2><span style=\"color: #333333\"><a id=\"post-46744-_fzjelphw097q\" style=\"color: #333333\"><\/a>How do I add a new translation?<\/span><\/h2>\n<p><span style=\"color: #333333\">To add a new translation, perform the following steps for each respective <strong>locale.js<\/strong> file:<\/span><\/p>\n<ol>\n<li><span style=\"color: #333333\">Before making any changes, make a copy of the <strong>locale.js <\/strong>file as a backup.<\/span><\/li>\n<li><span style=\"color: #333333\">Copy the <strong>var<\/strong> statement from the English (default) messages.<\/span><\/li>\n<\/ol>\n<p><span style=\"color: #333333\"><strong>Note: <\/strong>English var statements don\u2019t have any language suffixes. For example, in the screenshots below, figure 1 shows the English variable with no language suffix while figure 2 shows the French translation variable in the same file with the <strong>_fr<\/strong> suffix:<\/span><\/p>\n<p><span style=\"color: #333333\"><img decoding=\"async\" class=\"wp-image-46745\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image.png\" width=\"705\" height=\"210\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image.png 762w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image-300x89.png 300w\" sizes=\"(max-width: 705px) 100vw, 705px\" \/><\/span><\/p>\n<p><span style=\"color: #333333\"><em>Figure 1. English Variable (default)<\/em><\/span><\/p>\n<p><span style=\"color: #333333\"><img decoding=\"async\" width=\"701\" height=\"229\" class=\"wp-image-46746\" src=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image-1.png\" srcset=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image-1.png 701w, https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image-1-300x98.png 300w\" sizes=\"(max-width: 701px) 100vw, 701px\" \/><\/span><\/p>\n<p><span style=\"color: #333333\"><em>Figure 2. French Variable<\/em><\/span><\/p>\n<ol start=\"3\">\n<li><span style=\"color: #333333\">Paste the copied variable at the end of the <strong>locale.js <\/strong>file.<\/span><\/li>\n<li><span style=\"color: #333333\">Add a suffix for the language you\u2019re adding a translation for. We recommend using ISO language codes for consistency.<\/span><\/li>\n<li><span style=\"color: #333333\">Replace each message in the variable with their respective translations.<\/span><\/li>\n<li><span style=\"color: #333333\">Repeat steps 1\u20135 for all *.js files in the [<em>Ephesoft_Directory<\/em>]\\Application\\i18n and [<em>Ephesoft_Directory<\/em>]\\Application\\custom\\i18n folders.<\/span><\/li>\n<li><span style=\"color: #333333\">Modify [<em>Ephesoft_Directory<\/em>]\\Application\\WEB-INF\\classes\\META-INF\\application.properties. Modify the locale_language entry and add additional language codes separated by a semicolon.<\/span><\/li>\n<li><span style=\"color: #333333\">Restart the Transact service.<\/span><\/li>\n<li><span style=\"color: #333333\">Change the default language setting on your browser to test the language codes you added.<\/span><\/li>\n<\/ol>\n<p><span style=\"color: #333333\"><strong>Note: <\/strong>As this is a JavaScript file, do not make any changes to the formatting or alignment of the script. Any syntax errors will prevent Transact from accessing the translations.<\/span><\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Applies to:\u00a0All versions of Ephesoft Transact If a language you\u2019re looking for is not supported by Ephesoft, you can add [&hellip;]<\/p>\n","protected":false},"author":62,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[12367],"tags":[361,12330,12334,12333,12332,12331,624],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v19.0 (Yoast SEO v22.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>How to Add a New Translation to Transact | Ephesoft Docs<\/title>\n<meta name=\"robots\" content=\"noindex, follow\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Add a New Translation to Transact\" \/>\n<meta property=\"og:description\" content=\"Applies to:\u00a0All versions of Ephesoft Transact If a language you\u2019re looking for is not supported by Ephesoft, you can add [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/\" \/>\n<meta property=\"og:site_name\" content=\"Ephesoft Docs\" \/>\n<meta property=\"article:published_time\" content=\"2020-08-19T16:10:41+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-12-15T17:21:20+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image.png\" \/>\n<meta name=\"author\" content=\"Breanna Fitzgerald\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Breanna Fitzgerald\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/\",\"url\":\"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/\",\"name\":\"How to Add a New Translation to Transact | Ephesoft Docs\",\"isPartOf\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\"},\"datePublished\":\"2020-08-19T16:10:41+00:00\",\"dateModified\":\"2022-12-15T17:21:20+00:00\",\"author\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd\"},\"breadcrumb\":{\"@id\":\"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/ephesoft.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Add a New Translation to Transact\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#website\",\"url\":\"https:\/\/ephesoft.com\/docs\/\",\"name\":\"Ephesoft Docs\",\"description\":\"Intelligent Document Processing Made Easy\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/ephesoft.com\/docs\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd\",\"name\":\"Breanna Fitzgerald\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g\",\"caption\":\"Breanna Fitzgerald\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"How to Add a New Translation to Transact | Ephesoft Docs","robots":{"index":"noindex","follow":"follow"},"og_locale":"en_US","og_type":"article","og_title":"How to Add a New Translation to Transact","og_description":"Applies to:\u00a0All versions of Ephesoft Transact If a language you\u2019re looking for is not supported by Ephesoft, you can add [&hellip;]","og_url":"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/","og_site_name":"Ephesoft Docs","article_published_time":"2020-08-19T16:10:41+00:00","article_modified_time":"2022-12-15T17:21:20+00:00","og_image":[{"url":"https:\/\/ephesoft.com\/docs\/wp-content\/uploads\/2020\/08\/word-image.png"}],"author":"Breanna Fitzgerald","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Breanna Fitzgerald","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/","url":"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/","name":"How to Add a New Translation to Transact | Ephesoft Docs","isPartOf":{"@id":"https:\/\/ephesoft.com\/docs\/#website"},"datePublished":"2020-08-19T16:10:41+00:00","dateModified":"2022-12-15T17:21:20+00:00","author":{"@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd"},"breadcrumb":{"@id":"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ephesoft.com\/docs\/how-do-i-add-a-new-translation-to-transact\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ephesoft.com\/docs\/"},{"@type":"ListItem","position":2,"name":"How to Add a New Translation to Transact"}]},{"@type":"WebSite","@id":"https:\/\/ephesoft.com\/docs\/#website","url":"https:\/\/ephesoft.com\/docs\/","name":"Ephesoft Docs","description":"Intelligent Document Processing Made Easy","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/ephesoft.com\/docs\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/d74c698404588430489bf05dfdf4bedd","name":"Breanna Fitzgerald","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/ephesoft.com\/docs\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e0624b0af4f5f3caa370053f6eef54c8?s=96&r=g","caption":"Breanna Fitzgerald"}}]}},"_links":{"self":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/46744"}],"collection":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/users\/62"}],"replies":[{"embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/comments?post=46744"}],"version-history":[{"count":3,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/46744\/revisions"}],"predecessor-version":[{"id":52051,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/posts\/46744\/revisions\/52051"}],"wp:attachment":[{"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/media?parent=46744"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/categories?post=46744"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ephesoft.com\/docs\/wp-json\/wp\/v2\/tags?post=46744"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}