Previously it was know as ImagePaste, but since version 4, I've renamed it in order to express that the plugin allows far more than just pasting images in CKEditor.
FeaturesThere is a wide number of enhancements performed, some might be subtle and useful for the developer, others are focused on the end user.
For the user
- Allows pasting an image directly into the document
- Allows drag&drop from the computer to the document
- Provides toolbar buttons to upload files and images with the minimum number of steps.
- Enhance the dialogs with drag&drop uploads
- Replace the QuickUpload option in the dialogs, now it only requires to select a file without any extra step
- Show upload progress and cancel, as well as preview of images or file size for documents
- Event to validate a file before the upload starts
- Easy configuration options to restrict allowed extensions and maximum file size
- Post-upload event to modify the element after it has been added to the editor
- Enable Cross Domain uploads with CORS.
- Include additional form data in the upload (for Anti-CSRF checks or to send custom field that you've added in a dialog)
An example of what can be done thanks to the plugin is the ImageCrop plugin that takes the images as they are being added to the editor and directly allows to resize them before uploading them to the server (although it also uses this API to edit existing images and add them again to the server)
Browser supportThe supported browsers are Chrome, Edge, Firefox and Internet Explorer. Safari is not officially supported because I would need to buy a new computer just to test it, that seems an expensive test for me. So some features might work and some not, as long as they follow the Chrome behavior then it should work.
All the common features will work with Chrome and Edge. Firefox is the only one that adds the ability to paste a file or image into the document by selecting it in your desktop.
IE has different features according to its version, you should move to IE11 for full support:
- IE8, IE9: Not supported as they lack FormData.
- IE10: The upload preview, progress and drag and drop work, but it doesn't allow pasting images.
- IE11: Surprisingly this version of IE surpasses the features of Chrome and Firefox because it allows pasting a document from MS Word 2013 (I still haven't found other valid data sources) with all its images at the same time. Unfortunately, it seems that this feature no longer works under Windows 10.
RequirementsThe plugin works with CKEditor 4.x, the only requirement is that you have already configured CKEditor to allow file uploads. You can use CKFinder or any other upload system that uses the CKEditor API, even create your own one. I provide a sample basic script for those that need all the details, but it's not advised to use it in production.
There is no restriction on the server, as long as you are able to install a CKEditor plugin and you have configured the QuickUploads in CKEditor, you're ready to go. Please, follow this guide to learn how to configure File uploads in CKEditor, this is your only real requirement.
If you're using CKEditor in Drupal, please read this guide with detailed instructions and a specific uploader module. But please, don't buy this plugin until the quick uploads in CKEditor are working correctly. (Of course this last sentence applies to whatever CMS you're using)
SupportThe plugin is available only to licensed customers, if you manage to find a bug then send me a mail so I can look at it. My policy is to keep my plugins bug-free, because that's the way to have the lower number of mails in my inbox.
The payment is a one-time-fee, after the payment you will get the download and your mail will be added to my list for future updates. All future updates are included, even if the plugin keeps growing and including whole new features as it has done all these years since I started developing it.