view mod_pastebin.wiki @ 40:a82fbbe28ae0

Added description of pastebin_url config option
author MWild1
date Thu, 01 Oct 2009 23:34:39 +0000
parents 0986c59fce05
children 7996062e839e
line wrap: on
line source

#summary Redirect long messages to built-in pastebin
#labels Stage-Beta

= Introduction =

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.

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!

= Details =

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.

= Usage =

Load mod_pastebin onto the MUC component (interestingly it can also be loaded on normal hosts and it will intercept standard chat messages).

For example:
{{{
Component "conference.example.com" "muc"
    modules_enabled = { "pastebin" }
}}}

= Configuration =
||pastebin_ports||List of ports to run the HTTP server on, same format as mod_httpserver's http_ports||
||pastebin_threshold||Minimum length (in characters) of a message to be sent to the pastebin (default 500 characters)||
||pastebin_url||Base URL to display for pastebin links, must end with / and redirect to Prosody's built-in HTTP server||

= Compatibility =
||0.6||Works||
||0.5||Works||

= Todo =

  * Expire pastes
  * Maximum paste length
  * Web interface to submit pastes?