[[PageOutline(2-5,Contents,pullout)]]

= Add a pastebin component to Trac

== Description

This plugin adds a basic [http://en.wikipedia.org/wiki/Pastebin pastebin] functionality to a webpage. 

Key features:
 * Paste events are shown in the timeline
 * `paste` TracLinks
 * Pastes are searchable

Some additional features have been proposed:
 * Tags support (#6160)
 * Spam filter integration (#6144)
 * XmlRpcPlugin support (#6348)

Some screenshots are included below, using a heavily modified theme.

[[Image(pastebin_index.png, 50%, border=2)]]

[[Image(pastebin_file.png, 50%, border=2)]]

== Bugs/Feature Requests

Existing bugs and feature requests for TracPastePlugin are 
[report:9?COMPONENT=TracPastePlugin here].

If you have any issues, create a 
[/newticket?component=TracPastePlugin new ticket].

[[TicketQuery(component=TracPastePlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:tracpasteplugin here].

== Source

Check out TracPastePlugin from [/svn/tracpasteplugin here] using Subversion or [source:tracpasteplugin browse the source] with Trac.

== Installation

 1. Make sure the pypi:Pygments package is installed.
 1. Either: Download, build egg, drop into your plugins folder, [[BR]]
    or: `easy_install https://trac-hacks.org/svn/tracpasteplugin/trunk`.
 1. Enable it through WebAdmin or by adding the following to your `trac.ini` file:
 {{{#!ini
[components]
tracpaste.* = enabled
}}}
 1. Run `trac-admin $TRAC_ENV upgrade`.
 1. Restart web server.
 1. Add the permissions `PASTEBIN_VIEW`, `PASTEBIN_CREATE`, `PASTEBIN_DELETE` and `PASTEBIN_ADMIN` that you would like your users to have.
 1. The plugin menu item should now be visible on the main navigation bar and available under `/pastebin`.

== Recent Changes

[[ChangeLog(tracpasteplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:mitsuhiko] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [wiki:otaku42], [wiki:olemis], ejucovy