This is an old revision of the document!
Menus
Menu Editor
The BBS menus are the core of the BBS system. It is where all BBS commands and functions available to the user are defined and setup. Mystic BBS supports an unlimited number of defined menus which can be setup in any way, allowing a totally customizable and unique interface to the user.
When first entering the menu editor, you will be prompted to select which language definition you'd like to edit. It is possible to have different sets of menus for each language!
After you've selected the theme you'd like to edit, you will be shown the main menu selection screen:
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Menu Editor (Default) ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ █ Menu Name Description █ █ ───────────────────────────────────────────────────── █ █ account Account change ▓ █ autosig Edit auto signature menu ░ █ bbslist BBS list menu ░ █ demos Demos of various things ░ █ doors Example doors/games menu ░ █ file File base menu ░ █ flist Download file list menu ░ █ fnewscan Scan for new files menu ░ █ fqueue File queue editor menu ░ █ goodbye Logoff menu ░ █ ───────────────────────────────────────────────────── █ █ Press / for command list █ ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
- Select Slash (⁄) to see the Insert, Delete or Copy individual menus
- Highlight any menu and hit ENTER to modify it.
Command List
This view will show the list of commands that this menu contains.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Command list (account) ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ █ HotKey Text ID Exe █ █ ──────────────────────────────────────────────────────────── █ █ A (A) Address -> 1 1 ▓ █ B (B) City/State -> 2 1 ░ █ C (C) Zip Code -> 3 1 ░ █ D (D) Home Phone -> 4 1 ░ █ E (E) Data Phone -> 5 1 ░ █ F (F) E-mail Address -> 6 1 ░ █ G (G) Password -> [not shown 7 1 ░ █ H (H) Screen Length -> 8 1 ░ █ I (I) Graphics Mode -> 9 1 ░ █ J (J) Date Format -> 10 1 ░ █ ──────────────────────────────────────────────────────────── █ █ Press / for command list █ ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
- Highlight and hit ENTER to select a command
- Use the slash (⁄) key to see a menu of more options.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ █ S Settings █ █ I Insert █ █ D Delete █ █ C Copy █ █ P Paste █ █ V View █ ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
- Insert - Insert a new command
- Delete - Delete the highlighted command
- Copy - Copy the highlighted command
- Paste - Paste the copied command
- View - View the generated menu.
- Settings - Adjust the settings of the menu
Menu settings
This menu will allow for the adjustment of many different features of the menu.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Menu Settings (account) ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄ █ █ █ Description │ Account change █ █ Access │ s10 █ █ Fallback │ █ █ Menu Type │ Standard █ █ Input Type │ User Defined █ █ Input Chars │ Uppercase █ █ Use Global │ No █ █ Node Status │ █ █ Display File │ █ █ Display Cols │ 1 █ █ Menu Header │ |CL ▒ Account Settings for |$R55|UH|CR █ █ Menu Prompt │ |CRCommand (Q/Quit) -> █ █ X │ 0 █ █ Y │ 0 █ ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
- Description - Set the description of the Menu as seen in the Menu List.
- Access - Set the ACS level for the menu
- Fallback - <optional> Define a fallback menu if this menu is not available
- Menu Type - Select either Standard, Lightbar, Lightbar/Grid, or Lightbar/Prompt
- Input Type - Select either User Defined, HotKey, or LongKey
- Input Chars - Select Uppercase, Lowercase or Hidden
- Use Global - Select whether or not to append the global menu to this menu
- Node Status - <optional> Text to display in the node status when a user is in this menu
- Display File- The display file to use for this menu. The default location for the file is in the TEXT directory.
- Display Cols- Select how many columns the generated menu will use when displaying menu options. The options are 1-9, or H for Hidden. The H option will not display any generated menu options on the screen.
- Menu Header - <optional> Define the header for the generated menu. All MCI codes are available for use.
- Menu Prompt - <optional> Defines the prompt to use for the generated menu. All MCI codes are available for use.
- X,Y - The X and Y positions to park the cursor after the menu has been drawn on the screen. These are only used in the Lightbar-type Menu types.
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/Prompt | Searchlight-style. The menu options can be scrolled through at just the prompt location. |
Lightbar/Grid | Allow you to define the jumps between menu commands based on the key input. It is more complicated to set up but if you wanted to make a more complex interface. The Up, Down, Left, Right, Home, Escape, Tab, PageUp PageDown and End Fields link to the command# in menu. Selecting one of those keys will move the lightbar to that command. |
Command Editor
The Command Editor is used for editing the individual commands.
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀ Command #20 (account) ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄t █ Display Text │ █ █ LightBar Low │ █ █ LightBar High │ █ █ Hot Key │ Q █ █ Access │ Up │ 0 Escape │ 0 █ █ Display Type │ Access Down │ 0 Tab │ 0 █ █ X Y │ 0 0 Left │ 0 PageUp │ 0 █ █ Timer │ 0 Right │ 0 PageDn │ 0 █ █ Timer Type │ Interval Redraw │ Yes Home │ 0 End │ 0 █ █ Command ────────────────── Access ───── Data ───────────────────────────── █ █ (GO) Go to new menu main ▓ █ ░ █ ░ █ ░ █ █ ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄ (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.
- Lightbar High- The text that is displayed when this lightbar menu option is hot.
- Hot Key - The keyboard keys that will activate this command. There are many automatic
- 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. Select (TAB) to toggle between the command metadata menu and the list of sub-commands for this command.
Sub Command Editor
Many sub commands can be stacked in one menu command. The sub commands will be activated in serial order when the menu command is activated. This allows for multiple actions for one menu command.
█▀▀▀▀▀▀▀▀▀▀▀▀▀ Menu (prelogin) Command #1 ▀▀▀▀▀▀▀▀▀▀▀▀▀▄ █ █ █ Command │ (GO) Go to new menu █ █ Data │ main █ █ Access │ █ █ Execute │ Select █ █ █ ▀▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
Command
Select from a picklist of available menu commands.
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. Used only on Lightbar/Grid menus.