# NAME

RT::Extension::AttachmentViewer - View full size attachments from the dropzone

# DESCRIPTION

By default, when attachments are to be uploaded in RT, the dropzone where they are added shows a thubmbnail. This extension enhances the attachment dropzone in RT by allowing users to click on a file preview to display it in a modal viewer. It supports images, PDFs, audio, HTML, and text files. Other file types are opened using the browser's default behavior.

# RT VERSION

Works with RT 5 and RT 6.

# INSTALLATION

- export `$RTHOME=/home/of/your/RT/installation/lib`

    This is needed if your `RT` installation directory is not `/opt/rt6/` for RT 6 nor C/opt/rt5/> for RT 5.

- `perl Makefile.PL`
- `make`
- `make install`

    May need root permissions

- Edit your `RT_SiteConfig.pm` (usually located in /opt/rt5/etc or /opt/rt6/etc)

    Add this line:

        Plugin('RT::Extension::AttachmentViewer');

    or add `RT::Extension::AttachmentViewer` to your existing `@Plugins` line.

- Clear your mason cache

        rm -rf /opt/rt6/var/mason_data/obj

- Restart your webserver

# AUTHOR

Gérald Sédrati <gibus@easter-eggs.com>

# REPOSITORY

[https://github.com/gibus/RT-Extension-AttachmentViewer](https://github.com/gibus/RT-Extension-AttachmentViewer)

# BUGS

All bugs should be reported via email to

[bug-RT-Extension-AttachmentViewer@rt.cpan.org](mailto:bug-RT-Extension-AttachmentViewer@rt.cpan.org)

or via the web at

[rt.cpan.org](http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-AttachmentViewer).

# LICENSE AND COPYRIGHT

This software is Copyright (c) 2026 by Gérald Sédrati, Easter-Eggs

This is free software, licensed under:

The GNU General Public License, Version 3, June 2007
