Project

General

Profile

Scripting Menus » History » Revision 18

Revision 17 (Per Amundsen, 08/26/2015 07:25 AM) → Revision 18/52 (Per Amundsen, 08/26/2015 07:25 AM)

{{>toc}} 

 h1. Scripting Menus 

 You can edit most AdiIRC menus in the Menu Editor located at Tools -> Edit Menus. 

 Status - Edit the status menus. 
 Channel - Edit the channel menus. 
 Query - Edit the query menus. 
 Nicklist - Edit the nicklist menus. 
 Menubar - Edit the menubar menus. 

 A menu syntax consists of Menu text<colon>Menu command. 

 For this reason, only one colon is allowed in a menu, neither the text nor the command can contain any other colons for the menu to work properly. 

 *Example* 

 <pre> 
 ; Add a new menu item with the text "Query", when clicked, execute "/query $1" where $1 means the first word given to this menu, usually a nick. 
 Query:/query $1 
 </pre> 

 h2. Menu prefix 

 The "menu" prefix can also be used in a custom script to add more items to a menu. 

 *Example* 

 <pre> 
 ;Add a new menu item with the text "Whois", when clicked execute "/whois $1". 
 menu nicklist { 
   Whois:/whois $1 
 } 
 </pre> 

 h2. Target multiple menus 

 Multiple menus can be targeted with the same menu item by separating them with comma. 

 *Example* 

 <pre> 
 ;Add a new menu item for nicklist and channels with the text "Hello World", when clicked execute "/echo -ag Hello World". 
 menu nicklist,channel { 
   Hello World/echo -ag Hello World 
 } 
 </pre> 

 h2. Menu hierarchy 

 The menu hierarchy is determined by punctuation marks. 

 This works in both the Menu Editor and in a custom script using the Menu prefix. 

 *Example* 

 <pre> 
 menu nicklist { 
   ;Create a upper menu item called "Tools", notice you don't need a colon for the upper menu. 
   Tools 

   ;Use a punctuation mark to put a sub menu item inside "Tools" 
   .Whois:/whois $1 

   ;Use a punctuation mark to put another sub menu item inside "Tools" 
   .Who:/who $1 

   ;Create another upper menu item called "Operate" 
   Operate 

   ;Use a punctuation mark to put a sub menu item inside "Operate" 
   .Kill:kill $1 

   ;Create a sub menu item called "Operate More" inside "Operate" 
   .Operate More 

   ;Use two punctuation marks to put a sub menu item inside "Operate More" 
   ..Kill again:kill $1 
 } 
 </pre> 

 h2. Separator 

 Hyphen (-) can be used to add a menu separator. 

 *Example* 

 <pre> 
 menu nicklist { 
   ;Create a upper menu item called "Tools" 
   Tools 

   ;Add a separator 
   - 

   ;Create another upper menu item called "More Tools" 
   More Tools 
 } 
 </pre> 


 h2. $1- lines inside menus 

 $1- will be filled with different words depending on the menu type. 

 Status - The currently connected [[$network]] name. 
 Channel - The current [[$chan]] name. 
 Query - The [[$nick]] associated with the query window. 
 Nicklist - A list of selected nicks in the nicklist. 
 Menubar - Your nick ([[$me]]) on currently connected server. 

 h2. Adding top menus 

 As of AdiIRC 1.9.7 new top menus can be inserted in the Menubar after the "Help" item using the [[/menubar]] command. 

 Regular scripted menus can be used by referencing the name, e.g "menu mymenu { }"