Lightbox for image attachments
JavaScript CSS Ruby HTML
Pull request Compare This branch is 47 commits ahead, 61 commits behind paginagmbh:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
assets
config
db/migrate
doc
lib
test
.gitignore
.travis.yml
LICENSE.md
README.md
init.rb

README.md

Redmine Lightbox Plugin

Build Status Code Climate

This plugin enables you to preview the files attached to issues in Redmine. The plugin currently supports various image (.png, .jpg, .gif, .swf, etc.) and document (,pdf, .docx, .doc, .rtf) formats.

Compatibility

This plugin version is compatible only with Redmine 3.x and later.

Installation

  1. To install the plugin

    • Download the .ZIP archive, extract files and copy the plugin directory into #{REDMINE_ROOT}/plugins.

    Or

    • Change you current directory to your Redmine root directory:

        cd {REDMINE_ROOT}
      

      Copy the plugin from GitHub using the following commands:

        git clone https://github.com/Restream/redmine_lightbox.git plugins/redmine_lightbox
      
  2. Install the required dependencies

    On Debian Linux:

     sudo apt-get install libreoffice-common unoconv
    

    On MacOS:

     brew install unoconv --HEAD
    

    Note: In order to use unoconv on MacOS, a copy of LibreOffice between versions 3.6.0.1 - 4.3.x must be installed.

  3. Install the required gems using the command:

     bundle install  
    
  4. These plugins require a migration. Run the following command to upgrade your database (make a database backup before):

     bundle exec rake redmine:plugins:migrate RAILS_ENV=production
    
  5. Restart Redmine.

Usage

The plugins adds an 🔎 icon next to issue attachments that can be previewed.
preview icon

Clicking the icon opens a pop-up window where you can preview the attachment. If there are several files attached to the issue, you can proceed to the next attachment by clicking the arrow button. preview pop-up

You can view ordinary images: preview pop-up-image

Text files also can be previewed: preview pop-up-text

Author

This repo is fork from https://github.com/zipme/redmine_lightbox. And author of original repo is https://github.com/zipme

Maintainers

Danil Tashkinov, github.com/nodecarter

License

This plugin is published under the MIT license.