annotate examples/sample-plugin.js @ 1009:637a98de3910

misc: add more examples
author David Demelier <markand@malikania.fr>
date Wed, 17 Feb 2021 19:45:00 +0100
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1009
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 * This is a sample plugin in Javascript API.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
4
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 * This is the plugin identifier, every variable are optional.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 info = {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 author: "David Demelier <markand@malikania.fr>",
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 license: "ISC",
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 summary: "Crazy module for asking a medium",
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 version: "@IRCCD_VERSION@"
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
13 };
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
14
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
16 * Called when the user invoke the plugin using its identifier and the server
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 * prefix.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
18 *
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 * Example: !example foo bar baz
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
21 function onCommand(server, origin, channel, message)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
22 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
23 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
24
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 * Called when a server successfully connect and identifies to a IRC server.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
27 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 function onConnect(server)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
31
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 * Called when a server disconnection is detected.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 function onDisconnect(server)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
38
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
39 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 * Called when someone invites the bot on a channel.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
42 function onInvite(server, origin, channel)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
45
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 * Called when someones join a channel (the bot included).
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 function onJoin(server, origin, channel)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
52
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 * Called when a someone was kicked from a channel.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 function onKick(server, origin, channel, reason)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
59
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 * Called when a plugin is being loaded. Never happens from IRC.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
63 function onLoad()
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
65 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
66
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 * Called when a special CTCP ACTION (/me) is received.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
69 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 function onMe(server, origin, channel, message)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
73
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
74 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 * Called when a message has been received.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
77 function onMessage(server, origin, channel, message)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
78 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
79 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
80
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
81 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 * Called when a user/channel mode change. The channel can be the bot nickname.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
83 * The args is a list of string containing mode arguments.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
84 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
85 function onMode(server, origin, channel, args)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
86 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
87 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
88
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
89 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
90 * Called when a list of names have been received.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
91 *
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
92 * Note: in contrast to the IRC names listing, the names are not prefixed with
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
93 * their optional channel mode (e.g. @+ etc).
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
94 *
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
95 * Tip: using this event is no longer necessary starting from irccd 4, the bot
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
96 * keeps track of users of every channel it is present and can be accessed
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
97 * through the method Irccd.Server.prototype.info.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
98 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
99 function onNames(server, channel, names)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
101 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
102
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
103 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
104 * Called when a nickname change.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
105 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
106 function onNick(server, origin, nickname)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
108 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
109
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
110 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
111 * Called when a notice is received. The channel can be the bot nickname as
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
112 * well.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
113 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
114 function onNotice(server, origin, channel, notice)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
115 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
116 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
117
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
118 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
119 * Called when someone leaves a channel.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
120 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
121 function onPart(server, origin, channel, reason)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
122 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
123 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
124
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
125 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
126 * Called when the user request a plugin reload. Never happens from IRC.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
127 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
128 function onReload()
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
129 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
130 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
131
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
132 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
133 * Called when a topic change.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
134 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
135 function onTopic(server, origin, channel, topic)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
136 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
137 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
138
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
139 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
140 * Called when the plugin is about to be removed. Never happens from IRC.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
141 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
142 function onUnload()
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
143 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
144 }
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
145
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
146 /*
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
147 * Called when a whois information has been received. This function is usually
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
148 * never called unless the plugin explicitly calls Irccd.Server.prototype.whois
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
149 * beforehand.
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
150 */
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
151 function onWhois(server, info)
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
152 {
637a98de3910 misc: add more examples
David Demelier <markand@malikania.fr>
parents:
diff changeset
153 }