menus
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
menus [2017/04/16 20:18] – avon | menus [2019/03/24 21:24] (current) – [MENU SYSTEM] g00r00 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | ==== Menu Editor | + | |
+ | ^ Related Categories | ||
+ | | [[themes|Themes]] | ||
+ | | [[menu_commands|Menu Command Reference]] | ||
+ | |||
+ | ----- | ||
+ | ===== ANATOMY OF A MENU ===== | ||
The BBS menus are the core of the BBS system. | The BBS menus are the core of the BBS system. | ||
Line 6: | Line 12: | ||
Mystic BBS supports an unlimited number of defined menus which can | Mystic BBS supports an unlimited number of defined menus which can | ||
be setup in any way, allowing a totally customizable and unique | be setup in any way, allowing a totally customizable and unique | ||
- | interface to the user. | + | interface |
+ | |||
+ | Each menu consists of a Settings page where general options are | ||
+ | defined for the menu, along with an command/ | ||
+ | that appear on the menu are defined. | ||
+ | "menu commands" | ||
+ | the option is selected by the user. In order words, a menu option | ||
+ | defines the option that is presented to the user and the menu command(s) | ||
+ | configured inside of the option define what the BBS actually does when | ||
+ | the option is executed. | ||
+ | |||
+ | Menus can be configured to automatically generate a menu of options for | ||
+ | the user based on the options configured, or the internally generated menu | ||
+ | can be replaced by a display file (in the Settings page). | ||
+ | |||
+ | There are many more advanced techniques such as automatic execution | ||
+ | of menu options based on specific criteria or time-based intervals, | ||
+ | or menu option chaining and branching that will be discussed in their | ||
+ | own sections. | ||
+ | |||
+ | In addition to the standard type of menu, there are also Lightbar, Grid, | ||
+ | and Prompt menu styles which build off of the standard menu system. | ||
+ | types of menus will also be covered in more detail in their own sections. | ||
+ | |||
+ | ----- | ||
+ | ===== MENU EDITOR OVERVIEW ===== | ||
When first entering the menu editor, you will be prompted to select | When first entering the menu editor, you will be prompted to select | ||
- | which language | + | which theme definition you'd like to edit. It is possible to have |
- | different sets of menus for each language! | + | different sets of menus for each theme! |
After you've selected the theme you'd like to edit, you will be | After you've selected the theme you'd like to edit, you will be | ||
- | shown the main menu selection screen: | + | shown the main menu selection screen |
+ | you wish to search for an item just start typing the text you wish | ||
+ | to search for. | ||
< | < | ||
- | | + | █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Menu Editor (Default) ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ |
- | █ Menu Name | + | |
- | █ ───────────────────────────────────────────────────── █ | + | |
- | █ account | + | |
- | █ autosig | + | |
- | █ bbslist | + | |
- | █ demos Demos of various things | + | |
- | █ doors | + | |
- | █ file File base menu ░ | + | |
- | █ flist | + | |
- | █ fnewscan | + | |
- | █ fqueue | + | |
- | █ goodbye | + | |
- | █ ───────────────────────────────────────────────────── █ | + | |
- | █ Press / for command list █ | + | |
- | ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ | + | |
</ | </ | ||
Line 39: | Line 72: | ||
=== Command List === | === Command List === | ||
- | This view will show the list of commands that this menu contains. | + | |
+ | When a menu is first opened for editing, the default | ||
+ | of options defined in the menu. This view is presented first because | ||
+ | it is the most widely used, but each menu also has a Settings page as | ||
+ | well that can be accessed from the command list by typing / | ||
< | < | ||
- | █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ | + | █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ |
█ HotKey | █ HotKey | ||
█ ──────────────────────────────────────────────────────────── █ | █ ──────────────────────────────────────────────────────────── █ | ||
Line 72: | Line 110: | ||
</ | </ | ||
- | * Insert | + | |
- | * Delete | + | |
- | * Copy - Copy the highlighted command | + | |
- | * Paste - Paste the copied command | + | |
- | * View - View the generated menu. | + | |
- | * Settings - Adjust the settings of the menu | + | |
=== Menu settings === | === Menu settings === | ||
- | This menu will allow for the adjustment of many different features of the menu. | + | The Menu Settings page will allow for the adjustment of many different features of the menu. |
< | < | ||
Line 102: | Line 140: | ||
</ | </ | ||
- | * Description - Set the description of the Menu as seen in the Menu List. | + | |
- | * Access | + | |
- | * Fallback | + | |
- | * Menu Type - Select either Standard, Lightbar, Lightbar/ | + | |
- | * Input Type - Select either User Defined, HotKey, or LongKey | + | |
- | * Input Chars - Select | + | |
- | * Use Global | + | |
- | * Node Status - < | + | |
- | * Display File- The display file to use for this menu. | + | |
- | * Display Cols- Select how many columns | + | |
- | * Menu Header - < | + | |
- | * Menu Prompt - < | + | |
- | * X,Y - The X and Y positions to park the cursor after the menu has been drawn on the screen. | + | |
+ | |||
+ | | ||
+ | |||
+ | | ||
+ | |||
+ | | ||
+ | |||
+ | | ||
+ | |||
+ | | ||
+ | |||
+ | | ||
=== Menu Types === | === Menu Types === | ||
^Type^Description^ | ^Type^Description^ | ||
|Standard|Uses the standard displayed menu| | |Standard|Uses the standard displayed menu| | ||
|Lightbar|The LightBar High and LightBar Low text can be placed anywhere on the screen| | |Lightbar|The LightBar High and LightBar Low text can be placed anywhere on the screen| | ||
- | |Lightbar/ | + | |Lightbar/ |
- | |Lightbar/ | + | |Lightbar/ |
- | === Command | + | === Option |
- | The Command | + | The Option |
< | < | ||
- | █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ | + | █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ |
█ Display Text │ █ | █ Display Text │ █ | ||
█ LightBar Low │ █ | █ LightBar Low │ █ | ||
Line 144: | Line 194: | ||
</ | </ | ||
- | * Display Text - The text that is displayed in the Command List window list. | + | |
- | * Lightbar Low - The text that is displayed when this lightbar menu option is cold. | + | |
- | * Lightbar High- The text that is displayed when this lightbar menu option is hot. | + | |
- | * Hot Key - The keyboard keys that will activate this command. | + | |
- | * Access - Define the ACS string for this menu. Use CTRL-L to see a list of non-keyboard keys that can be used. | + | |
- | * X,Y - The X,Y location for the Lightbar Low and and Lightbar High text | + | |
- | * Timer | + | |
- | * Timer Type | + | |
- | * Redraw - Select whether or not to redraw this command when the menu redraws. | + | |
- | * Up, Down, Left, Right, Home, Escape, Tab, PageUp, PageDn, End - Define which menu command to switch to when one of these keys are used when this command is hightlighted. | + | |
- | Each command can perform several sub-tasks in a series. | + | * **Lightbar Low** - The text that is displayed when this lightbar menu option is cold (deselected). |
- | Select | + | |
- | === Sub Command Editor === | + | * **Lightbar High** - The text that is displayed when this lightbar menu option is hot (selected). |
- | Many sub commands can be stacked in one menu command. The sub commands will be activated in serial order when the menu command | + | |
+ | * **Hot Key** - The key(s) that the user must enter in otder to activate this command. | ||
+ | |||
+ | * **Access** - Define the ACS string required for this menu option to be executable by the user | ||
+ | |||
+ | * **X, Y** - The X,Y location for the Lightbar Low and and Lightbar High text | ||
+ | |||
+ | * **Timer** - Sets the number of seconds to activate the Timer-based execution or 0 to disable a time-based execution of this menu command. | ||
+ | |||
+ | * **Timer Type** - Sets the type of time-based execution. | ||
+ | |||
+ | * **Redraw** - If set to TRUE the menu will be redrawn after this menu selection is executed. | ||
+ | |||
+ | * **Up, Down, Left, Right, Home, Escape, Tab, PageUp, PageDn, End** - These are used only by Grid style menus and each one defines which menu command ID to switch to when the user presses the key with this command highlighted. | ||
+ | This allows very intricate configuration of menu selection behavior at the expense of complexity. | ||
+ | |||
+ | Each option can perform several sub-tasks in a series when the option is selected and these tasks are defined by creating a menu command or a list of menu commands within the option. | ||
+ | |||
+ | === Menu Command Editor === | ||
+ | |||
+ | Many menu commands can be defined to be executed by a single | ||
+ | |||
+ | A list of menu commands can be found in the [[menu_commands|Menu Command Reference]] | ||
< | < | ||
Line 172: | Line 234: | ||
</ | </ | ||
- | *Command - Select from a picklist | + | |
- | *Data - The optional data field to use for menu commands that require more information. | + | |
- | *Access - The ACS string to use for this sub command | + | |
- | *Execute - Execute the sub command on which grid event. | + | |
+ | |||
+ | ----- | ||
+ | ===== CREATING STANDARD MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== CREATING LIGHTBAR MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== CREATING GRID MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== CREATING PROMPT MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== AUTO-EXECUTION ===== | ||
+ | |||
+ | ----- | ||
+ | ===== OPTION CHAINING ===== | ||
+ | |||
+ | ----- | ||
+ | ===== TIMER EVENTS ===== | ||
+ | |||
+ | ----- | ||
+ | ===== COMMAND BRANCHING ===== | ||
menus.1492391936.txt.gz · Last modified: 2017/04/16 20:18 by avon