You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2379 lines
59 KiB
2379 lines
59 KiB
/** |
|
* Plupload - multi-runtime File Uploader |
|
* v2.1.9 |
|
* |
|
* Copyright 2013, Moxiecode Systems AB |
|
* Released under GPL License. |
|
* |
|
* License: http://www.plupload.com/license |
|
* Contributing: http://www.plupload.com/contributing |
|
* |
|
* Date: 2016-05-15 |
|
*/ |
|
/** |
|
* Plupload.js |
|
* |
|
* Copyright 2013, Moxiecode Systems AB |
|
* Released under GPL License. |
|
* |
|
* License: http://www.plupload.com/license |
|
* Contributing: http://www.plupload.com/contributing |
|
*/ |
|
|
|
/** |
|
* Modified for WordPress, Silverlight and Flash runtimes support was removed. |
|
* See https://core.trac.wordpress.org/ticket/41755. |
|
*/ |
|
|
|
/*global mOxie:true */ |
|
|
|
;(function(window, o, undef) { |
|
|
|
var delay = window.setTimeout |
|
, fileFilters = {} |
|
; |
|
|
|
// convert plupload features to caps acceptable by mOxie |
|
function normalizeCaps(settings) { |
|
var features = settings.required_features, caps = {}; |
|
|
|
function resolve(feature, value, strict) { |
|
// Feature notation is deprecated, use caps (this thing here is required for backward compatibility) |
|
var map = { |
|
chunks: 'slice_blob', |
|
jpgresize: 'send_binary_string', |
|
pngresize: 'send_binary_string', |
|
progress: 'report_upload_progress', |
|
multi_selection: 'select_multiple', |
|
dragdrop: 'drag_and_drop', |
|
drop_element: 'drag_and_drop', |
|
headers: 'send_custom_headers', |
|
urlstream_upload: 'send_binary_string', |
|
canSendBinary: 'send_binary', |
|
triggerDialog: 'summon_file_dialog' |
|
}; |
|
|
|
if (map[feature]) { |
|
caps[map[feature]] = value; |
|
} else if (!strict) { |
|
caps[feature] = value; |
|
} |
|
} |
|
|
|
if (typeof(features) === 'string') { |
|
plupload.each(features.split(/\s*,\s*/), function(feature) { |
|
resolve(feature, true); |
|
}); |
|
} else if (typeof(features) === 'object') { |
|
plupload.each(features, function(value, feature) { |
|
resolve(feature, value); |
|
}); |
|
} else if (features === true) { |
|
// check settings for required features |
|
if (settings.chunk_size > 0) { |
|
caps.slice_blob = true; |
|
} |
|
|
|
if (settings.resize.enabled || !settings.multipart) { |
|
caps.send_binary_string = true; |
|
} |
|
|
|
plupload.each(settings, function(value, feature) { |
|
resolve(feature, !!value, true); // strict check |
|
}); |
|
} |
|
|
|
// WP: only html runtimes. |
|
settings.runtimes = 'html5,html4'; |
|
|
|
return caps; |
|
} |
|
|
|
/** |
|
* @module plupload |
|
* @static |
|
*/ |
|
var plupload = { |
|
/** |
|
* Plupload version will be replaced on build. |
|
* |
|
* @property VERSION |
|
* @for Plupload |
|
* @static |
|
* @final |
|
*/ |
|
VERSION : '2.1.9', |
|
|
|
/** |
|
* The state of the queue before it has started and after it has finished |
|
* |
|
* @property STOPPED |
|
* @static |
|
* @final |
|
*/ |
|
STOPPED : 1, |
|
|
|
/** |
|
* Upload process is running |
|
* |
|
* @property STARTED |
|
* @static |
|
* @final |
|
*/ |
|
STARTED : 2, |
|
|
|
/** |
|
* File is queued for upload |
|
* |
|
* @property QUEUED |
|
* @static |
|
* @final |
|
*/ |
|
QUEUED : 1, |
|
|
|
/** |
|
* File is being uploaded |
|
* |
|
* @property UPLOADING |
|
* @static |
|
* @final |
|
*/ |
|
UPLOADING : 2, |
|
|
|
/** |
|
* File has failed to be uploaded |
|
* |
|
* @property FAILED |
|
* @static |
|
* @final |
|
*/ |
|
FAILED : 4, |
|
|
|
/** |
|
* File has been uploaded successfully |
|
* |
|
* @property DONE |
|
* @static |
|
* @final |
|
*/ |
|
DONE : 5, |
|
|
|
// Error constants used by the Error event |
|
|
|
/** |
|
* Generic error for example if an exception is thrown inside Silverlight. |
|
* |
|
* @property GENERIC_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
GENERIC_ERROR : -100, |
|
|
|
/** |
|
* HTTP transport error. For example if the server produces a HTTP status other than 200. |
|
* |
|
* @property HTTP_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
HTTP_ERROR : -200, |
|
|
|
/** |
|
* Generic I/O error. For example if it wasn't possible to open the file stream on local machine. |
|
* |
|
* @property IO_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
IO_ERROR : -300, |
|
|
|
/** |
|
* @property SECURITY_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
SECURITY_ERROR : -400, |
|
|
|
/** |
|
* Initialization error. Will be triggered if no runtime was initialized. |
|
* |
|
* @property INIT_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
INIT_ERROR : -500, |
|
|
|
/** |
|
* File size error. If the user selects a file that is too large it will be blocked and an error of this type will be triggered. |
|
* |
|
* @property FILE_SIZE_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
FILE_SIZE_ERROR : -600, |
|
|
|
/** |
|
* File extension error. If the user selects a file that isn't valid according to the filters setting. |
|
* |
|
* @property FILE_EXTENSION_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
FILE_EXTENSION_ERROR : -601, |
|
|
|
/** |
|
* Duplicate file error. If prevent_duplicates is set to true and user selects the same file again. |
|
* |
|
* @property FILE_DUPLICATE_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
FILE_DUPLICATE_ERROR : -602, |
|
|
|
/** |
|
* Runtime will try to detect if image is proper one. Otherwise will throw this error. |
|
* |
|
* @property IMAGE_FORMAT_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
IMAGE_FORMAT_ERROR : -700, |
|
|
|
/** |
|
* While working on files runtime may run out of memory and will throw this error. |
|
* |
|
* @since 2.1.2 |
|
* @property MEMORY_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
MEMORY_ERROR : -701, |
|
|
|
/** |
|
* Each runtime has an upper limit on a dimension of the image it can handle. If bigger, will throw this error. |
|
* |
|
* @property IMAGE_DIMENSIONS_ERROR |
|
* @static |
|
* @final |
|
*/ |
|
IMAGE_DIMENSIONS_ERROR : -702, |
|
|
|
/** |
|
* Mime type lookup table. |
|
* |
|
* @property mimeTypes |
|
* @type Object |
|
* @final |
|
*/ |
|
mimeTypes : o.mimes, |
|
|
|
/** |
|
* In some cases sniffing is the only way around :( |
|
*/ |
|
ua: o.ua, |
|
|
|
/** |
|
* Gets the true type of the built-in object (better version of typeof). |
|
* @credits Angus Croll (http://javascriptweblog.wordpress.com/) |
|
* |
|
* @method typeOf |
|
* @static |
|
* @param {Object} o Object to check. |
|
* @return {String} Object [[Class]] |
|
*/ |
|
typeOf: o.typeOf, |
|
|
|
/** |
|
* Extends the specified object with another object. |
|
* |
|
* @method extend |
|
* @static |
|
* @param {Object} target Object to extend. |
|
* @param {Object..} obj Multiple objects to extend with. |
|
* @return {Object} Same as target, the extended object. |
|
*/ |
|
extend : o.extend, |
|
|
|
/** |
|
* Generates an unique ID. This is 99.99% unique since it takes the current time and 5 random numbers. |
|
* The only way a user would be able to get the same ID is if the two persons at the same exact millisecond manages |
|
* to get 5 the same random numbers between 0-65535 it also uses a counter so each call will be guaranteed to be page unique. |
|
* It's more probable for the earth to be hit with an asteriod. You can also if you want to be 100% sure set the plupload.guidPrefix property |
|
* to an user unique key. |
|
* |
|
* @method guid |
|
* @static |
|
* @return {String} Virtually unique id. |
|
*/ |
|
guid : o.guid, |
|
|
|
/** |
|
* Get array of DOM Elements by their ids. |
|
* |
|
* @method get |
|
* @param {String} id Identifier of the DOM Element |
|
* @return {Array} |
|
*/ |
|
getAll : function get(ids) { |
|
var els = [], el; |
|
|
|
if (plupload.typeOf(ids) !== 'array') { |
|
ids = [ids]; |
|
} |
|
|
|
var i = ids.length; |
|
while (i--) { |
|
el = plupload.get(ids[i]); |
|
if (el) { |
|
els.push(el); |
|
} |
|
} |
|
|
|
return els.length ? els : null; |
|
}, |
|
|
|
/** |
|
Get DOM element by id |
|
|
|
@method get |
|
@param {String} id Identifier of the DOM Element |
|
@return {Node} |
|
*/ |
|
get: o.get, |
|
|
|
/** |
|
* Executes the callback function for each item in array/object. If you return false in the |
|
* callback it will break the loop. |
|
* |
|
* @method each |
|
* @static |
|
* @param {Object} obj Object to iterate. |
|
* @param {function} callback Callback function to execute for each item. |
|
*/ |
|
each : o.each, |
|
|
|
/** |
|
* Returns the absolute x, y position of an Element. The position will be returned in a object with x, y fields. |
|
* |
|
* @method getPos |
|
* @static |
|
* @param {Element} node HTML element or element id to get x, y position from. |
|
* @param {Element} root Optional root element to stop calculations at. |
|
* @return {object} Absolute position of the specified element object with x, y fields. |
|
*/ |
|
getPos : o.getPos, |
|
|
|
/** |
|
* Returns the size of the specified node in pixels. |
|
* |
|
* @method getSize |
|
* @static |
|
* @param {Node} node Node to get the size of. |
|
* @return {Object} Object with a w and h property. |
|
*/ |
|
getSize : o.getSize, |
|
|
|
/** |
|
* Encodes the specified string. |
|
* |
|
* @method xmlEncode |
|
* @static |
|
* @param {String} s String to encode. |
|
* @return {String} Encoded string. |
|
*/ |
|
xmlEncode : function(str) { |
|
var xmlEncodeChars = {'<' : 'lt', '>' : 'gt', '&' : 'amp', '"' : 'quot', '\'' : '#39'}, xmlEncodeRegExp = /[<>&\"\']/g; |
|
|
|
return str ? ('' + str).replace(xmlEncodeRegExp, function(chr) { |
|
return xmlEncodeChars[chr] ? '&' + xmlEncodeChars[chr] + ';' : chr; |
|
}) : str; |
|
}, |
|
|
|
/** |
|
* Forces anything into an array. |
|
* |
|
* @method toArray |
|
* @static |
|
* @param {Object} obj Object with length field. |
|
* @return {Array} Array object containing all items. |
|
*/ |
|
toArray : o.toArray, |
|
|
|
/** |
|
* Find an element in array and return its index if present, otherwise return -1. |
|
* |
|
* @method inArray |
|
* @static |
|
* @param {mixed} needle Element to find |
|
* @param {Array} array |
|
* @return {Int} Index of the element, or -1 if not found |
|
*/ |
|
inArray : o.inArray, |
|
|
|
/** |
|
* Extends the language pack object with new items. |
|
* |
|
* @method addI18n |
|
* @static |
|
* @param {Object} pack Language pack items to add. |
|
* @return {Object} Extended language pack object. |
|
*/ |
|
addI18n : o.addI18n, |
|
|
|
/** |
|
* Translates the specified string by checking for the english string in the language pack lookup. |
|
* |
|
* @method translate |
|
* @static |
|
* @param {String} str String to look for. |
|
* @return {String} Translated string or the input string if it wasn't found. |
|
*/ |
|
translate : o.translate, |
|
|
|
/** |
|
* Checks if object is empty. |
|
* |
|
* @method isEmptyObj |
|
* @static |
|
* @param {Object} obj Object to check. |
|
* @return {Boolean} |
|
*/ |
|
isEmptyObj : o.isEmptyObj, |
|
|
|
/** |
|
* Checks if specified DOM element has specified class. |
|
* |
|
* @method hasClass |
|
* @static |
|
* @param {Object} obj DOM element like object to add handler to. |
|
* @param {String} name Class name |
|
*/ |
|
hasClass : o.hasClass, |
|
|
|
/** |
|
* Adds specified className to specified DOM element. |
|
* |
|
* @method addClass |
|
* @static |
|
* @param {Object} obj DOM element like object to add handler to. |
|
* @param {String} name Class name |
|
*/ |
|
addClass : o.addClass, |
|
|
|
/** |
|
* Removes specified className from specified DOM element. |
|
* |
|
* @method removeClass |
|
* @static |
|
* @param {Object} obj DOM element like object to add handler to. |
|
* @param {String} name Class name |
|
*/ |
|
removeClass : o.removeClass, |
|
|
|
/** |
|
* Returns a given computed style of a DOM element. |
|
* |
|
* @method getStyle |
|
* @static |
|
* @param {Object} obj DOM element like object. |
|
* @param {String} name Style you want to get from the DOM element |
|
*/ |
|
getStyle : o.getStyle, |
|
|
|
/** |
|
* Adds an event handler to the specified object and store reference to the handler |
|
* in objects internal Plupload registry (@see removeEvent). |
|
* |
|
* @method addEvent |
|
* @static |
|
* @param {Object} obj DOM element like object to add handler to. |
|
* @param {String} name Name to add event listener to. |
|
* @param {Function} callback Function to call when event occurs. |
|
* @param {String} (optional) key that might be used to add specifity to the event record. |
|
*/ |
|
addEvent : o.addEvent, |
|
|
|
/** |
|
* Remove event handler from the specified object. If third argument (callback) |
|
* is not specified remove all events with the specified name. |
|
* |
|
* @method removeEvent |
|
* @static |
|
* @param {Object} obj DOM element to remove event listener(s) from. |
|
* @param {String} name Name of event listener to remove. |
|
* @param {Function|String} (optional) might be a callback or unique key to match. |
|
*/ |
|
removeEvent: o.removeEvent, |
|
|
|
/** |
|
* Remove all kind of events from the specified object |
|
* |
|
* @method removeAllEvents |
|
* @static |
|
* @param {Object} obj DOM element to remove event listeners from. |
|
* @param {String} (optional) unique key to match, when removing events. |
|
*/ |
|
removeAllEvents: o.removeAllEvents, |
|
|
|
/** |
|
* Cleans the specified name from national characters (diacritics). The result will be a name with only a-z, 0-9 and _. |
|
* |
|
* @method cleanName |
|
* @static |
|
* @param {String} s String to clean up. |
|
* @return {String} Cleaned string. |
|
*/ |
|
cleanName : function(name) { |
|
var i, lookup; |
|
|
|
// Replace diacritics |
|
lookup = [ |
|
/[\300-\306]/g, 'A', /[\340-\346]/g, 'a', |
|
/\307/g, 'C', /\347/g, 'c', |
|
/[\310-\313]/g, 'E', /[\350-\353]/g, 'e', |
|
/[\314-\317]/g, 'I', /[\354-\357]/g, 'i', |
|
/\321/g, 'N', /\361/g, 'n', |
|
/[\322-\330]/g, 'O', /[\362-\370]/g, 'o', |
|
/[\331-\334]/g, 'U', /[\371-\374]/g, 'u' |
|
]; |
|
|
|
for (i = 0; i < lookup.length; i += 2) { |
|
name = name.replace(lookup[i], lookup[i + 1]); |
|
} |
|
|
|
// Replace whitespace |
|
name = name.replace(/\s+/g, '_'); |
|
|
|
// Remove anything else |
|
name = name.replace(/[^a-z0-9_\-\.]+/gi, ''); |
|
|
|
return name; |
|
}, |
|
|
|
/** |
|
* Builds a full url out of a base URL and an object with items to append as query string items. |
|
* |
|
* @method buildUrl |
|
* @static |
|
* @param {String} url Base URL to append query string items to. |
|
* @param {Object} items Name/value object to serialize as a querystring. |
|
* @return {String} String with url + serialized query string items. |
|
*/ |
|
buildUrl : function(url, items) { |
|
var query = ''; |
|
|
|
plupload.each(items, function(value, name) { |
|
query += (query ? '&' : '') + encodeURIComponent(name) + '=' + encodeURIComponent(value); |
|
}); |
|
|
|
if (query) { |
|
url += (url.indexOf('?') > 0 ? '&' : '?') + query; |
|
} |
|
|
|
return url; |
|
}, |
|
|
|
/** |
|
* Formats the specified number as a size string for example 1024 becomes 1 KB. |
|
* |
|
* @method formatSize |
|
* @static |
|
* @param {Number} size Size to format as string. |
|
* @return {String} Formatted size string. |
|
*/ |
|
formatSize : function(size) { |
|
|
|
if (size === undef || /\D/.test(size)) { |
|
return plupload.translate('N/A'); |
|
} |
|
|
|
function round(num, precision) { |
|
return Math.round(num * Math.pow(10, precision)) / Math.pow(10, precision); |
|
} |
|
|
|
var boundary = Math.pow(1024, 4); |
|
|
|
// TB |
|
if (size > boundary) { |
|
return round(size / boundary, 1) + " " + plupload.translate('tb'); |
|
} |
|
|
|
// GB |
|
if (size > (boundary/=1024)) { |
|
return round(size / boundary, 1) + " " + plupload.translate('gb'); |
|
} |
|
|
|
// MB |
|
if (size > (boundary/=1024)) { |
|
return round(size / boundary, 1) + " " + plupload.translate('mb'); |
|
} |
|
|
|
// KB |
|
if (size > 1024) { |
|
return Math.round(size / 1024) + " " + plupload.translate('kb'); |
|
} |
|
|
|
return size + " " + plupload.translate('b'); |
|
}, |
|
|
|
|
|
/** |
|
* Parses the specified size string into a byte value. For example 10kb becomes 10240. |
|
* |
|
* @method parseSize |
|
* @static |
|
* @param {String|Number} size String to parse or number to just pass through. |
|
* @return {Number} Size in bytes. |
|
*/ |
|
parseSize : o.parseSizeStr, |
|
|
|
|
|
/** |
|
* A way to predict what runtime will be choosen in the current environment with the |
|
* specified settings. |
|
* |
|
* @method predictRuntime |
|
* @static |
|
* @param {Object|String} config Plupload settings to check |
|
* @param {String} [runtimes] Comma-separated list of runtimes to check against |
|
* @return {String} Type of compatible runtime |
|
*/ |
|
predictRuntime : function(config, runtimes) { |
|
var up, runtime; |
|
|
|
up = new plupload.Uploader(config); |
|
runtime = o.Runtime.thatCan(up.getOption().required_features, runtimes || config.runtimes); |
|
up.destroy(); |
|
return runtime; |
|
}, |
|
|
|
/** |
|
* Registers a filter that will be executed for each file added to the queue. |
|
* If callback returns false, file will not be added. |
|
* |
|
* Callback receives two arguments: a value for the filter as it was specified in settings.filters |
|
* and a file to be filtered. Callback is executed in the context of uploader instance. |
|
* |
|
* @method addFileFilter |
|
* @static |
|
* @param {String} name Name of the filter by which it can be referenced in settings.filters |
|
* @param {String} cb Callback - the actual routine that every added file must pass |
|
*/ |
|
addFileFilter: function(name, cb) { |
|
fileFilters[name] = cb; |
|
} |
|
}; |
|
|
|
|
|
plupload.addFileFilter('mime_types', function(filters, file, cb) { |
|
if (filters.length && !filters.regexp.test(file.name)) { |
|
this.trigger('Error', { |
|
code : plupload.FILE_EXTENSION_ERROR, |
|
message : plupload.translate('File extension error.'), |
|
file : file |
|
}); |
|
cb(false); |
|
} else { |
|
cb(true); |
|
} |
|
}); |
|
|
|
|
|
plupload.addFileFilter('max_file_size', function(maxSize, file, cb) { |
|
var undef; |
|
|
|
maxSize = plupload.parseSize(maxSize); |
|
|
|
// Invalid file size |
|
if (file.size !== undef && maxSize && file.size > maxSize) { |
|
this.trigger('Error', { |
|
code : plupload.FILE_SIZE_ERROR, |
|
message : plupload.translate('File size error.'), |
|
file : file |
|
}); |
|
cb(false); |
|
} else { |
|
cb(true); |
|
} |
|
}); |
|
|
|
|
|
plupload.addFileFilter('prevent_duplicates', function(value, file, cb) { |
|
if (value) { |
|
var ii = this.files.length; |
|
while (ii--) { |
|
// Compare by name and size (size might be 0 or undefined, but still equivalent for both) |
|
if (file.name === this.files[ii].name && file.size === this.files[ii].size) { |
|
this.trigger('Error', { |
|
code : plupload.FILE_DUPLICATE_ERROR, |
|
message : plupload.translate('Duplicate file error.'), |
|
file : file |
|
}); |
|
cb(false); |
|
return; |
|
} |
|
} |
|
} |
|
cb(true); |
|
}); |
|
|
|
|
|
/** |
|
@class Uploader |
|
@constructor |
|
|
|
@param {Object} settings For detailed information about each option check documentation. |
|
@param {String|DOMElement} settings.browse_button id of the DOM element or DOM element itself to use as file dialog trigger. |
|
@param {String} settings.url URL of the server-side upload handler. |
|
@param {Number|String} [settings.chunk_size=0] Chunk size in bytes to slice the file into. Shorcuts with b, kb, mb, gb, tb suffixes also supported. `e.g. 204800 or "204800b" or "200kb"`. By default - disabled. |
|
@param {Boolean} [settings.send_chunk_number=true] Whether to send chunks and chunk numbers, or total and offset bytes. |
|
@param {String|DOMElement} [settings.container] id of the DOM element or DOM element itself that will be used to wrap uploader structures. Defaults to immediate parent of the `browse_button` element. |
|
@param {String|DOMElement} [settings.drop_element] id of the DOM element or DOM element itself to use as a drop zone for Drag-n-Drop. |
|
@param {String} [settings.file_data_name="file"] Name for the file field in Multipart formated message. |
|
@param {Object} [settings.filters={}] Set of file type filters. |
|
@param {Array} [settings.filters.mime_types=[]] List of file types to accept, each one defined by title and list of extensions. `e.g. {title : "Image files", extensions : "jpg,jpeg,gif,png"}`. Dispatches `plupload.FILE_EXTENSION_ERROR` |
|
@param {String|Number} [settings.filters.max_file_size=0] Maximum file size that the user can pick, in bytes. Optionally supports b, kb, mb, gb, tb suffixes. `e.g. "10mb" or "1gb"`. By default - not set. Dispatches `plupload.FILE_SIZE_ERROR`. |
|
@param {Boolean} [settings.filters.prevent_duplicates=false] Do not let duplicates into the queue. Dispatches `plupload.FILE_DUPLICATE_ERROR`. |
|
@param {String} [settings.flash_swf_url] URL of the Flash swf. (Not used in WordPress) |
|
@param {Object} [settings.headers] Custom headers to send with the upload. Hash of name/value pairs. |
|
@param {Number} [settings.max_retries=0] How many times to retry the chunk or file, before triggering Error event. |
|
@param {Boolean} [settings.multipart=true] Whether to send file and additional parameters as Multipart formated message. |
|
@param {Object} [settings.multipart_params] Hash of key/value pairs to send with every file upload. |
|
@param {Boolean} [settings.multi_selection=true] Enable ability to select multiple files at once in file dialog. |
|
@param {String|Object} [settings.required_features] Either comma-separated list or hash of required features that chosen runtime should absolutely possess. |
|
@param {Object} [settings.resize] Enable resizng of images on client-side. Applies to `image/jpeg` and `image/png` only. `e.g. {width : 200, height : 200, quality : 90, crop: true}` |
|
@param {Number} [settings.resize.width] If image is bigger, it will be resized. |
|
@param {Number} [settings.resize.height] If image is bigger, it will be resized. |
|
@param {Number} [settings.resize.quality=90] Compression quality for jpegs (1-100). |
|
@param {Boolean} [settings.resize.crop=false] Whether to crop images to exact dimensions. By default they will be resized proportionally. |
|
@param {String} [settings.runtimes="html5,html4"] Comma separated list of runtimes, that Plupload will try in turn, moving to the next if previous fails. |
|
@param {String} [settings.silverlight_xap_url] URL of the Silverlight xap. (Not used in WordPress) |
|
@param {Boolean} [settings.unique_names=false] If true will generate unique filenames for uploaded files. |
|
@param {Boolean} [settings.send_file_name=true] Whether to send file name as additional argument - 'name' (required for chunked uploads and some other cases where file name cannot be sent via normal ways). |
|
*/ |
|
plupload.Uploader = function(options) { |
|
/** |
|
Fires when the current RunTime has been initialized. |
|
|
|
@event Init |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
*/ |
|
|
|
/** |
|
Fires after the init event incase you need to perform actions there. |
|
|
|
@event PostInit |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
*/ |
|
|
|
/** |
|
Fires when the option is changed in via uploader.setOption(). |
|
|
|
@event OptionChanged |
|
@since 2.1 |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {String} name Name of the option that was changed |
|
@param {Mixed} value New value for the specified option |
|
@param {Mixed} oldValue Previous value of the option |
|
*/ |
|
|
|
/** |
|
Fires when the silverlight/flash or other shim needs to move. |
|
|
|
@event Refresh |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
*/ |
|
|
|
/** |
|
Fires when the overall state is being changed for the upload queue. |
|
|
|
@event StateChanged |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
*/ |
|
|
|
/** |
|
Fires when browse_button is clicked and browse dialog shows. |
|
|
|
@event Browse |
|
@since 2.1.2 |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
*/ |
|
|
|
/** |
|
Fires for every filtered file before it is added to the queue. |
|
|
|
@event FileFiltered |
|
@since 2.1 |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {plupload.File} file Another file that has to be added to the queue. |
|
*/ |
|
|
|
/** |
|
Fires when the file queue is changed. In other words when files are added/removed to the files array of the uploader instance. |
|
|
|
@event QueueChanged |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
*/ |
|
|
|
/** |
|
Fires after files were filtered and added to the queue. |
|
|
|
@event FilesAdded |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {Array} files Array of file objects that were added to queue by the user. |
|
*/ |
|
|
|
/** |
|
Fires when file is removed from the queue. |
|
|
|
@event FilesRemoved |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {Array} files Array of files that got removed. |
|
*/ |
|
|
|
/** |
|
Fires just before a file is uploaded. Can be used to cancel the upload for the specified file |
|
by returning false from the handler. |
|
|
|
@event BeforeUpload |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {plupload.File} file File to be uploaded. |
|
*/ |
|
|
|
/** |
|
Fires when a file is to be uploaded by the runtime. |
|
|
|
@event UploadFile |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {plupload.File} file File to be uploaded. |
|
*/ |
|
|
|
/** |
|
Fires while a file is being uploaded. Use this event to update the current file upload progress. |
|
|
|
@event UploadProgress |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {plupload.File} file File that is currently being uploaded. |
|
*/ |
|
|
|
/** |
|
Fires when file chunk is uploaded. |
|
|
|
@event ChunkUploaded |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {plupload.File} file File that the chunk was uploaded for. |
|
@param {Object} result Object with response properties. |
|
@param {Number} result.offset The amount of bytes the server has received so far, including this chunk. |
|
@param {Number} result.total The size of the file. |
|
@param {String} result.response The response body sent by the server. |
|
@param {Number} result.status The HTTP status code sent by the server. |
|
@param {String} result.responseHeaders All the response headers as a single string. |
|
*/ |
|
|
|
/** |
|
Fires when a file is successfully uploaded. |
|
|
|
@event FileUploaded |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {plupload.File} file File that was uploaded. |
|
@param {Object} result Object with response properties. |
|
@param {String} result.response The response body sent by the server. |
|
@param {Number} result.status The HTTP status code sent by the server. |
|
@param {String} result.responseHeaders All the response headers as a single string. |
|
*/ |
|
|
|
/** |
|
Fires when all files in a queue are uploaded. |
|
|
|
@event UploadComplete |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {Array} files Array of file objects that was added to queue/selected by the user. |
|
*/ |
|
|
|
/** |
|
Fires when a error occurs. |
|
|
|
@event Error |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
@param {Object} error Contains code, message and sometimes file and other details. |
|
@param {Number} error.code The plupload error code. |
|
@param {String} error.message Description of the error (uses i18n). |
|
*/ |
|
|
|
/** |
|
Fires when destroy method is called. |
|
|
|
@event Destroy |
|
@param {plupload.Uploader} uploader Uploader instance sending the event. |
|
*/ |
|
var uid = plupload.guid() |
|
, settings |
|
, files = [] |
|
, preferred_caps = {} |
|
, fileInputs = [] |
|
, fileDrops = [] |
|
, startTime |
|
, total |
|
, disabled = false |
|
, xhr |
|
; |
|
|
|
|
|
// Private methods |
|
function uploadNext() { |
|
var file, count = 0, i; |
|
|
|
if (this.state == plupload.STARTED) { |
|
// Find first QUEUED file |
|
for (i = 0; i < files.length; i++) { |
|
if (!file && files[i].status == plupload.QUEUED) { |
|
file = files[i]; |
|
if (this.trigger("BeforeUpload", file)) { |
|
file.status = plupload.UPLOADING; |
|
this.trigger("UploadFile", file); |
|
} |
|
} else { |
|
count++; |
|
} |
|
} |
|
|
|
// All files are DONE or FAILED |
|
if (count == files.length) { |
|
if (this.state !== plupload.STOPPED) { |
|
this.state = plupload.STOPPED; |
|
this.trigger("StateChanged"); |
|
} |
|
this.trigger("UploadComplete", files); |
|
} |
|
} |
|
} |
|
|
|
|
|
function calcFile(file) { |
|
file.percent = file.size > 0 ? Math.ceil(file.loaded / file.size * 100) : 100; |
|
calc(); |
|
} |
|
|
|
|
|
function calc() { |
|
var i, file; |
|
|
|
// Reset stats |
|
total.reset(); |
|
|
|
// Check status, size, loaded etc on all files |
|
for (i = 0; i < files.length; i++) { |
|
file = files[i]; |
|
|
|
if (file.size !== undef) { |
|
// We calculate totals based on original file size |
|
total.size += file.origSize; |
|
|
|
// Since we cannot predict file size after resize, we do opposite and |
|
// interpolate loaded amount to match magnitude of total |
|
total.loaded += file.loaded * file.origSize / file.size; |
|
} else { |
|
total.size = undef; |
|
} |
|
|
|
if (file.status == plupload.DONE) { |
|
total.uploaded++; |
|
} else if (file.status == plupload.FAILED) { |
|
total.failed++; |
|
} else { |
|
total.queued++; |
|
} |
|
} |
|
|
|
// If we couldn't calculate a total file size then use the number of files to calc percent |
|
if (total.size === undef) { |
|
total.percent = files.length > 0 ? Math.ceil(total.uploaded / files.length * 100) : 0; |
|
} else { |
|
total.bytesPerSec = Math.ceil(total.loaded / ((+new Date() - startTime || 1) / 1000.0)); |
|
total.percent = total.size > 0 ? Math.ceil(total.loaded / total.size * 100) : 0; |
|
} |
|
} |
|
|
|
|
|
function getRUID() { |
|
var ctrl = fileInputs[0] || fileDrops[0]; |
|
if (ctrl) { |
|
return ctrl.getRuntime().uid; |
|
} |
|
return false; |
|
} |
|
|
|
|
|
function runtimeCan(file, cap) { |
|
if (file.ruid) { |
|
var info = o.Runtime.getInfo(file.ruid); |
|
if (info) { |
|
return info.can(cap); |
|
} |
|
} |
|
return false; |
|
} |
|
|
|
|
|
function bindEventListeners() { |
|
this.bind('FilesAdded FilesRemoved', function(up) { |
|
up.trigger('QueueChanged'); |
|
up.refresh(); |
|
}); |
|
|
|
this.bind('CancelUpload', onCancelUpload); |
|
|
|
this.bind('BeforeUpload', onBeforeUpload); |
|
|
|
this.bind('UploadFile', onUploadFile); |
|
|
|
this.bind('UploadProgress', onUploadProgress); |
|
|
|
this.bind('StateChanged', onStateChanged); |
|
|
|
this.bind('QueueChanged', calc); |
|
|
|
this.bind('Error', onError); |
|
|
|
this.bind('FileUploaded', onFileUploaded); |
|
|
|
this.bind('Destroy', onDestroy); |
|
} |
|
|
|
|
|
function initControls(settings, cb) { |
|
var self = this, inited = 0, queue = []; |
|
|
|
// common settings |
|
var options = { |
|
runtime_order: settings.runtimes, |
|
required_caps: settings.required_features, |
|
preferred_caps: preferred_caps |
|
}; |
|
|
|
// add runtime specific options if any |
|
plupload.each(settings.runtimes.split(/\s*,\s*/), function(runtime) { |
|
if (settings[runtime]) { |
|
options[runtime] = settings[runtime]; |
|
} |
|
}); |
|
|
|
// initialize file pickers - there can be many |
|
if (settings.browse_button) { |
|
plupload.each(settings.browse_button, function(el) { |
|
queue.push(function(cb) { |
|
var fileInput = new o.FileInput(plupload.extend({}, options, { |
|
accept: settings.filters.mime_types, |
|
name: settings.file_data_name, |
|
multiple: settings.multi_selection, |
|
container: settings.container, |
|
browse_button: el |
|
})); |
|
|
|
fileInput.onready = function() { |
|
var info = o.Runtime.getInfo(this.ruid); |
|
|
|
// for backward compatibility |
|
o.extend(self.features, { |
|
chunks: info.can('slice_blob'), |
|
multipart: info.can('send_multipart'), |
|
multi_selection: info.can('select_multiple') |
|
}); |
|
|
|
inited++; |
|
fileInputs.push(this); |
|
cb(); |
|
}; |
|
|
|
fileInput.onchange = function() { |
|
self.addFile(this.files); |
|
}; |
|
|
|
fileInput.bind('mouseenter mouseleave mousedown mouseup', function(e) { |
|
if (!disabled) { |
|
if (settings.browse_button_hover) { |
|
if ('mouseenter' === e.type) { |
|
o.addClass(el, settings.browse_button_hover); |
|
} else if ('mouseleave' === e.type) { |
|
o.removeClass(el, settings.browse_button_hover); |
|
} |
|
} |
|
|
|
if (settings.browse_button_active) { |
|
if ('mousedown' === e.type) { |
|
o.addClass(el, settings.browse_button_active); |
|
} else if ('mouseup' === e.type) { |
|
o.removeClass(el, settings.browse_button_active); |
|
} |
|
} |
|
} |
|
}); |
|
|
|
fileInput.bind('mousedown', function() { |
|
self.trigger('Browse'); |
|
}); |
|
|
|
fileInput.bind('error runtimeerror', function() { |
|
fileInput = null; |
|
cb(); |
|
}); |
|
|
|
fileInput.init(); |
|
}); |
|
}); |
|
} |
|
|
|
// initialize drop zones |
|
if (settings.drop_element) { |
|
plupload.each(settings.drop_element, function(el) { |
|
queue.push(function(cb) { |
|
var fileDrop = new o.FileDrop(plupload.extend({}, options, { |
|
drop_zone: el |
|
})); |
|
|
|
fileDrop.onready = function() { |
|
var info = o.Runtime.getInfo(this.ruid); |
|
|
|
// for backward compatibility |
|
o.extend(self.features, { |
|
chunks: info.can('slice_blob'), |
|
multipart: info.can('send_multipart'), |
|
dragdrop: info.can('drag_and_drop') |
|
}); |
|
|
|
inited++; |
|
fileDrops.push(this); |
|
cb(); |
|
}; |
|
|
|
fileDrop.ondrop = function() { |
|
self.addFile(this.files); |
|
}; |
|
|
|
fileDrop.bind('error runtimeerror', function() { |
|
fileDrop = null; |
|
cb(); |
|
}); |
|
|
|
fileDrop.init(); |
|
}); |
|
}); |
|
} |
|
|
|
|
|
o.inSeries(queue, function() { |
|
if (typeof(cb) === 'function') { |
|
cb(inited); |
|
} |
|
}); |
|
} |
|
|
|
|
|
function resizeImage(blob, params, cb) { |
|
var img = new o.Image(); |
|
|
|
try { |
|
img.onload = function() { |
|
// no manipulation required if... |
|
if (params.width > this.width && |
|
params.height > this.height && |
|
params.quality === undef && |
|
params.preserve_headers && |
|
!params.crop |
|
) { |
|
this.destroy(); |
|
return cb(blob); |
|
} |
|
// otherwise downsize |
|
img.downsize(params.width, params.height, params.crop, params.preserve_headers); |
|
}; |
|
|
|
img.onresize = function() { |
|
cb(this.getAsBlob(blob.type, params.quality)); |
|
this.destroy(); |
|
}; |
|
|
|
img.onerror = function() { |
|
cb(blob); |
|
}; |
|
|
|
img.load(blob); |
|
} catch(ex) { |
|
cb(blob); |
|
} |
|
} |
|
|
|
|
|
function setOption(option, value, init) { |
|
var self = this, reinitRequired = false; |
|
|
|
function _setOption(option, value, init) { |
|
var oldValue = settings[option]; |
|
|
|
switch (option) { |
|
case 'max_file_size': |
|
if (option === 'max_file_size') { |
|
settings.max_file_size = settings.filters.max_file_size = value; |
|
} |
|
break; |
|
|
|
case 'chunk_size': |
|
if (value = plupload.parseSize(value)) { |
|
settings[option] = value; |
|
settings.send_file_name = true; |
|
} |
|
break; |
|
|
|
case 'multipart': |
|
settings[option] = value; |
|
if (!value) { |
|
settings.send_file_name = true; |
|
} |
|
break; |
|
|
|
case 'unique_names': |
|
settings[option] = value; |
|
if (value) { |
|
settings.send_file_name = true; |
|
} |
|
break; |
|
|
|
case 'filters': |
|
// for sake of backward compatibility |
|
if (plupload.typeOf(value) === 'array') { |
|
value = { |
|
mime_types: value |
|
}; |
|
} |
|
|
|
if (init) { |
|
plupload.extend(settings.filters, value); |
|
} else { |
|
settings.filters = value; |
|
} |
|
|
|
// if file format filters are being updated, regenerate the matching expressions |
|
if (value.mime_types) { |
|
settings.filters.mime_types.regexp = (function(filters) { |
|
var extensionsRegExp = []; |
|
|
|
plupload.each(filters, function(filter) { |
|
plupload.each(filter.extensions.split(/,/), function(ext) { |
|
if (/^\s*\*\s*$/.test(ext)) { |
|
extensionsRegExp.push('\\.*'); |
|
} else { |
|
extensionsRegExp.push('\\.' + ext.replace(new RegExp('[' + ('/^$.*+?|()[]{}\\'.replace(/./g, '\\$&')) + ']', 'g'), '\\$&')); |
|
} |
|
}); |
|
}); |
|
|
|
return new RegExp('(' + extensionsRegExp.join('|') + ')$', 'i'); |
|
}(settings.filters.mime_types)); |
|
} |
|
break; |
|
|
|
case 'resize': |
|
if (init) { |
|
plupload.extend(settings.resize, value, { |
|
enabled: true |
|
}); |
|
} else { |
|
settings.resize = value; |
|
} |
|
break; |
|
|
|
case 'prevent_duplicates': |
|
settings.prevent_duplicates = settings.filters.prevent_duplicates = !!value; |
|
break; |
|
|
|
// options that require reinitialisation |
|
case 'container': |
|
case 'browse_button': |
|
case 'drop_element': |
|
value = 'container' === option |
|
? plupload.get(value) |
|
: plupload.getAll(value) |
|
; |
|
|
|
case 'runtimes': |
|
case 'multi_selection': |
|
settings[option] = value; |
|
if (!init) { |
|
reinitRequired = true; |
|
} |
|
break; |
|
|
|
default: |
|
settings[option] = value; |
|
} |
|
|
|
if (!init) { |
|
self.trigger('OptionChanged', option, value, oldValue); |
|
} |
|
} |
|
|
|
if (typeof(option) === 'object') { |
|
plupload.each(option, function(value, option) { |
|
_setOption(option, value, init); |
|
}); |
|
} else { |
|
_setOption(option, value, init); |
|
} |
|
|
|
if (init) { |
|
// Normalize the list of required capabilities |
|
settings.required_features = normalizeCaps(plupload.extend({}, settings)); |
|
|
|
// Come up with the list of capabilities that can affect default mode in a multi-mode runtimes |
|
preferred_caps = normalizeCaps(plupload.extend({}, settings, { |
|
required_features: true |
|
})); |
|
} else if (reinitRequired) { |
|
self.trigger('Destroy'); |
|
|
|
initControls.call(self, settings, function(inited) { |
|
if (inited) { |
|
self.runtime = o.Runtime.getInfo(getRUID()).type; |
|
self.trigger('Init', { runtime: self.runtime }); |
|
self.trigger('PostInit'); |
|
} else { |
|
self.trigger('Error', { |
|
code : plupload.INIT_ERROR, |
|
message : plupload.translate('Init error.') |
|
}); |
|
} |
|
}); |
|
} |
|
} |
|
|
|
|
|
// Internal event handlers |
|
function onBeforeUpload(up, file) { |
|
// Generate unique target filenames |
|
if (up.settings.unique_names) { |
|
var matches = file.name.match(/\.([^.]+)$/), ext = "part"; |
|
if (matches) { |
|
ext = matches[1]; |
|
} |
|
file.target_name = file.id + '.' + ext; |
|
} |
|
} |
|
|
|
|
|
function onUploadFile(up, file) { |
|
var url = up.settings.url |
|
, chunkSize = up.settings.chunk_size |
|
, retries = up.settings.max_retries |
|
, features = up.features |
|
, offset = 0 |
|
, blob |
|
; |
|
|
|
// make sure we start at a predictable offset |
|
if (file.loaded) { |
|
offset = file.loaded = chunkSize ? chunkSize * Math.floor(file.loaded / chunkSize) : 0; |
|
} |
|
|
|
function handleError() { |
|
if (retries-- > 0) { |
|
delay(uploadNextChunk, 1000); |
|
} else { |
|
file.loaded = offset; // reset all progress |
|
|
|
up.trigger('Error', { |
|
code : plupload.HTTP_ERROR, |
|
message : plupload.translate('HTTP Error.'), |
|
file : file, |
|
response : xhr.responseText, |
|
status : xhr.status, |
|
responseHeaders: xhr.getAllResponseHeaders() |
|
}); |
|
} |
|
} |
|
|
|
function uploadNextChunk() { |
|
var chunkBlob, formData, args = {}, curChunkSize; |
|
|
|
// make sure that file wasn't cancelled and upload is not stopped in general |
|
if (file.status !== plupload.UPLOADING || up.state === plupload.STOPPED) { |
|
return; |
|
} |
|
|
|
// send additional 'name' parameter only if required |
|
if (up.settings.send_file_name) { |
|
args.name = file.target_name || file.name; |
|
} |
|
|
|
if (chunkSize && features.chunks && blob.size > chunkSize) { // blob will be of type string if it was loaded in memory |
|
curChunkSize = Math.min(chunkSize, blob.size - offset); |
|
chunkBlob = blob.slice(offset, offset + curChunkSize); |
|
} else { |
|
curChunkSize = blob.size; |
|
chunkBlob = blob; |
|
} |
|
|
|
// If chunking is enabled add corresponding args, no matter if file is bigger than chunk or smaller |
|
if (chunkSize && features.chunks) { |
|
// Setup query string arguments |
|
if (up.settings.send_chunk_number) { |
|
args.chunk = Math.ceil(offset / chunkSize); |
|
args.chunks = Math.ceil(blob.size / chunkSize); |
|
} else { // keep support for experimental chunk format, just in case |
|
args.offset = offset; |
|
args.total = blob.size; |
|
} |
|
} |
|
|
|
xhr = new o.XMLHttpRequest(); |
|
|
|
// Do we have upload progress support |
|
if (xhr.upload) { |
|
xhr.upload.onprogress = function(e) { |
|
file.loaded = Math.min(file.size, offset + e.loaded); |
|
up.trigger('UploadProgress', file); |
|
}; |
|
} |
|
|
|
xhr.onload = function() { |
|
// check if upload made itself through |
|
if (xhr.status >= 400) { |
|
handleError(); |
|
return; |
|
} |
|
|
|
retries = up.settings.max_retries; // reset the counter |
|
|
|
// Handle chunk response |
|
if (curChunkSize < blob.size) { |
|
chunkBlob.destroy(); |
|
|
|
offset += curChunkSize; |
|
file.loaded = Math.min(offset, blob.size); |
|
|
|
up.trigger('ChunkUploaded', file, { |
|
offset : file.loaded, |
|
total : blob.size, |
|
response : xhr.responseText, |
|
status : xhr.status, |
|
responseHeaders: xhr.getAllResponseHeaders() |
|
}); |
|
|
|
// stock Android browser doesn't fire upload progress events, but in chunking mode we can fake them |
|
if (o.Env.browser === 'Android Browser') { |
|
// doesn't harm in general, but is not required anywhere else |
|
up.trigger('UploadProgress', file); |
|
} |
|
} else { |
|
file.loaded = file.size; |
|
} |
|
|
|
chunkBlob = formData = null; // Free memory |
|
|
|
// Check if file is uploaded |
|
if (!offset || offset >= blob.size) { |
|
// If file was modified, destory the copy |
|
if (file.size != file.origSize) { |
|
blob.destroy(); |
|
blob = null; |
|
} |
|
|
|
up.trigger('UploadProgress', file); |
|
|
|
file.status = plupload.DONE; |
|
|
|
up.trigger('FileUploaded', file, { |
|
response : xhr.responseText, |
|
status : xhr.status, |
|
responseHeaders: xhr.getAllResponseHeaders() |
|
}); |
|
} else { |
|
// Still chunks left |
|
delay(uploadNextChunk, 1); // run detached, otherwise event handlers interfere |
|
} |
|
}; |
|
|
|
xhr.onerror = function() { |
|
handleError(); |
|
}; |
|
|
|
xhr.onloadend = function() { |
|
this.destroy(); |
|
xhr = null; |
|
}; |
|
|
|
// Build multipart request |
|
if (up.settings.multipart && features.multipart) { |
|
xhr.open("post", url, true); |
|
|
|
// Set custom headers |
|
plupload.each(up.settings.headers, function(value, name) { |
|
xhr.setRequestHeader(name, value); |
|
}); |
|
|
|
formData = new o.FormData(); |
|
|
|
// Add multipart params |
|
plupload.each(plupload.extend(args, up.settings.multipart_params), function(value, name) { |
|
formData.append(name, value); |
|
}); |
|
|
|
// Add file and send it |
|
formData.append(up.settings.file_data_name, chunkBlob); |
|
xhr.send(formData, { |
|
runtime_order: up.settings.runtimes, |
|
required_caps: up.settings.required_features, |
|
preferred_caps: preferred_caps |
|
}); |
|
} else { |
|
// if no multipart, send as binary stream |
|
url = plupload.buildUrl(up.settings.url, plupload.extend(args, up.settings.multipart_params)); |
|
|
|
xhr.open("post", url, true); |
|
|
|
xhr.setRequestHeader('Content-Type', 'application/octet-stream'); // Binary stream header |
|
|
|
// Set custom headers |
|
plupload.each(up.settings.headers, function(value, name) { |
|
xhr.setRequestHeader(name, value); |
|
}); |
|
|
|
xhr.send(chunkBlob, { |
|
runtime_order: up.settings.runtimes, |
|
required_caps: up.settings.required_features, |
|
preferred_caps: preferred_caps |
|
}); |
|
} |
|
} |
|
|
|
blob = file.getSource(); |
|
|
|
// Start uploading chunks |
|
if (up.settings.resize.enabled && runtimeCan(blob, 'send_binary_string') && !!~o.inArray(blob.type, ['image/jpeg', 'image/png'])) { |
|
// Resize if required |
|
resizeImage.call(this, blob, up.settings.resize, function(resizedBlob) { |
|
blob = resizedBlob; |
|
file.size = resizedBlob.size; |
|
uploadNextChunk(); |
|
}); |
|
} else { |
|
uploadNextChunk(); |
|
} |
|
} |
|
|
|
|
|
function onUploadProgress(up, file) { |
|
calcFile(file); |
|
} |
|
|
|
|
|
function onStateChanged(up) { |
|
if (up.state == plupload.STARTED) { |
|
// Get start time to calculate bps |
|
startTime = (+new Date()); |
|
} else if (up.state == plupload.STOPPED) { |
|
// Reset currently uploading files |
|
for (var i = up.files.length - 1; i >= 0; i--) { |
|
if (up.files[i].status == plupload.UPLOADING) { |
|
up.files[i].status = plupload.QUEUED; |
|
calc(); |
|
} |
|
} |
|
} |
|
} |
|
|
|
|
|
function onCancelUpload() { |
|
if (xhr) { |
|
xhr.abort(); |
|
} |
|
} |
|
|
|
|
|
function onFileUploaded(up) { |
|
calc(); |
|
|
|
// Upload next file but detach it from the error event |
|
// since other custom listeners might want to stop the queue |
|
delay(function() { |
|
uploadNext.call(up); |
|
}, 1); |
|
} |
|
|
|
|
|
function onError(up, err) { |
|
if (err.code === plupload.INIT_ERROR) { |
|
up.destroy(); |
|
} |
|
// Set failed status if an error occured on a file |
|
else if (err.code === plupload.HTTP_ERROR) { |
|
err.file.status = plupload.FAILED; |
|
calcFile(err.file); |
|
|
|
// Upload next file but detach it from the error event |
|
// since other custom listeners might want to stop the queue |
|
if (up.state == plupload.STARTED) { // upload in progress |
|
up.trigger('CancelUpload'); |
|
delay(function() { |
|
uploadNext.call(up); |
|
}, 1); |
|
} |
|
} |
|
} |
|
|
|
|
|
function onDestroy(up) { |
|
up.stop(); |
|
|
|
// Purge the queue |
|
plupload.each(files, function(file) { |
|
file.destroy(); |
|
}); |
|
files = []; |
|
|
|
if (fileInputs.length) { |
|
plupload.each(fileInputs, function(fileInput) { |
|
fileInput.destroy(); |
|
}); |
|
fileInputs = []; |
|
} |
|
|
|
if (fileDrops.length) { |
|
plupload.each(fileDrops, function(fileDrop) { |
|
fileDrop.destroy(); |
|
}); |
|
fileDrops = []; |
|
} |
|
|
|
preferred_caps = {}; |
|
disabled = false; |
|
startTime = xhr = null; |
|
total.reset(); |
|
} |
|
|
|
|
|
// Default settings |
|
settings = { |
|
runtimes: o.Runtime.order, |
|
max_retries: 0, |
|
chunk_size: 0, |
|
multipart: true, |
|
multi_selection: true, |
|
file_data_name: 'file', |
|
filters: { |
|
mime_types: [], |
|
prevent_duplicates: false, |
|
max_file_size: 0 |
|
}, |
|
resize: { |
|
enabled: false, |
|
preserve_headers: true, |
|
crop: false |
|
}, |
|
send_file_name: true, |
|
send_chunk_number: true |
|
}; |
|
|
|
|
|
setOption.call(this, options, null, true); |
|
|
|
// Inital total state |
|
total = new plupload.QueueProgress(); |
|
|
|
// Add public methods |
|
plupload.extend(this, { |
|
|
|
/** |
|
* Unique id for the Uploader instance. |
|
* |
|
* @property id |
|
* @type String |
|
*/ |
|
id : uid, |
|
uid : uid, // mOxie uses this to differentiate between event targets |
|
|
|
/** |
|
* Current state of the total uploading progress. This one can either be plupload.STARTED or plupload.STOPPED. |
|
* These states are controlled by the stop/start methods. The default value is STOPPED. |
|
* |
|
* @property state |
|
* @type Number |
|
*/ |
|
state : plupload.STOPPED, |
|
|
|
/** |
|
* Map of features that are available for the uploader runtime. Features will be filled |
|
* before the init event is called, these features can then be used to alter the UI for the end user. |
|
* Some of the current features that might be in this map is: dragdrop, chunks, jpgresize, pngresize. |
|
* |
|
* @property features |
|
* @type Object |
|
*/ |
|
features : {}, |
|
|
|
/** |
|
* Current runtime name. |
|
* |
|
* @property runtime |
|
* @type String |
|
*/ |
|
runtime : null, |
|
|
|
/** |
|
* Current upload queue, an array of File instances. |
|
* |
|
* @property files |
|
* @type Array |
|
* @see plupload.File |
|
*/ |
|
files : files, |
|
|
|
/** |
|
* Object with name/value settings. |
|
* |
|
* @property settings |
|
* @type Object |
|
*/ |
|
settings : settings, |
|
|
|
/** |
|
* Total progess information. How many files has been uploaded, total percent etc. |
|
* |
|
* @property total |
|
* @type plupload.QueueProgress |
|
*/ |
|
total : total, |
|
|
|
|
|
/** |
|
* Initializes the Uploader instance and adds internal event listeners. |
|
* |
|
* @method init |
|
*/ |
|
init : function() { |
|
var self = this, opt, preinitOpt, err; |
|
|
|
preinitOpt = self.getOption('preinit'); |
|
if (typeof(preinitOpt) == "function") { |
|
preinitOpt(self); |
|
} else { |
|
plupload.each(preinitOpt, function(func, name) { |
|
self.bind(name, func); |
|
}); |
|
} |
|
|
|
bindEventListeners.call(self); |
|
|
|
// Check for required options |
|
plupload.each(['container', 'browse_button', 'drop_element'], function(el) { |
|
if (self.getOption(el) === null) { |
|
err = { |
|
code : plupload.INIT_ERROR, |
|
message : plupload.translate("'%' specified, but cannot be found.") |
|
} |
|
return false; |
|
} |
|
}); |
|
|
|
if (err) { |
|
return self.trigger('Error', err); |
|
} |
|
|
|
|
|
if (!settings.browse_button && !settings.drop_element) { |
|
return self.trigger('Error', { |
|
code : plupload.INIT_ERROR, |
|
message : plupload.translate("You must specify either 'browse_button' or 'drop_element'.") |
|
}); |
|
} |
|
|
|
|
|
initControls.call(self, settings, function(inited) { |
|
var initOpt = self.getOption('init'); |
|
if (typeof(initOpt) == "function") { |
|
initOpt(self); |
|
} else { |
|
plupload.each(initOpt, function(func, name) { |
|
self.bind(name, func); |
|
}); |
|
} |
|
|
|
if (inited) { |
|
self.runtime = o.Runtime.getInfo(getRUID()).type; |
|
self.trigger('Init', { runtime: self.runtime }); |
|
self.trigger('PostInit'); |
|
} else { |
|
self.trigger('Error', { |
|
code : plupload.INIT_ERROR, |
|
message : plupload.translate('Init error.') |
|
}); |
|
} |
|
}); |
|
}, |
|
|
|
/** |
|
* Set the value for the specified option(s). |
|
* |
|
* @method setOption |
|
* @since 2.1 |
|
* @param {String|Object} option Name of the option to change or the set of key/value pairs |
|
* @param {Mixed} [value] Value for the option (is ignored, if first argument is object) |
|
*/ |
|
setOption: function(option, value) { |
|
setOption.call(this, option, value, !this.runtime); // until runtime not set we do not need to reinitialize |
|
}, |
|
|
|
/** |
|
* Get the value for the specified option or the whole configuration, if not specified. |
|
* |
|
* @method getOption |
|
* @since 2.1 |
|
* @param {String} [option] Name of the option to get |
|
* @return {Mixed} Value for the option or the whole set |
|
*/ |
|
getOption: function(option) { |
|
if (!option) { |
|
return settings; |
|
} |
|
return settings[option]; |
|
}, |
|
|
|
/** |
|
* Refreshes the upload instance by dispatching out a refresh event to all runtimes. |
|
* This would for example reposition flash/silverlight shims on the page. |
|
* |
|
* @method refresh |
|
*/ |
|
refresh : function() { |
|
if (fileInputs.length) { |
|
plupload.each(fileInputs, function(fileInput) { |
|
fileInput.trigger('Refresh'); |
|
}); |
|
} |
|
this.trigger('Refresh'); |
|
}, |
|
|
|
/** |
|
* Starts uploading the queued files. |
|
* |
|
* @method start |
|
*/ |
|
start : function() { |
|
if (this.state != plupload.STARTED) { |
|
this.state = plupload.STARTED; |
|
this.trigger('StateChanged'); |
|
|
|
uploadNext.call(this); |
|
} |
|
}, |
|
|
|
/** |
|
* Stops the upload of the queued files. |
|
* |
|
* @method stop |
|
*/ |
|
stop : function() { |
|
if (this.state != plupload.STOPPED) { |
|
this.state = plupload.STOPPED; |
|
this.trigger('StateChanged'); |
|
this.trigger('CancelUpload'); |
|
} |
|
}, |
|
|
|
|
|
/** |
|
* Disables/enables browse button on request. |
|
* |
|
* @method disableBrowse |
|
* @param {Boolean} disable Whether to disable or enable (default: true) |
|
*/ |
|
disableBrowse : function() { |
|
disabled = arguments[0] !== undef ? arguments[0] : true; |
|
|
|
if (fileInputs.length) { |
|
plupload.each(fileInputs, function(fileInput) { |
|
fileInput.disable(disabled); |
|
}); |
|
} |
|
|
|
this.trigger('DisableBrowse', disabled); |
|
}, |
|
|
|
/** |
|
* Returns the specified file object by id. |
|
* |
|
* @method getFile |
|
* @param {String} id File id to look for. |
|
* @return {plupload.File} File object or undefined if it wasn't found; |
|
*/ |
|
getFile : function(id) { |
|
var i; |
|
for (i = files.length - 1; i >= 0; i--) { |
|
if (files[i].id === id) { |
|
return files[i]; |
|
} |
|
} |
|
}, |
|
|
|
/** |
|
* Adds file to the queue programmatically. Can be native file, instance of Plupload.File, |
|
* instance of mOxie.File, input[type="file"] element, or array of these. Fires FilesAdded, |
|
* if any files were added to the queue. Otherwise nothing happens. |
|
* |
|
* @method addFile |
|
* @since 2.0 |
|
* @param {plupload.File|mOxie.File|File|Node|Array} file File or files to add to the queue. |
|
* @param {String} [fileName] If specified, will be used as a name for the file |
|
*/ |
|
addFile : function(file, fileName) { |
|
var self = this |
|
, queue = [] |
|
, filesAdded = [] |
|
, ruid |
|
; |
|
|
|
function filterFile(file, cb) { |
|
var queue = []; |
|
o.each(self.settings.filters, function(rule, name) { |
|
if (fileFilters[name]) { |
|
queue.push(function(cb) { |
|
fileFilters[name].call(self, rule, file, function(res) { |
|
cb(!res); |
|
}); |
|
}); |
|
} |
|
}); |
|
o.inSeries(queue, cb); |
|
} |
|
|
|
/** |
|
* @method resolveFile |
|
* @private |
|
* @param {o.File|o.Blob|plupload.File|File|Blob|input[type="file"]} file |
|
*/ |
|
function resolveFile(file) { |
|
var type = o.typeOf(file); |
|
|
|
// o.File |
|
if (file instanceof o.File) { |
|
if (!file.ruid && !file.isDetached()) { |
|
if (!ruid) { // weird case |
|
return false; |
|
} |
|
file.ruid = ruid; |
|
file.connectRuntime(ruid); |
|
} |
|
resolveFile(new plupload.File(file)); |
|
} |
|
// o.Blob |
|
else if (file instanceof o.Blob) { |
|
resolveFile(file.getSource()); |
|
file.destroy(); |
|
} |
|
// plupload.File - final step for other branches |
|
else if (file instanceof plupload.File) { |
|
if (fileName) { |
|
file.name = fileName; |
|
} |
|
|
|
queue.push(function(cb) { |
|
// run through the internal and user-defined filters, if any |
|
filterFile(file, function(err) { |
|
if (!err) { |
|
// make files available for the filters by updating the main queue directly |
|
files.push(file); |
|
// collect the files that will be passed to FilesAdded event |
|
filesAdded.push(file); |
|
|
|
self.trigger("FileFiltered", file); |
|
} |
|
delay(cb, 1); // do not build up recursions or eventually we might hit the limits |
|
}); |
|
}); |
|
} |
|
// native File or blob |
|
else if (o.inArray(type, ['file', 'blob']) !== -1) { |
|
resolveFile(new o.File(null, file)); |
|
} |
|
// input[type="file"] |
|
else if (type === 'node' && o.typeOf(file.files) === 'filelist') { |
|
// if we are dealing with input[type="file"] |
|
o.each(file.files, resolveFile); |
|
} |
|
// mixed array of any supported types (see above) |
|
else if (type === 'array') { |
|
fileName = null; // should never happen, but unset anyway to avoid funny situations |
|
o.each(file, resolveFile); |
|
} |
|
} |
|
|
|
ruid = getRUID(); |
|
|
|
resolveFile(file); |
|
|
|
if (queue.length) { |
|
o.inSeries(queue, function() { |
|
// if any files left after filtration, trigger FilesAdded |
|
if (filesAdded.length) { |
|
self.trigger("FilesAdded", filesAdded); |
|
} |
|
}); |
|
} |
|
}, |
|
|
|
/** |
|
* Removes a specific file. |
|
* |
|
* @method removeFile |
|
* @param {plupload.File|String} file File to remove from queue. |
|
*/ |
|
removeFile : function(file) { |
|
var id = typeof(file) === 'string' ? file : file.id; |
|
|
|
for (var i = files.length - 1; i >= 0; i--) { |
|
if (files[i].id === id) { |
|
return this.splice(i, 1)[0]; |
|
} |
|
} |
|
}, |
|
|
|
/** |
|
* Removes part of the queue and returns the files removed. This will also trigger the FilesRemoved and QueueChanged events. |
|
* |
|
* @method splice |
|
* @param {Number} start (Optional) Start index to remove from. |
|
* @param {Number} length (Optional) Lengh of items to remove. |
|
* @return {Array} Array of files that was removed. |
|
*/ |
|
splice : function(start, length) { |
|
// Splice and trigger events |
|
var removed = files.splice(start === undef ? 0 : start, length === undef ? files.length : length); |
|
|
|
// if upload is in progress we need to stop it and restart after files are removed |
|
var restartRequired = false; |
|
if (this.state == plupload.STARTED) { // upload in progress |
|
plupload.each(removed, function(file) { |
|
if (file.status === plupload.UPLOADING) { |
|
restartRequired = true; // do not restart, unless file that is being removed is uploading |
|
return false; |
|
} |
|
}); |
|
|
|
if (restartRequired) { |
|
this.stop(); |
|
} |
|
} |
|
|
|
this.trigger("FilesRemoved", removed); |
|
|
|
// Dispose any resources allocated by those files |
|
plupload.each(removed, function(file) { |
|
file.destroy(); |
|
}); |
|
|
|
if (restartRequired) { |
|
this.start(); |
|
} |
|
|
|
return removed; |
|
}, |
|
|
|
/** |
|
Dispatches the specified event name and its arguments to all listeners. |
|
|
|
@method trigger |
|
@param {String} name Event name to fire. |
|
@param {Object..} Multiple arguments to pass along to the listener functions. |
|
*/ |
|
|
|
// override the parent method to match Plupload-like event logic |
|
dispatchEvent: function(type) { |
|
var list, args, result; |
|
|
|
type = type.toLowerCase(); |
|
|
|
list = this.hasEventListener(type); |
|
|
|
if (list) { |
|
// sort event list by priority |
|
list.sort(function(a, b) { return b.priority - a.priority; }); |
|
|
|
// first argument should be current plupload.Uploader instance |
|
args = [].slice.call(arguments); |
|
args.shift(); |
|
args.unshift(this); |
|
|
|
for (var i = 0; i < list.length; i++) { |
|
// Fire event, break chain if false is returned |
|
if (list[i].fn.apply(list[i].scope, args) === false) { |
|
return false; |
|
} |
|
} |
|
} |
|
return true; |
|
}, |
|
|
|
/** |
|
Check whether uploader has any listeners to the specified event. |
|
|
|
@method hasEventListener |
|
@param {String} name Event name to check for. |
|
*/ |
|
|
|
|
|
/** |
|
Adds an event listener by name. |
|
|
|
@method bind |
|
@param {String} name Event name to listen for. |
|
@param {function} fn Function to call ones the event gets fired. |
|
@param {Object} [scope] Optional scope to execute the specified function in. |
|
@param {Number} [priority=0] Priority of the event handler - handlers with higher priorities will be called first |
|
*/ |
|
bind: function(name, fn, scope, priority) { |
|
// adapt moxie EventTarget style to Plupload-like |
|
plupload.Uploader.prototype.bind.call(this, name, fn, priority, scope); |
|
}, |
|
|
|
/** |
|
Removes the specified event listener. |
|
|
|
@method unbind |
|
@param {String} name Name of event to remove. |
|
@param {function} fn Function to remove from listener. |
|
*/ |
|
|
|
/** |
|
Removes all event listeners. |
|
|
|
@method unbindAll |
|
*/ |
|
|
|
|
|
/** |
|
* Destroys Plupload instance and cleans after itself. |
|
* |
|
* @method destroy |
|
*/ |
|
destroy : function() { |
|
this.trigger('Destroy'); |
|
settings = total = null; // purge these exclusively |
|
this.unbindAll(); |
|
} |
|
}); |
|
}; |
|
|
|
plupload.Uploader.prototype = o.EventTarget.instance; |
|
|
|
/** |
|
* Constructs a new file instance. |
|
* |
|
* @class File |
|
* @constructor |
|
* |
|
* @param {Object} file Object containing file properties |
|
* @param {String} file.name Name of the file. |
|
* @param {Number} file.size File size. |
|
*/ |
|
plupload.File = (function() { |
|
var filepool = {}; |
|
|
|
function PluploadFile(file) { |
|
|
|
plupload.extend(this, { |
|
|
|
/** |
|
* File id this is a globally unique id for the specific file. |
|
* |
|
* @property id |
|
* @type String |
|
*/ |
|
id: plupload.guid(), |
|
|
|
/** |
|
* File name for example "myfile.gif". |
|
* |
|
* @property name |
|
* @type String |
|
*/ |
|
name: file.name || file.fileName, |
|
|
|
/** |
|
* File type, `e.g image/jpeg` |
|
* |
|
* @property type |
|
* @type String |
|
*/ |
|
type: file.type || '', |
|
|
|
/** |
|
* File size in bytes (may change after client-side manupilation). |
|
* |
|
* @property size |
|
* @type Number |
|
*/ |
|
size: file.size || file.fileSize, |
|
|
|
/** |
|
* Original file size in bytes. |
|
* |
|
* @property origSize |
|
* @type Number |
|
*/ |
|
origSize: file.size || file.fileSize, |
|
|
|
/** |
|
* Number of bytes uploaded of the files total size. |
|
* |
|
* @property loaded |
|
* @type Number |
|
*/ |
|
loaded: 0, |
|
|
|
/** |
|
* Number of percentage uploaded of the file. |
|
* |
|
* @property percent |
|
* @type Number |
|
*/ |
|
percent: 0, |
|
|
|
/** |
|
* Status constant matching the plupload states QUEUED, UPLOADING, FAILED, DONE. |
|
* |
|
* @property status |
|
* @type Number |
|
* @see plupload |
|
*/ |
|
status: plupload.QUEUED, |
|
|
|
/** |
|
* Date of last modification. |
|
* |
|
* @property lastModifiedDate |
|
* @type {String} |
|
*/ |
|
lastModifiedDate: file.lastModifiedDate || (new Date()).toLocaleString(), // Thu Aug 23 2012 19:40:00 GMT+0400 (GET) |
|
|
|
/** |
|
* Returns native window.File object, when it's available. |
|
* |
|
* @method getNative |
|
* @return {window.File} or null, if plupload.File is of different origin |
|
*/ |
|
getNative: function() { |
|
var file = this.getSource().getSource(); |
|
return o.inArray(o.typeOf(file), ['blob', 'file']) !== -1 ? file : null; |
|
}, |
|
|
|
/** |
|
* Returns mOxie.File - unified wrapper object that can be used across runtimes. |
|
* |
|
* @method getSource |
|
* @return {mOxie.File} or null |
|
*/ |
|
getSource: function() { |
|
if (!filepool[this.id]) { |
|
return null; |
|
} |
|
return filepool[this.id]; |
|
}, |
|
|
|
/** |
|
* Destroys plupload.File object. |
|
* |
|
* @method destroy |
|
*/ |
|
destroy: function() { |
|
var src = this.getSource(); |
|
if (src) { |
|
src.destroy(); |
|
delete filepool[this.id]; |
|
} |
|
} |
|
}); |
|
|
|
filepool[this.id] = file; |
|
} |
|
|
|
return PluploadFile; |
|
}()); |
|
|
|
|
|
/** |
|
* Constructs a queue progress. |
|
* |
|
* @class QueueProgress |
|
* @constructor |
|
*/ |
|
plupload.QueueProgress = function() { |
|
var self = this; // Setup alias for self to reduce code size when it's compressed |
|
|
|
/** |
|
* Total queue file size. |
|
* |
|
* @property size |
|
* @type Number |
|
*/ |
|
self.size = 0; |
|
|
|
/** |
|
* Total bytes uploaded. |
|
* |
|
* @property loaded |
|
* @type Number |
|
*/ |
|
self.loaded = 0; |
|
|
|
/** |
|
* Number of files uploaded. |
|
* |
|
* @property uploaded |
|
* @type Number |
|
*/ |
|
self.uploaded = 0; |
|
|
|
/** |
|
* Number of files failed to upload. |
|
* |
|
* @property failed |
|
* @type Number |
|
*/ |
|
self.failed = 0; |
|
|
|
/** |
|
* Number of files yet to be uploaded. |
|
* |
|
* @property queued |
|
* @type Number |
|
*/ |
|
self.queued = 0; |
|
|
|
/** |
|
* Total percent of the uploaded bytes. |
|
* |
|
* @property percent |
|
* @type Number |
|
*/ |
|
self.percent = 0; |
|
|
|
/** |
|
* Bytes uploaded per second. |
|
* |
|
* @property bytesPerSec |
|
* @type Number |
|
*/ |
|
self.bytesPerSec = 0; |
|
|
|
/** |
|
* Resets the progress to its initial values. |
|
* |
|
* @method reset |
|
*/ |
|
self.reset = function() { |
|
self.size = self.loaded = self.uploaded = self.failed = self.queued = self.percent = self.bytesPerSec = 0; |
|
}; |
|
}; |
|
|
|
window.plupload = plupload; |
|
|
|
}(window, mOxie));
|
|
|