[Feature] Highlight to speech (#147)

Adds the highlight to speech feature. Adds the execution permission on `INSTALL.sh`?

do_text_text.php

@@ -761,6 +761,7 @@ function do_text_text_content($textid, $only_body=true): void
         'TID' => $textid,
         'ADDFILTER' => makeStatusClassFilter((int)$visit_status),
         'JQ_TOOLTIP' => getSettingWithDefault('set-tooltip-mode') == 2 ? 1 : 0,
+        'HTS' => getSettingWithDefault('set-hts'),
         // Add new globals
         'ANNOTATIONS_MODE' => $mode_trans,
         'POS' => $pos

inc/kernel_utility.php

@@ -166,6 +166,9 @@ function get_setting_data()
         'set-tts' => array(
             "dft" => '1', "num" => 0
         ),
+        'set-hts' => array(
+            "dft" => '1', "num" => 0
+        ),
         'set-term-sentence-count' => array(
             "dft" => '1', "num" => 0
         ),

inc/session_utility.php

@@ -2407,6 +2407,20 @@ function get_annotation_position_selectoptions($v): string
     $r .= ">Above</option>";
     return $r;
 }
+// -------------------------------------------------------------
+
+function get_hts_selectoptions($v): string
+{
+    if (! isset($v) ) { $v = 1; 
+    }
+    $r = "<option value=\"1\"" . get_selected($v, 1);
+    $r .= ">Never</option>";
+    $r .= "<option value=\"2\"" . get_selected($v, 2);
+    $r .= ">On Click</option>";
+    $r .= "<option value=\"3\"" . get_selected($v, 3);
+    $r .= ">On Hover</option>";
+    return $r;
+}
 
 // -------------------------------------------------------------
 

settings.php

@@ -111,6 +111,10 @@
                 1 : 0
             )
         );
+        saveSetting(
+            'set-hts',  
+                $_REQUEST['set-hts']
+                          );
 
         saveSetting(
             'set-archivedtexts-per-page',
@@ -568,7 +572,7 @@
     </tr>
     <!-- ******************************************************* -->
     <tr>
-        <th class="th1 center">Text to Speech</th>
+        <th class="th1 center" rowspan="2">Text to Speech</th>
         <td class="td1 center">Save Audio Files to Disk</td>
         <td class="td1 center">
             <input type="checkbox" name="set-tts" value="1" 
@@ -580,6 +584,22 @@
         </td>
     </tr>
     <!-- ******************************************************* -->
+    <tr>
+        <td class="td1 center">Read word aloud</td>
+        <td class="td1 center">
+            <select name="set-hts" class="notempty respinput">
+            <?php
+            echo get_hts_selectoptions(
+                getSettingWithDefault('set-hts')
+            );
+            ?>
+            </select>
+        </td>
+        <td class="td1 center">
+            <img src="icn/status-busy.png" title="Field must not be empty" alt="Field must not be empty" />
+        </td>
+    </tr>
+    <!-- ******************************************************* -->
     <tr>
         <th class="th1 center" rowspan="7">Text, Term,<br />Newsfeed &amp;<br />Tag Tables</th>
         <td class="td1 center">Texts per Page</td>

src/js/jq_pgm.js

@@ -29,6 +29,7 @@ RTL = 0;
 ANN_ARRAY = {};
 DELIMITER = '';
 JQ_TOOLTIP = 0;
+HTS = 0;
 
 /**************************************************************
 LWT jQuery functions
@@ -714,6 +715,10 @@ function mword_click_event_do_text_text () {
       $(this).attr('data_wid'), status, $(this).attr('data_code'), ann
     );
   }
+  if (HTS == 2) { 
+    const lg = getLangFromDict(WBLINK3);
+    readTextAloud($(this).text(), lg);
+    }
   return false;
 }
 
@@ -875,6 +880,10 @@ function word_hover_over () {
     if (JQ_TOOLTIP) {
       $(this).trigger('mouseover');
     }
+    if (HTS == 3) { 
+      const lg = getLangFromDict(WBLINK3);
+      readTextAloud($(this).text(), lg);
+      }
   }
 }