23 KiB
Executable File
Change Log
Version 2.6.2
- Added UTF-8 encoding to
X-File-Name
request header
Version 2.6.1
SimpleAjaxUploader.js:
- Added disabled status check to file button keyboard support
- Fixed bug in
_getProg
method where undefined error was occurring afterdestroy()
method has been called
Version 2.6
SimpleAjaxUploader.js:
- Added keyboard support for file button. Pressing Enter while focused on file select button now opens file dialog box - #183 (Special thanks to phy25 for this.)
- Added new
multipleSelect
option to allow/disallow multiple file selection (defaultfalse
) - Modified
multiple
option to now only control whether multiple, concurrent uploads are permitted - Added new
onDone( filename, status, statusText, response, uploadBtn, size )
method which fires after each individual upload finishes - Added new
onAllDone()
method which fires when all active uploads finish - Added JSHint comments to suppress "better written in dot notation" warnings
Uploader.php:
Version 2.5.5
SimpleAjaxUploader.js:
- Improved drag detection to work around Firefox bug which causes
dragenter
to fire twice (https://bugzilla.mozilla.org/show_bug.cgi?id=804036) - Set
dataTransfer.dropEffect
tocopy
duringdragover
event
Uploader.php:
- Improved filename sanitation
- Replaced instances of
array_key_exists
with the fasterisset
Version 2.5.4
SimpleAjaxUploader.js:
- Added check for parent node inside of
ss.isVisible()
- #160
Version 2.5.3
SimpleAjaxUploader.js:
- Fixed issue with
dragleave
firing when hovering a child element - #156 - (Special thanks to JulesDoe for this)
Version 2.5.2
SimpleAjaxUploader.js:
- Added param check before appending file to allow for manually appended files - #155 (Special thanks to ablipan for this)
- Fixed check of the internal variable which tracks active upload count to check as integer rather than
length
property - #150 (Special thanks to benzamin for this)
Examples:
Version 2.5.1
SimpleAjaxUploader.js:
- When returning
false
fromonSubmit()
, files will now be removed from queue automatically
Version 2.5.0
SimpleAjaxUploader.js:
Version 2.4
SimpleAjaxUploader.js:
multipart
option now defaults totrue
noParams
option now defaults totrue
Note: One or both of the above changes may be potentially breaking for anyone not using the included Uploader.php class. If this is the case, the fix is to explicitly set both of these options to false
in your plugin settings. More info: #137
- Added form integration functionality -- new option
form
and new methodsetForm()
. See README.md for details - Added
addButton()
method for adding upload buttons - #104 - Added
addDZ()
method for designating an element as a drop zone - Added
customProgressHeaders
option to include additional, custom request headers to upload progress update requests in legacy browsers - Added
autoCalibrate
option (defaulttrue
). WhenautoCalibrate
istrue
, upload buttons which are not visible at initialization will be auto reset withupdatePosition()
upon becoming visible - Added
onBlankSubmit()
callback function to be called when user attempts to submit without selecting a file - #101 - Improved event handler management for iFrame uploads
- Reconfigured code structure into more logical format
Version 2.3
SimpleAjaxUploader.js:
- Added UTF-8 encoding to XHR request headers in order to handle all characters/languages - #126, #128
- Added
encodeHeaders
option to enable/disable UTF-8 encoding of XHR request headers (default istrue
) - Removed
encodeCustomHeaders
option, as it is no longer necessary with newly added UTF-8 encoding for all headers onChange()
callback function now receives the selected file as its 5th argument - #132- Added
withCredentials
option to include user credentials in upload request (default isfalse
) - Updated
ss.trim()
to use native String.trim if available - Drag and drop file selection now correctly honors
return false
fromonChange()
callback function - Updated drag and drop functionality to cancel default action for
ondragover
andondragenter
per https://msdn.microsoft.com/library/ms536929(v=vs.85).aspx
Version 2.2.4
SimpleAjaxUploader.js:
- Added pre-check for element and class name params to
ss.hasClass
,ss.addClass
, andss.removeClass
methods
Uploader.php:
- Added
getMimeType($filename)
method for detecting the MIME Content-type of a file using the PHP finfo class - Added
isWebImage($filename)
method for checking whether a file is either a GIF, PNG, or JPEG using exif_imagetype
More info about the new methods can be found at: https://www.lpology.com/code/ajaxuploader/phpdocs.php
Version 2.2.3
SimpleAjaxUploader.js:
- Fixed bug in
destroy()
method that was throwing error in property delete loop
Version 2.2.2
- Switched to an improved UMD implementation
X-File-Name
request header is now encoded whenencodeCustomHeaders
is set totrue
- Added a few small mem leak fixes for IE9 and older
Version 2.2.1
SimpleAjaxUploader.js:
- Added file size as argument passed to
onComplete( filename, response, uploadBtn, size )
callback function - Added file size as argument passed to
onError( filename, type, status, statusText, response, uploadBtn, size )
callback function - Added file size as argument passed to
onAbort( filename, uploadBtn, size )
callback function
Package Management:
- Added package.json
- Added bower.json
- Added CommonJS support
Documentation:
- Updated API reference to fix missing and incomplete SimpleAjaxUploader.js API coverage
Version 2.2
SimpleAjaxUploader.js:
- Upload buttons are now clickable for 100% of height
- Changed mouseover and mouseout events from input field to div wrapper for better responsiveness
- Fixed bug where file input layout visibility was not returning to invisible on mouseout if
hoverClass
option not defined
Uploader.php:
- Added check to verify that upload directory exists before checking writability in order to provide more precise error messages
Documentation:
Version 2.1.1
SimpleAjaxUploader.js:
- Fixed
onChange()
button argument bug - #115 (Special thanks to zaygraveyard for this.)
Version 2.1
SimpleAjaxUploader.js:
- Headers are no longer URL encoded by default. A new option
encodeCustomHeaders
has been added, which when set totrue
will result in custom headers being URL encoded. - Added
updatePosition()
method for correcting the position of the upload button after interacting with form - #105 - (Special thanks to vovayatsyuk for this.) - Fixed drop zone element z-index bug
- Moved verification of drop zone element to inside of constructor
Version 2.0.1
Uploader.php:
- Fixed file name security vulnerability - #91 - (Special thanks to nickgardos for this)
SimpleAjaxUploader.js:
- Added support for Cyrillic characters in file names - #88 - (Special thanks to a-dorosh for this)
- Fixed issue with drag class not being removed on drag error
Version 2.0
SimpleAjaxUploader.js:
- Added support for drag and drop file uploads
- Added
ss.uploadSetup()
method to set default uploader option values (useful for multiple uploader instances) - Added
noParams
option to disable the default behavior of appending the file name to the URL query string - Numerous code improvements throughout -- bug fixes, memory usage, etc.
Uploader.php:
- Refactored into a single class in accordance with one class, one file
- Made improvements to error detection and handling
- Added support for reading the
X-File-Name
header as an alternative to query string parameters for sending file names to the server - Set default value of the
$uploadName
property to be"uploadfile"
for consistency with the examples - #72
Version 1.11
- Added support for PHP Session Upload Progress for PHP 5.4+ (APC was deprecated in 5.3)
- Added
clearQueue()
method which gives the user the ability to clear all files in queue - #62 - (Special thanks to mouse0270 for this one) - Fixed multiple file selection bug - #67 - (Special thanks to genintho for this)
- Fixed bug which could allow form/input elements to be created with invalid name/ID attributes in IE7-9
Version 1.10.1
iframe
andform
elements are now created withdocument.createElement()
rather than the much slower HTML injection method- Removed unused variable from
_uploadIframe()
Version 1.10
- Added
setOptions()
method for setting or changing upload options - #54 - (special thanks to hauru for this) - Added
customHeader
option for sending custom request headers - #47 (special thanks to cillosis for this) - Updated
ss.parseJSON()
to use a more secure method of manually parsing JSON
Version 1.9.1
onError()
callback now receives server response as an argument, if it exists, orfalse
if it does not - #37 (special thanks to KSDaemon for this)
API Change Note: For consistency with the other callbacks, the server response is passed toonError()
as the next to last argument, directly before the upload button. Therefore, if you use the upload button parameter inonError()
, you will need to update your code when upgrading.
- Switched from Google Closure Compiler to YUI Compressor for minification
Version 1.9
- Added CORS support - Learn more
- Query string parameters for Nginx Upload Progress Module in
_uploadIframe()
are now encoded withencodeURIComponent()
- Upload progress ID keys are now generated prior to each upload instead of on page load
- Query string parameters passed to
url
are now preserved - #34 (special thanks to Deefjuh for this)
Version 1.8.2
- A reference to the button which triggers an upload is now passed as the last argument to the following callbacks:
onAbort()
,onChange()
,onSubmit()
,onComplete()
,onError()
,startXHR()
,endXHR()
,startNonXHR()
,endNonXHR()
(can be useful when using multiple upload buttons) - Fixed bug which caused some methods to not work if called inside of
startXHR()
orstartNonXHR()
- Fixed bug causing undefined variable in IE9 and older if
progressUrl
andnginxProgressUrl
are not set
Version 1.8.1
- Added
destroy()
method for completely removing upload functionality - Removed redundant call to
ss.verifyElem()
inside ofrerouteClicks()
- Moved browser-specific checks to top of IIFE, as they only need to execute once
Version 1.8
SimpleAjaxUploader.js:
- Added support for Nginx Upload Progress Module
- Added
setAbortBtn()
method to designate an element as "cancel" button - Added
onAbort()
callback function to specify behavior upon manual abort - Added
setPctBox()
method to designate an element to be injected with upload progress percentage - Switched to a unique ID function that is RFC 4122 version 4 compliant
- The
button
option now accepts either a single button (element ID string, element, or jQuery object), or an array of buttons. If an array is passed, each element in the array will work as an upload button - Upload progress update request keys are now locally generated
- Fixed bug that was causing
onError()
to be fired twice - For consistency with jQuery behavior, any 2xx status code is now handled as a successful response (previously, only
200
and201
were successful) - Upload buttons are now being properly disabled/enabled at correct points
- Made significant improvements to error handling, particularly with iframe uploads and retrieving server provided progress updates
- Fixed a number of potential memory leaks for Internet Explorer
- Regular expressions are now pre-compiled and cached for better performance
- For server progress tracking,
sizeBox
andonUpdateFileSize()
are no longer pointlessly set/called again after first progress update is received
uploadProgress.php:
- Removed functionality for returning upload keys, as RFC 4122 v4 compliant UUIDs are now generated client side
Version 1.7
SimpleAjaxUploader.js:
- Fixed IE6/IE7 memory leak when removing elements without first removing event listeners (issue #21)
- Fixed possible race condition in which
removeCurrent()
could potentially delete the wrong file from the upload queue - Multiple file inputs are now disabled in Safari due to a browser bug that just screws everything up (see: http://stackoverflow.com/q/7231054/1091949)
- Switched to a smaller, faster process for cross-browser bounding box calculation
- Updated to faster methods of checking for, adding, and removing element CSS classes
- Combined
_checkExtension()
with_checkFile()
to eliminate a function call/reduce code size - Combined
_handleIframeResponse()
with_uploadIframe()
and switched to a more efficient method of getting iframe contents - Removed a number of unnecessary/redundant function calls, along with some unnecessary variable copying
- Updated
ss.verifyElem()
to use the much fastercharAt()
andsubstr()
in place of a regex andslice()
- Added separate feature detection for file input
accept
attribute
Uploader.php:
- Removed unnecessary check of
$allowedExtensions
fornull
value inhandleUpload()
- Added
final
keyword toFileUploadXHR
andFileUploadPOSTForm
classes and their respective methods to discourage direct use
Version 1.6.5
- When using
multipart
, additional data will now also appended to the multipart form. - Cleaned up some messy code -- organization, unnecessary variable copying, etc.
Version 1.6.4
- Switched from using
setAttribute
to dot notation for setting element properties (some versions of IE don't handlesetAttribute
well) ss.removeItem()
now uses the faster countdown method to loop through arrays- In accordance with W3 standards,
_uploadXhr()
now accepts either a200 OK
or201 Created
as a successful response - Uploader.php -- the
handleUpload()
method now checks whether theallowedExtensions
property isempty
instead ofnull
. This prevents an "Invalid file type" error resulting from passing an empty array
Version 1.6.3
- Fixed bug which allowed
onComplete()
to be called after JSON parse error
Version 1.6.2
- Overhauled error handling to fix a number of issues.
- Added consistent error types for
onError()
so that the second parameter will be either:parseerror
(bad JSON from server),transfererror
(xfer error during XHR upload),servererror
(server response not200 OK
) - Fixed problem with null file size parameter for
endXHR()
callback
Version 1.6.1
- Plugin is now wrapped in an IIFE
- Leading semicolon added to close any previous statement
- Code is now in strict mode
- Cleaned up a few messy areas
Version 1.6
If the 1.6 release has a theme, it is flexibility. Nearly every update in this release is intended to allow greater flexibility for developers.
- Submitting a file which exceeds
maxSize
or is not anallowedExtension
no longer triggers an alert, but will instead fire a callback - Added
onSizeError()
callback function which fires when a file exceeds themaxSize
option, if it is set - Added
onExtError()
callback which fires when a file is not permitted by theallowedExtensions
option, if it is set - Removed
messages
option and_errorMsg()
, both of which are no longer used - Added new
accept
option, the value of which will be the value of theaccept
file input attribute in supporting browsers. More info. - Added new
method
option to allow specifying an HTTP method other than POST
Special thanks to dleffler, devtrends and urcadox for their ideas and feedback.
Version 1.5.3
- Added
autoSubmit
check before submitting in_cycleQueue()
- Added check to ensure upload progress server key doesn't exceed 57 characters (max allowable APC key length)
rerouteClicks(element)
can now be used to add additional elements which can be clicked to open file box
Version 1.5.2
(This isn't as much a release as it is a signal to update for anyone who may have downloaded version 1.5.1 in the past few hours)
- Fixed "bug" from 1.5.1 that broke uploader without multiple option enabled
- Added
queue
option to disable automatic file queuing
Version 1.5.1
- Multiple file inputs are now used in browsers with support for File API, thus allowing multiple file selection if
multiple
option istrue
- Removed some unnecessary variable copying
- Added queue system which allows files to be selected and automatically uploaded as others finish
- Added
getQueueSize()
function to get current number of files waiting in queue - Fixed bug in which active upload counter was not properly updating when returning
false
fromstartXHR()
andstartNonXHR()
- Error messages now incorporate file names
Version 1.5
- Added support for multiple file uploading, along with Gmail-style multiple progress bars for tracking each file.
- Added new
maxSize
option for file size limits,allowedExtensions
option for file type restrictions. Custom error messages supported for both. - Updated
verifyElem()
to use a better method of detecting if an upload button is a jQuery object. - Numerous code enhancements throughout - updated error handling, cleaner organization, performance improvements.
- Patched some memory leaks created by circular references in event handlers.
Version 1.4.2
- SimpleAjaxUploader.js - Added
multipart
option to allow multipart form upload instead of binary stream - Uploader.php - The check for form uploads is now first in the constructor to accomodate new
multipart
option - Uploader.php - Providing an array of valid file extensions is now optional. If not provided, all file types are allowed
- Added minified version of JS file
Version 1.4.1
- Fixed XHR status check logic that could allow false alarm calls to onError callback
- Removed redundant XHR status check
- Returning false from a callback no longer clears the file field. Not sure why it ever did to begin with.
- A status check now occurs prior to progress update requests to prevent potential loop that could be caused by a server error
- Parsing JSON in older browsers no longer uses
eval
because it's evil
Version 1.4
This release includes a major overhaul that adds functionality for implementing cross-browser upload progress support. Through feature detection and abstraction, it is now possible for the onProgress
callback function to maintain consistent behavior across browsers.
Currently, only PHP (with APC extension) is supported. To use, set the newly added progressUrl
option to the URL of the included UploadProgress.php script, and onProgress
will then return upload progress data in Internet Explorer 9 and below.
Note that this added functionality does not affect the behavior of the plugin for those not using PHP, or just not using the feature.
For those not using PHP, a similar result can still be achieved with the startXH
/endXHR
and startNonXHR
/endNonXHR
callback functions, which are included specifically for defining behavior based on whether XHR uploads are supported.
Also, adding support for other programming languages would certainly be a welcome addition, if anyone is interested in working on that.
Other items:
- Added
onUpdateFileSize
callback function for getting file size in IE9 and below (When server supported progress is enabled) - Removed the unneccessary _handleJSON method
- Added new ss.newXHR method
- Added extras folder for non-necessary items (i.e., everything but SimpleAjaxUploader.js)
- Adjusted request headers for XHR uploads
- Moved support detection for HTML5 File API to constructor so it only executes once
- Timestamps now appended to URLs to prevent browsers from caching requests
Version 1.3
- Returned to version numbering
- Updated method for parsing JSON
- Added PHP class for handling file uploads
- Cleaned up messy areas
Earlier versions
Prior to version 1.3, I did a pretty horrible job of documenting changes, and, at one point, entirely dispensed with any notion of version control whatsoever. I have since seen the light.