Scripting Menus » History » Revision 13
Revision 12 (Per Amundsen, 03/29/2014 09:10 PM) → Revision 13/52 (Per Amundsen, 03/29/2014 09:11 PM)
*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>
*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>
*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>
*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 mark to put a sub menu item inside "Operate More"
..Kill again:kill $1
}
</pre>
*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>
*$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.