annotate mod_pastebin.wiki @ 30:0babb8d045e5

Added Stage-Stable
author MWild1
date Sat, 26 Sep 2009 00:23:43 +0000
parents 0986c59fce05
children a82fbbe28ae0
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
27
0986c59fce05 Add Stage-Beta
MWild1
parents: 20
diff changeset
2 #labels Stage-Beta
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||
19
936f87fe73e6 Updated todo and instructions for new pastebin_threshold option
MWild1
parents: 8
diff changeset
26 ||pastebin_threshold||Minimum length (in characters) of a message to be sent to the pastebin (default 500 characters)||
8
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
27
20
44fe50bac580 Added compatibility section
MWild1
parents: 19
diff changeset
28 = Compatibility =
44fe50bac580 Added compatibility section
MWild1
parents: 19
diff changeset
29 ||0.6||Works||
44fe50bac580 Added compatibility section
MWild1
parents: 19
diff changeset
30 ||0.5||Works||
44fe50bac580 Added compatibility section
MWild1
parents: 19
diff changeset
31
8
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
32 = Todo =
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
33
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
34 * Expire pastes
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
35 * Maximum paste length
310c9bbceb3d Created wiki page through web user interface.
MWild1
parents:
diff changeset
36 * Web interface to submit pastes?