Mercurial > prosody-wiki
annotate mod_pastebin.wiki @ 149:4616d70c974a
Edited wiki page through web user interface.
author | shinysky1986@gmail.com |
---|---|
date | Fri, 13 Aug 2010 13:24:32 +0000 |
parents | d88da0ded786 |
children | 000cd449e801 |
rev | line source |
---|---|
8 | 1 #summary Redirect long messages to built-in pastebin |
136 | 2 #labels Stage-Stable |
8 | 3 |
4 = Introduction = | |
5 | |
6 Pastebins are used very often in IM, especially in chat rooms. You have a long log or command output which you need to send to someone over IM, and don't want to fill their message window with it. Put it on a pastebin site, and give them the URL instead, simple. | |
7 | |
8 Not for everyone... no matter how hard you try, people will be unaware, or not care. They may also be too lazy to visit a pastebin. This is where mod_pastebin comes in! | |
9 | |
10 = Details = | |
11 | |
19
936f87fe73e6
Updated todo and instructions for new pastebin_threshold option
MWild1
parents:
8
diff
changeset
|
12 When someone posts to a room a "large" (configurable) message, Prosody will intercept the message and convert it to a URL pointing to a built-in pastebin server. The URLs are randomly generated, so they can be considered for most purposes to be private, and cannot be discovered by people who are not in the room. |
8 | 13 |
14 = Usage = | |
15 | |
138
d88da0ded786
Clarify that mod_pastebin must be loaded especially for components
MWild1
parents:
136
diff
changeset
|
16 To set up mod_pastebin for MUC rooms it *must* be explicitly loaded, as in the example below - it won't work when loaded globally, as that will only load it onto normal virtual hosts. |
8 | 17 |
18 For example: | |
19 {{{ | |
20 Component "conference.example.com" "muc" | |
21 modules_enabled = { "pastebin" } | |
22 }}} | |
23 | |
24 = Configuration = | |
25 ||pastebin_ports||List of ports to run the HTTP server on, same format as mod_httpserver's http_ports|| | |
136 | 26 ||pastebin_threshold||Maximum length (in characters) of a message that is allowed to skip the pastebin. (default 500 characters)|| |
27 ||pastebin_line_threshold||The maximum number of lines a message may have before it is sent to the pastebin. (default 4 lines)|| | |
28 ||pastebin_trigger||A string of characters (e.g. "!paste ") which if detected at the start of a message, always sends the message to the pastebin, regardless of length. (default: not set)|| | |
40 | 29 ||pastebin_url||Base URL to display for pastebin links, must end with / and redirect to Prosody's built-in HTTP server|| |
43
7996062e839e
Added info about pastebin_expire_after and updated the todo
MWild1
parents:
40
diff
changeset
|
30 ||pastebin_expire_after||Number of hours after which to expire (remove) a paste, defaults to 24|| |
8 | 31 |
20 | 32 = Compatibility = |
136 | 33 ||0.7||Works|| |
20 | 34 ||0.6||Works|| |
35 | |
8 | 36 = Todo = |
37 | |
38 * Maximum paste length | |
39 * Web interface to submit pastes? |