Mercurial > irccd
annotate plugins/history/history.md @ 389:4379c48cfd15
Misc: add missing sysconfig.hpp to detect WITH_SSL
| author | David Demelier <markand@malikania.fr> |
|---|---|
| date | Thu, 22 Dec 2016 14:23:47 +0100 |
| parents | c143682678b9 |
| children | 224e5cc2d243 |
| rev | line source |
|---|---|
| 0 | 1 --- |
| 2 title: "History plugin" | |
| 3 header: "History plugin" | |
|
275
c143682678b9
CMake: improve documentation related to plugins
David Demelier <markand@malikania.fr>
parents:
156
diff
changeset
|
4 guide: yes |
| 0 | 5 --- |
| 6 | |
| 7 The plugin **history** is used to check when someone has been seen for the last time on a channel. For that purpose, | |
| 8 irccd needs to be on that channel forever if possible. | |
| 9 | |
| 10 ## Installation | |
| 11 | |
| 12 The plugin **history** is distributed with irccd. To enable it add the following to your `plugins` section: | |
| 13 | |
| 14 ````ini | |
| 15 [plugins] | |
| 16 history = "" | |
| 17 ```` | |
| 18 | |
| 19 ## Usage | |
| 20 | |
| 21 The plugin **history** only reacts to the special command. It understands `seen` and `said` sub commands. | |
| 22 | |
| 23 - The sub command `seen` tells you when the user has been seen for the last time. | |
| 24 - The sub command `said` tells you what the user has said for the last time. | |
| 25 | |
| 26 Example: | |
| 27 | |
|
20
8384df86e195
Docs: use nohighlight on non code, #418
David Demelier <markand@malikania.fr>
parents:
0
diff
changeset
|
28 ````nohighlight |
|
8384df86e195
Docs: use nohighlight on non code, #418
David Demelier <markand@malikania.fr>
parents:
0
diff
changeset
|
29 markand: !history seen jean |
|
8384df86e195
Docs: use nohighlight on non code, #418
David Demelier <markand@malikania.fr>
parents:
0
diff
changeset
|
30 irccd: markand, the last time I've seen jean was on 18/01/1989 at 20:55 |
|
8384df86e195
Docs: use nohighlight on non code, #418
David Demelier <markand@malikania.fr>
parents:
0
diff
changeset
|
31 markand: !history said jean |
|
8384df86e195
Docs: use nohighlight on non code, #418
David Demelier <markand@malikania.fr>
parents:
0
diff
changeset
|
32 irccd: markand, the last thing that jean said was: hello world |
|
8384df86e195
Docs: use nohighlight on non code, #418
David Demelier <markand@malikania.fr>
parents:
0
diff
changeset
|
33 ```` |
| 0 | 34 |
| 35 ## Configuration | |
| 36 | |
| 37 The following options are available under the `[plugin.history]` section: | |
| 38 | |
| 31 | 39 - **file**: (string) path to the JSON file for saving information (Optional, default to cache directory). |
|
143
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
40 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
41 **Deprecated in irccd 2.1.0:** |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
42 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
43 - **format-error**: Use `[format.history] error` instead, |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
44 - **format-seen**: Use `[format.history] seen` instead, |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
45 - **format-said**: Use `[format.history] said` instead, |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
46 - **format-unknown**: Use `[format.history] unknown` instead, |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
47 - **format-usage**: Use `[format.history] usage` instead. |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
48 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
49 ### Keywords supported |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
50 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
51 The following keywords are supported: |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
52 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
53 | Parameter | Keywords | |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
54 |-----------|-----------------| |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
55 | **file** | channel, server | |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
56 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
57 ## Formats |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
58 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
59 The **history** plugin supports the following formats in `[format.history]` section: |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
60 |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
61 - **error**: (string) format when an internal error occured, |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
62 - **seen**: (string) format for showing last seen, |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
63 - **said**: (string) format for showing the last message, |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
64 - **unknown**: (string) format when the user has never been seen, |
|
156
620ff1b794fd
Plugin history: fix typo
David Demelier <markand@malikania.fr>
parents:
143
diff
changeset
|
65 - **usage**: (string) format to show the plugin usage. |
| 0 | 66 |
| 31 | 67 <div class="panel panel-warning"> |
| 68 <div class="panel-heading">If you don't want to specify the **file** parameter, irccd will try to use the plugin cache | |
| 69 path, you must create it.</div> | |
| 70 <div class="panel-body"> | |
| 71 ````nohighlight | |
| 72 $ mkdir -p ~/.cache/irccd/plugin/history | |
| 73 ```` | |
| 74 </div> | |
| 75 </div> | |
| 76 | |
| 0 | 77 ### Keywords supported |
| 78 | |
| 79 The following keywords are supported: | |
| 80 | |
|
143
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
81 | Format | Keywords | Notes | |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
82 |-------------|----------------------------------------------------|------------------------------| |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
83 | (any) | channel, command, nickname, origin, plugin, server | | |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
84 | **seen** | target, (date) | target is the specified nick | |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
85 | **said** | message, target, (date) | | |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
86 | **unknown** | target | | |
| 0 | 87 |
| 88 Example: | |
| 89 | |
| 31 | 90 <div class="panel panel-info"> |
| 91 <div class="panel-heading">~/.config/irccd/irccd.conf</div> | |
| 92 <div class="panel-body"> | |
| 0 | 93 ````ini |
|
143
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
94 [format.history] |
|
11113212576c
Plugin history: use new format section, #410
David Demelier <markand@malikania.fr>
parents:
45
diff
changeset
|
95 seen = "#{target} has been seen on #{channel} the last time on: %d/%m/%Y %H:%M" |
| 0 | 96 ```` |
| 31 | 97 </div> |
| 98 </div> |