h1. Redmine clipboard_image_paste plugin

Paste (cropped) image from clipboard as an attachment.

!https://raw.github.com/peclik/clipboard_image_paste/master/suppl/cbp_logo.png!

• uses pure client side JavaScript

• attachment works for issues, wiki, news, files, documents, forums

• image can be interactively cropped

• tested 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

h2. Installation:

• download one of: latest release zip: https://github.com/peclik/clipboard_image_paste/archive/v1.13.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)
• restart Redmine instance
• it's recommended to install RMagick gem, otherwise attached images will not show in exported PDF files

h2. Compatibility:

• Redmine up to 3.4.x, 2.x, 1.4.x
• tested only in Google Chrome, Mozilla Firefox and the last versions of Internet Explorer (11+)
• plug-ins taking advantage of clipboard_image_paste: ** KbArticle [https://github.com/alexbevi/redmine_knowledgebase]

h2. 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]
• AThomsen (Danish translation) [https://github.com/AThomsen]
• Iku Iwasa (Firefox 63 compatibility fix) [https://github.com/iquiw]
• Tomohisa Kusukawa (redmine_s3 plugin compatiblity fix) [https://github.com/tkusukawa]
• Kirill Smirnov (pictrue-id generation fix) [https://github.com/KirillSmirnov]

h2. Known issues:

• thumbnails using @{{thumbnail}}@ macro will not be shown in exported PDFs (Redmine's PDF export limit - see http://www.redmine.org/issues/13051, https://www.redmine.org/issues/15296)
• 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 attachments 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 (but PrintScreen + Paste usually works)
• Redmine 2.5 and older: 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)
• see Compatibility section for incompatible plug-ins

h2. Changelog:

08.11.2018 RELEASED 1.13
[!] compatibility with Firefox 63+ using HTTPS connection
[-] compatibility with redmine_s3 plugin

28.06.2017 RELEASED 1.12
[!] Redmine 3.4 compatible
[-] Corrected improper use of the tag 


28.06.2017 RELEASED 1.11
[+] Don't remove alpha channel from PNG image for Redmine 2.6+
[+] Added Danish translation

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