annotate mod_pastebin.wiki @ 136:927270e0b963

Updated config options and compatibility section.
author MWild1
date Wed, 30 Jun 2010 07:14:38 +0000
parents 7996062e839e
children d88da0ded786
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
1 #summary Redirect long messages to built-in pastebin
136
927270e0b963 Updated config options and compatibility section.
MWild1
parents: 43
diff changeset
2 #labels Stage-Stable
8
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
3
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
4 = Introduction =
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
5
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
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.
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
7
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
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!
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
9
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
10 = Details =
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
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
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
13
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
14 = Usage =
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
15
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
16 Load mod_pastebin onto the MUC component (interestingly it can also be loaded on normal hosts and it will intercept standard chat messages).
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
17
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
18 For example:
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
19 {{{
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
20 Component "conference.example.com" "muc"
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
21 modules_enabled = { "pastebin" }
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
22 }}}
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
23
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
24 = Configuration =
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
25 ||pastebin_ports||List of ports to run the HTTP server on, same format as mod_httpserver's http_ports||
136
927270e0b963 Updated config options and compatibility section.
MWild1
parents: 43
diff changeset
26 ||pastebin_threshold||Maximum length (in characters) of a message that is allowed to skip the pastebin. (default 500 characters)||
927270e0b963 Updated config options and compatibility section.
MWild1
parents: 43
diff changeset
27 ||pastebin_line_threshold||The maximum number of lines a message may have before it is sent to the pastebin. (default 4 lines)||
927270e0b963 Updated config options and compatibility section.
MWild1
parents: 43
diff changeset
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
a82fbbe28ae0 Added description of pastebin_url config option
MWild1
parents: 27
diff changeset
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
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
31
20
44fe50bac580 Added compatibility section
MWild1
parents: 19
diff changeset
32 = Compatibility =
136
927270e0b963 Updated config options and compatibility section.
MWild1
parents: 43
diff changeset
33 ||0.7||Works||
20
44fe50bac580 Added compatibility section
MWild1
parents: 19
diff changeset
34 ||0.6||Works||
44fe50bac580 Added compatibility section
MWild1
parents: 19
diff changeset
35
8
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
36 = Todo =
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
37
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
38 * Maximum paste length
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
39 * Web interface to submit pastes?