menus
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
menus [2016/07/14 14:20] – [Menu Editor] gryphon | 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 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 - | + | |
+ | |||
+ | | ||
+ | |||
+ | | ||
+ | |||
+ | * **Input Chars** - This defines how user input is visually represented on the menu. If set to Uppercase, then the user input will be displayed as uppercase. | ||
+ | |||
+ | * **Use Global** | ||
+ | |||
+ | * **Node Status** - Sets the text that will be displayed for the user's " | ||
+ | |||
+ | * **Display File** - When left blank, Mystic will automatically generate a menu based on the configured menu options and the user's access to them. However, a menu can be replaced by defining the base filename (the filename without the .asc or .ans extension) to be loaded from the Theme' | ||
+ | |||
+ | * **Display Cols** - Sets the number of columns Mystic will use to format the menu options when generating a menu. Valid options are 1-9, or H for Hidden. | ||
+ | |||
+ | * **Menu Header** - Defines the header to be displayed before the list of generated menu commands. | ||
+ | |||
+ | * **Menu Prompt** - Defines the prompt to be displayed after the menu is displayed. | ||
+ | |||
+ | * **X, Y** - The X and Y positions to park the cursor after the menu has been drawn on the screen. | ||
+ | === Menu Types === | ||
+ | ^Type^Description^ | ||
+ | |Standard|Uses the standard displayed menu| | ||
+ | |Lightbar|The LightBar High and LightBar Low text can be placed anywhere on the screen| | ||
+ | |Lightbar/ | ||
+ | |Lightbar/ | ||
+ | |||
+ | === Option Editor === | ||
+ | The Option Editor is used for editing the individual menu options. | ||
+ | < | ||
+ | █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Option | ||
+ | █ Display Text │ █ | ||
+ | █ LightBar Low │ █ | ||
+ | █ LightBar High │ █ | ||
+ | █ Hot Key │ Q █ | ||
+ | █ Access | ||
+ | █ Display Type │ Access | ||
+ | █ X Y │ 0 0 | ||
+ | █ Timer │ 0 Right │ 0 | ||
+ | █ Timer Type │ Interval | ||
+ | █ Command ────────────────── Access ───── Data ───────────────────────────── | ||
+ | █ (GO) Go to new menu | ||
+ | █ ░ | ||
+ | █ ░ | ||
+ | █ ░ | ||
+ | █ █ | ||
+ | ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (TAB) to edit menu commands ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ | ||
+ | </ | ||
+ | |||
+ | * **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 (deselected). | ||
+ | |||
+ | * **Lightbar High** - The text that is displayed when this lightbar menu option is hot (selected). | ||
+ | |||
+ | * **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 menu option. | ||
+ | |||
+ | A list of menu commands can be found in the [[menu_commands|Menu Command Reference]] | ||
+ | |||
+ | < | ||
+ | █▀▀▀▀▀▀▀▀▀▀▀▀▀ Menu (prelogin) Command #1 ▀▀▀▀▀▀▀▀▀▀▀▀▀▄ | ||
+ | █ █ | ||
+ | █ Command │ (GO) Go to new menu █ | ||
+ | █ Data │ main █ | ||
+ | █ | ||
+ | █ Execute │ Select | ||
+ | █ █ | ||
+ | ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ | ||
+ | </ | ||
+ | |||
+ | * **Command** - Select from a pick list of available menu commands. | ||
+ | * **Data** - The optional data field to use for menu commands that require more information to execute. | ||
+ | * **Access** - The access string (ACS) that the user must meet in order to execute this menu command. | ||
+ | * **Execute** - Used only for Grid style menus. | ||
+ | |||
+ | ----- | ||
+ | ===== CREATING STANDARD MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== CREATING LIGHTBAR MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== CREATING GRID MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== CREATING PROMPT MENU ===== | ||
+ | |||
+ | ----- | ||
+ | ===== AUTO-EXECUTION ===== | ||
+ | |||
+ | ----- | ||
+ | ===== OPTION CHAINING ===== | ||
+ | |||
+ | ----- | ||
+ | ===== TIMER EVENTS ===== | ||
+ | |||
+ | ----- | ||
+ | ===== COMMAND BRANCHING ===== |
menus.1468524043.txt.gz · Last modified: 2016/07/14 14:20 by gryphon