Synchronet v3.17b-Win32 (install) has been released (Jan-2019).

New Synchronet YouTube channel

You can donate to the Synchronet project using PayPal.


This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
module:xtrn_sec [2019/05/30 23:40]
digital man [External Programs Section] Added "install" section
module:xtrn_sec [2019/07/24 20:04] (current)
digital man [Configure] Add optional usage description and examples
Line 1: Line 1:
 ====== External Programs Section ====== ====== External Programs Section ======
-This module ​provide ​the "​External Programs"​ (doors) menu for the [[:​server:​Terminal]] server users.+The ''​xtrn_sec.js'' ​module ​provides ​the "​External Programs"​ (doors) menu for the [[:​server:​Terminal]] server users.
 ===== Install ===== ===== Install =====
Line 10: Line 10:
   ​   ​
 and then recompile with [[util:​Baja]] or just run the [[module:​update]] module. and then recompile with [[util:​Baja]] or just run the [[module:​update]] module.
 +===== Usage =====
 +The normally expected usage is just to invoke ''​xtrn_sec.js''​ with no arguments. If, however, you wish to have the module skip the menu of external program sections and go directly to the menu of available programs within one specific section, pass the internal-code of the desired program section section as and argument to ''​xtrn_sec.js''​.
 +Example (Baja):
 +<code Baja>
 +exec_bin xtrn_sec games
 +Example (JavaScript):​
 +<code JavaScript>​
 +load('​xtrn_sec.js',​ '​games'​);​
 +===== Configure ===== 
 +The ''​xtrn_sec''​ module supports the following configuration options in the ''​[xtrn_sec]''​ section of the ''​[[dir:​ctrl]]/​[[config:​modopts.ini]]''​ file:
 +^ Option ​              ^ Default ^ Description ^
 +| multicolumn ​         | true  | Use a multiple-column program list when there are more than 10 items |
 +| sort                 | false | Re-sort (alphabetically) the list of programs and program sections before displaying to the user |
 +| autoexec ​            | false | Automatically execute a section'​s program when there is only one program available within that section |
 +| clear_screen_on_exec | false | Clear the screen before executing any/all programs |
 +| eval_before_exec ​    ​| ​      | Evaluate the specified JavaScript expression //before// executing any/all programs |
 +| eval_after_exec ​     |       | Evaluate the specified JavaScript expression //after// executing any/all programs |
 +===== Fonts ===== 
 +This module uses the ''​[[custom:​javascript:​lib:​fonts.js]] library''​ and [[config:​fonts.ini]] file to optionally load door-specific fonts before executing an external program and restore the default font upon returning from the external program.
 ===== See Also ===== ===== See Also =====
-  * [[:module:|module index]]+  * [[:module:|Modules]] 
 +{{tag>​doors fonts javascript}}

In Other Languages