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

= Redirect to raw format for PDF attachments

== Description

This plugin produces links to PDF attachments to go directly to the raw file, rather than the preview page and which doesn't actually preview the file. As a typical use case, upload a PDF and click on it. You will be able to download it immediately instead of having to click through the preview page.

To delete attachments, you'll need to enter an explicit URL: `/attachment/realm/id/filename.pdf?action=delete`.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

You can check out PdfRedirectorPlugin from [/svn/pdfredirectorplugin here] using Subversion, or [source:pdfredirectorplugin browse the source] with Trac.

== Installation

Installation directly from the Subversion repository:

{{{#!sh
pip install svn+https://trac-hacks.org/svn/pdfredirectorplugin/trunk/
}}}

For more info see [t:TracPlugins].

== Configuration

If you want the PDF to render in the browser, you'll need to make the following configuration changes in your `trac.ini` file:
{{{#!ini
[attachments]
render_unsafe_content = true

[browser]
render_unsafe_content = true
}}}

== Recent Changes

[[ChangeLog(pdfredirectorplugin, 3)]]

== Author/Contributors

Developed at [http://openplans.org The Open Planning Project].

'''Author:''' [wiki:nicholasbs] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [wiki:k0s], rjollos, hasienda