README.textile

Redmine clipboard_image_paste plugin

Paste (cropped) image from clipboard as an attachment.

• uses pure client side JavaScript
• attachment works for issues, wiki, news, files, documents, forums
• image can be interactively cropped
• works only in Google Chrome, Mozilla Firefox and the last versions of Internet Explorer (>=11)
• translations: Bulgarian, Czech, English, French, German, Italian, Japanese, Korean, Polish, Portuguese (+ Brazil), Russian, Simplified Chinese, Spanish, Taiwanese Mandarin, Turkish

• homepage: https://github.com/peclik/clipboard_image_paste
• Redmine page: http://www.redmine.org/plugins/clipboard_image_paste

---

Installation:

• download one of:
  • latest release zip: https://github.com/peclik/clipboard_image_paste/archive/v1.9.zip
  • development zip: https://github.com/peclik/clipboard_image_paste/archive/master.zip
  • git: git clone https://github.com/peclik/clipboard_image_paste.git plugins/clipboard_image_paste
• place plugin files into plugins/clipboard_image_paste folder (strip possible -master or -version suffix)
• it’s recommended to install RMagick gem, otherwise attached images will not show in exported PDF files

---

Compatibility:

• Redmine 3.0.x, 2.x, 1.4.x
• works only in Google Chrome, Mozilla Firefox and the last versions of Internet Explorer (>=11)
• tested on Chrome 40, 24, 15, 13 and Firefox 35, 24, 18, 16, 5
• plug-ins taking advantage of clipboard_image_paste:
  • KbArticle [https://github.com/alexbevi/redmine_knowledgebase]
• incompatible plug-ins (not working together with clipboard_image_paste):
  • LaTeX MathJax [https://github.com/process91/redmine_latex_mathjax]

---

Authors:

• Richard Pecl [https://github.com/peclik]
• used clipboard handler snippet by Joel Besada
• used uploaded image data to file object conversion
  code snippet by Alexandr Ivanov
• used jQuery, jQuery UI and Jcrop javascript libraries
• Ivan Cenov (Bulgarian translation) [https://github.com/jwalkerbg]
• AlexStein (Russian translation) [https://github.com/AlexStein]
• octane100 (French translation) [https://github.com/octane100]
• Karsten Hoffrath (German translation) [https://github.com/khoffrath]
• ks780 (Turkish translation) [https://github.com/ks780]
• Daigo Uchiyama (Japanese translation) [https://github.com/ucho]
• jaelys (Taiwanese Mandarin translation) [https://github.com/jaelys]
• beandj (Brazilian Portuguese translation) [https://github.com/beandj]
• Yuri Tkachenko (2.3 compatibility fix) [https://github.com/tamtamchik]
• Mo Di (Simplified Chinese translation) [https://github.com/modi]
• Ezequiel Gonzalez Rial (Spanish translation) [https://github.com/ezequielgonzalez]
• Patricia Sz. (Polish translation) [https://github.com/papisz]
• R-i-c-k-y (Italian translation) [https://github.com/R-i-c-k-y]
• battlej (Korean translation) [https://github.com/battlej]
• Miguel Borges (Portuguese translation) [https://github.com/mapb1990]
• ilya-tcykunov (IE 11 compatibility) [https://github.com/ilya-tcykunov]
• Ben305 (JCrop patch for Redmine 3.0) [https://github.com/Ben305]
• mouson (Taiwanese Mandarin translation update) [https://github.com/mouson]

---

Known issues:

• attached image will be visibile in exported PDFs only if RMagick is installed
  (this is a limit of PDF export in Redmine – alpha channel must be removed from
  png image; this has been fixed in Redmine 2.6)
• thumbnails using {{thumbnail}} macro will not be shown in exported PDFs
  (another Redmine’s PDF export limit – see http://www.redmine.org/issues/13051)
• maximum attachment size is checked against BASE64 encoded image data (even
  smaller images than the maximum allowed attachment size can be rejected)
• clipboard_image_paste’s ‘Add picture from clipboard’ command combines number
  of both regular files and pasted images for maximum number of attachment check,
  while Redmine’s original ‘Add another file’ counts only regular files
• ability to copy&paste images from clipboard depends on browsers capabilities
  – some browsers don’t support all image formats in the clipboard
• see Compatibility section for incompatible plug-ins

---

Changelog:

07.03.2015 RELEASED 1.10
[!] Redmine 3.0 compatible
[-] JCrop patch for compatibility with jQuery used in Redmine 3.0
[*] Taiwanese Mandarin translation updated

24.10.2014 RELEASED 1.9
[!] Redmine 2.6 compatible
[!] Internet Explorer 11 compatible
[!] Jcrop upgraded to 0.9.12
[+] Added Portuguese translation

22.10.2013 RELEASED 1.8
[-] Attached images are visible in exported PDF files (requires RMagick gem)
[+] Added support for KbArticle plug-in

27.06.2013 RELEASED 1.7
[-] JavaScript fix for Firefox 22 compatibility
[+] Added Korean translation

09.05.2013 RELEASED 1.6
[+] Added Italian, Polish, Simplified Chinese, Spanish translations

22.03.2013 RELEASED 1.5
[!] Redmine 2.3 compatible
[*] JavaScript/JQuery fix for Redmine 2.3 compatibility
[+] Added Brazilian Portuguese translation

06.03.2013 RELEASED 1.4
[+] Added German, Japanese, Taiwanese Mandarin, Turkish translations

25.01.2013 RELEASED 1.3
[+] Added French translation

22.01.2013 RELEASED 1.2
[+] Added dialog to copy image link for wiki

21.01.2013 RELEASED 1.1
[!] Supports Redmine version 1.4.0 to 2.2.x
[+] Added Russian translation

18.01.2013 RELEASED 1.0
--------------------------------------------------------------------------------
Legend:
[+] Added feature
[*] Improved/changed feature
[-] Bug fixed (we hope)
[!] Important info