From 4d74dbfa38483ebeb658e9cba41906703eaa1117 Mon Sep 17 00:00:00 2001
From: Stephen Nielson <snielson@discoverandchange.com>
Date: Wed, 7 Aug 2024 21:26:21 -0600
Subject: [PATCH] Fixes #7621 validation save errors w/ translations (#7622)

* Fixes #7621 validation save errors w/ translations

The translation system was not setup in the OnSiteDocumentController and
a bug in utility.js would blow up preventing the questionnaire from
saving.  I added more safety checks to the xl translation function.
Injected the language translations into the OnSiteDocumentController and
abstracted the language definition retrievals into a service utility
class.

* Update copyright with correct verbiage.

* Accidently had commented out line
---
 library/js/utility.js                         |  7 ++--
 portal/home.php                               | 12 +-----
 .../Controller/OnsiteDocumentController.php   |  4 ++
 .../templates/OnsiteDocumentListView.tpl.php  | 19 ++++++++--
 src/Services/Utils/TranslationService.php     | 37 +++++++++++++++++++
 5 files changed, 63 insertions(+), 16 deletions(-)
 create mode 100644 src/Services/Utils/TranslationService.php

diff --git a/library/js/utility.js b/library/js/utility.js
index e44047b1631..e39451fe9c9 100644
--- a/library/js/utility.js
+++ b/library/js/utility.js
@@ -12,9 +12,10 @@
 /* We should really try to keep this library jQuery free ie javaScript only! */
 
 // Translation function
-// This calls the i18next.t function that has been set up in main.php
+// This calls the i18next.t function that has been set up in main.php, portal/base.html.twig, etc.
 function xl(string) {
-    if (typeof top.i18next.t == 'function') {
+    // safety check if for some reason the i18next is not included.
+    if (top.i18next && typeof top.i18next.t == 'function') {
         return top.i18next.t(string);
     } else {
         // Unable to find the i18next.t function, so log error
@@ -558,4 +559,4 @@ function isValidEmail(emailAddress) {
     } else {
         return false;
     }
-}
\ No newline at end of file
+}
diff --git a/portal/home.php b/portal/home.php
index ec1930ab3ab..9a038643eeb 100644
--- a/portal/home.php
+++ b/portal/home.php
@@ -27,6 +27,7 @@
 use OpenEMR\Events\PatientPortal\AppointmentFilterEvent;
 use OpenEMR\Events\PatientPortal\RenderEvent;
 use OpenEMR\Services\LogoService;
+use OpenEMR\Services\Utils\TranslationService;
 use Twig\Error\LoaderError;
 use Twig\Error\RuntimeError;
 use Twig\Error\SyntaxError;
@@ -46,16 +47,7 @@
 
 
 // Get language definitions for js
-$language = $_SESSION['language_choice'] ?? '1'; // defaults english
-$sql = "SELECT c.constant_name, d.definition FROM lang_definitions as d
-        JOIN lang_constants AS c ON d.cons_id = c.cons_id
-        WHERE d.lang_id = ?";
-$tarns = sqlStatement($sql, $language);
-$language_defs = array();
-while ($row = SqlFetchArray($tarns)) {
-    $language_defs[$row['constant_name']] = $row['definition'];
-}
-
+$language_defs = TranslationService::getLanguageDefinitionsForSession();
 $whereto = $_SESSION['whereto'] ?? null;
 
 $user = $_SESSION['sessionUser'] ?? 'portal user';
diff --git a/portal/patient/libs/Controller/OnsiteDocumentController.php b/portal/patient/libs/Controller/OnsiteDocumentController.php
index 432cb0f0756..cd83c33d27f 100644
--- a/portal/patient/libs/Controller/OnsiteDocumentController.php
+++ b/portal/patient/libs/Controller/OnsiteDocumentController.php
@@ -13,6 +13,7 @@
 /** import supporting libraries */
 
 use OpenEMR\Services\DocumentTemplates\DocumentTemplateRender;
+use OpenEMR\Services\Utils\TranslationService;
 
 require_once("AppBasePortalController.php");
 require_once("Model/OnsiteDocument.php");
@@ -75,6 +76,9 @@ public function ListView()
         unset($_GET['auto_render_name']);
         unset($_GET['audit_render_id']);
 
+        $language_defs = TranslationService::getLanguageDefinitionsForSession();
+
+        $this->Assign("language_defs", $language_defs);
         $this->Assign('doc_edit', $doc_edit);
         $this->Assign('recid', $recid);
         $this->Assign('help_id', $help_id);
diff --git a/portal/patient/templates/OnsiteDocumentListView.tpl.php b/portal/patient/templates/OnsiteDocumentListView.tpl.php
index 36244499d86..e0232d6ea76 100644
--- a/portal/patient/templates/OnsiteDocumentListView.tpl.php
+++ b/portal/patient/templates/OnsiteDocumentListView.tpl.php
@@ -93,9 +93,9 @@
     echo "<script>var formNamesWhitelist=" . json_encode(CoreFormToPortalUtility::getListPortalCompliantEncounterForms()) . ";</script>";
 
     if ($is_portal) {
-        Header::setupHeader(['no_main-theme', 'portal-theme', 'datetime-picker']);
+        Header::setupHeader(['no_main-theme', 'portal-theme', 'datetime-picker', 'i18next']);
     } else {
-        Header::setupHeader(['datetime-picker']);
+        Header::setupHeader(['datetime-picker', 'i18next']);
     }
     ?>
     <link rel="stylesheet" href="<?php echo $GLOBALS['web_root']; ?>/portal/sign/css/signer_modal.css?v=<?php echo $GLOBALS['v_js_includes']; ?>">
@@ -111,7 +111,20 @@
         $LAB.script("<?php echo $GLOBALS['assets_static_relative']; ?>/underscore/underscore-min.js").script("<?php echo $GLOBALS['assets_static_relative']; ?>/moment/moment.js").script(
             "<?php echo $GLOBALS['assets_static_relative']; ?>/backbone/backbone-min.js").script("<?php echo $GLOBALS['web_root']; ?>/portal/patient/scripts/app.js?v=<?php echo $GLOBALS['v_js_includes']; ?>").script(
             "<?php echo $GLOBALS['web_root']; ?>/portal/patient/scripts/model.js?v=<?php echo $GLOBALS['v_js_includes']; ?>").wait().script(
-            "<?php echo $GLOBALS['web_root']; ?>/portal/patient/scripts/view.js?v=<?php echo $GLOBALS['v_js_includes']; ?>").wait()
+            "<?php echo $GLOBALS['web_root']; ?>/portal/patient/scripts/view.js?v=<?php echo $GLOBALS['v_js_includes']; ?>").wait();
+        i18next.init({
+            lng: 'selected',
+            debug: false,
+            nsSeparator: false,
+            keySeparator: false,
+            resources: {
+                selected: {
+                    translation: <?php echo js_escape($this->language_defs ?? []); ?>
+                }
+            }
+        }).catch(error => {
+            console.log(error.message);
+        });
     </script>
     <style>
       @media print {
diff --git a/src/Services/Utils/TranslationService.php b/src/Services/Utils/TranslationService.php
new file mode 100644
index 00000000000..adf151811f6
--- /dev/null
+++ b/src/Services/Utils/TranslationService.php
@@ -0,0 +1,37 @@
+<?php
+
+/**
+ * Helper class for dealing with language translations.
+ *
+ * @package   OpenEMR
+ * @link      https://www.open-emr.org
+ * @author    Jerry Padgett <sjpadgett@gmail.com>
+ * @author    Stephen Nielson <snielson@discoverandchange.com>
+ * @copyright Copyright (c) 2016-2024 Jerry Padgett <sjpadgett@gmail.com>
+ * @copyright Copyright (c) 2024 Open Plan IT Ltd. <support@openplanit.com>
+ * @license   https://github.com/openemr/openemr/blob/master/LICENSE GNU General Public License 3
+ */
+
+namespace OpenEMR\Services\Utils;
+
+class TranslationService
+{
+    public static function getLanguageDefinitionsForSession()
+    {
+        $language = $_SESSION['language_choice'] ?? '1'; // defaults english
+        return self::getLanguageDefinitionsForLanguage($language);
+    }
+
+    public static function getLanguageDefinitionsForLanguage(int $languageId)
+    {
+        $sql = "SELECT c.constant_name, d.definition FROM lang_definitions as d
+        JOIN lang_constants AS c ON d.cons_id = c.cons_id
+        WHERE d.lang_id = ?";
+        $tarns = sqlStatement($sql, $languageId);
+        $language_defs = array();
+        while ($row = SqlFetchArray($tarns)) {
+            $language_defs[$row['constant_name']] = $row['definition'];
+        }
+        return $language_defs;
+    }
+}