plupload.Uploader instance<\/li>\n<\/ul>\nExample:-<\/strong><\/p>\n\t$(document).on('mpp:uploader:file.added', function (event, mpp_uploader, uploader) {\r\n\t\tconsole.log( \"All files in current selection added to the queue\");\r\n });<\/pre>\nOn Upload Start:-<\/h3>\n
Before the upload starts for each of the file, following event is triggered<\/p>\n
\n- mpp:uploader:before.upload<\/strong><\/li>\n<\/ul>\n
The bound listener will receive following arguements<\/p>\n
\n- Event Object<\/li>\n
- mpp.Uploader instance<\/li>\n
- plupload.Uploader instance<\/li>\n
- file Backbone.Model instance<\/li>\n<\/ul>\n
You can use this hook to stop uploading a file.<\/p>\n
Example:-<\/strong><\/p>\n\t$(document).on('mpp:uploader:before.upload', function (event, mpp_uploader, uploader, file) {\r\n\t\tconsole.log( \"We are about to start uploading\" + file.name );\r\n });<\/pre>\n <\/p>\n
On Upload Progress:-<\/h3>\n
If you need to hook to upload progress and do something, you can use the event:-<\/p>\n
\n- mpp:uploader:upload.progress<\/strong><\/li>\n<\/ul>\n
The bound listener will receive following arguments:-<\/p>\n
\n- Event object<\/li>\n
- mpp.Uploader instance<\/li>\n
- attachment :- Backbone Model object containing details about the uploading file.<\/li>\n<\/ul>\n
The event gives you access to mpp.Uploader and the attachment object. On attchment, you can check for the ‘loaded’, ‘percent’ properties to check for the upload progress.<\/p>\n
Example:-<\/strong><\/p>\n\t$(document).on('mpp:uploader:upload.progress', function (event, mpp_uploader, attachment) {\r\n\t\t\/\/ do something.\r\n });<\/pre>\n <\/p>\n
On Upload Success:-<\/h3>\n
Whena\u00a0 file uploads successfully, the following event is fired for it<\/p>\n
\n- \u00a0mpp:uploader:upload.success<\/strong><\/li>\n<\/ul>\n
This even fires for each file individually.<\/p>\n
The listener attached to this event will receive following argumenets<\/p>\n
\n- Event object<\/li>\n
- mpp.Uploader instance<\/li>\n
- attachment :- Backbone Model object containing details about the uploading file.<\/li>\n<\/ul>\n
Example:-<\/strong><\/p>\n\t$(document).on('mpp:uploader:upload.success', function (event, mpp_uploader, attachment) {\r\n\t\tconsole.log( attachment );\r\n });<\/pre>\n<\/h4>\nOn All Upload Complete:-<\/h4>\n
When all files from the current queue get uploaded, the uploader fires the event:-<\/p>\n
\n- mpp:uploader:upload.complete<\/strong><\/li>\n<\/ul>\n
A listener attached to it receives 4 arguements<\/p>\n
\n- Event object<\/li>\n
- mpp.Uploader instance<\/li>\n
- plupload.Uploader instance<\/li>\n
- Backbone collection of files.<\/li>\n<\/ul>\n
Example:-<\/strong><\/p>\n\t$(document).on('mpp:uploader:upload.complete', function (event, mpp_uploader, uploader, files) {\r\n\t\t\/\/ do something here.\r\n });<\/pre>\nOn Error:-<\/h4>\n
For all type of error(Possibly a file selection error or upload failure error), MediaPress triggers ‘mpp:uploader:error<\/strong>‘ .<\/p>\nThe listener attached to this event receives 4 arguements<\/p>\n
\n- Event object<\/li>\n
- mpp.Uploader instance<\/li>\n
- message string<\/li>\n
- data object<\/li>\n
- file object<\/li>\n<\/ul>\n
Example:-<\/strong><\/p>\n\t$(document).on('mpp:uploader:error', function (event, mpp_uploader, message, data, file) {\r\n\t\t\/\/ do something here.\r\n });<\/pre>\n <\/p>\n
Uploader Type Check:-<\/h3>\n
In all the listeners, you receive the instance of current MediaPress uploader as second argument.\u00a0 You don’t need to worry about uploader check if you want to do some action on all the uploads irrespective of whether it is being uploaded.<\/p>\n
There may be a time when you will want to determine whcih uploader was used(was it a gallery upload or was it happening on activity?) . Before we determine it, You will need to know the kind of mpp.Uploader instances which are used by MediaPress.<\/p>\n
In MediaPress, we create multiple instance of the mpp.Uploader for uploading to activity, single gallery, using shortcode, cover upload. Here are the list of the instance object.<\/p>\n
\n- mpp.activity_uploader :- our activity uploader.<\/li>\n
- mpp.guploader :- Gallery uploader<\/li>\n
- mpp.shortcode_uploader :- Shortcode uploader<\/li>\n
- mpp.cover_uploader :- cover uploader<\/li>\n<\/ul>\n
In order to determine the type of uploader, compare the 2nd arguement with one of the above. For example, if I want to check for upload complete from activity, I will do it like below:-<\/p>\n
\t$(document).on('mpp:uploader:upload.complete', function (event, mpp_uploader, uploader, files ) {\r\n\t\t\/\/ did it happen from activity uploader?\r\n\t\tif ( mpp_uploader === mpp.activity_uploader ) {\r\n\t\t\tconsole.log(\" All files uploaded from activity\");\r\n\t\t}\r\n });<\/pre>\n