update doc and uploader refactor, related #47

Author: joni2back

API.md

@@ -1,16 +1,16 @@
 ## angular-filemanager API docs
 
-#### Listing
-    URL: fileManagerConfig.listUrl, Method: POST
-##### JSON Request content
+#### Listing (URL: fileManagerConfig.listUrl, Method: POST)
+
+**JSON Request content**
 ```json
 { "params": {
     "mode": "list",
     "onlyFolders": false,
     "path": "/public_html"
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": [ 
     {
@@ -35,97 +35,90 @@
 ]}
 ```
 --------------------
-#### Rename / Move
-    URL: fileManagerConfig.renameUrl, Method: POST
-##### JSON Request content
+#### Rename / Move (URL: fileManagerConfig.renameUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "rename",
     "path": "/public_html/index.php",
     "newPath": "/public_html/index2.php"
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Copy
-    URL: fileManagerConfig.copyUrl, Method: POST
-##### JSON Request content
+#### Copy (URL: fileManagerConfig.copyUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "copy",
     "path": "/public_html/index.php",
     "newPath": "/public_html/index-copy.php"
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Remove
-    URL: fileManagerConfig.removeUrl, Method: POST
-##### JSON Request content
+#### Remove (URL: fileManagerConfig.removeUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "delete",
     "path": "/public_html/index.php",
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Edit file
-    URL: fileManagerConfig.editUrl, Method: POST
-##### JSON Request content
+#### Edit file (URL: fileManagerConfig.editUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "savefile",
     "content": "<?php echo random(); ?>",
     "path": "/public_html/index.php",
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Get content of a file
-    URL: fileManagerConfig.getContentUrl, Method: POST
-##### JSON Request content
+#### Get content of a file (URL: fileManagerConfig.getContentUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "editfile",
     "path": "/public_html/index.php"
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": "<?php echo random(); ?>" }
 ```
 --------------------
-#### Create folder
-    URL: fileManagerConfig.createFolderUrl, Method: POST
-##### JSON Request content
+#### Create folder (URL: fileManagerConfig.createFolderUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "addfolder",
     "name": "new-folder",
     "path": "/public_html"
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Set permissions
-    URL: fileManagerConfig.permissionsUrl, Method: POST
-##### JSON Request content
+#### Set permissions (URL: fileManagerConfig.permissionsUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "changepermissions",
@@ -135,29 +128,27 @@
     "recursive": false
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Compress file
-    URL: fileManagerConfig.compressUrl, Method: POST
-##### JSON Request content
+#### Compress file (URL: fileManagerConfig.compressUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "compress",
     "path": "/public_html/compressed.zip",
     "destination": "/public_html/backups"
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Extract file
-    URL: fileManagerConfig.extractUrl, Method: POST
-##### JSON Request content
+#### Extract file (URL: fileManagerConfig.extractUrl, Method: POST)
+**JSON Request content**
 ```json
 { "params": {
     "mode": "extract",
@@ -166,36 +157,49 @@
     "sourceFile": "/public_html/compressed.zip"
 }}
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
 --------------------
-#### Upload file
-    URL: fileManagerConfig.uploadUrl, Method: POST, Content-Type: multipart/form-data
-    Unlimited file upload, each item will be enumerated as file-1, file-2, etc.
-##### Http post params
+#### Upload file (URL: fileManagerConfig.uploadUrl, Method: POST, Content-Type: multipart/form-data)
+
+**Http post request payload**
 ```
-[fileManagerConfig.uploadUrl]?destination=/public_html/image.jpg&file-1={..}&file-2={...}
+------WebKitFormBoundaryqBnbHc6RKfXVAf9j
+Content-Disposition: form-data; name="destination"
+/
+
+------WebKitFormBoundaryqBnbHc6RKfXVAf9j
+Content-Disposition: form-data; name="file-0"; filename="github.txt"
+Content-Type: text/plain
 ```
-##### JSON Response
+**JSON Response**
 ```json
 { "result": { "success": true, "error": null } }
 ```
+
+Unlimited file items to upload, each item will be enumerated as file-0, file-1, etc.
+
+For example, you may retrieve the file in PHP using:
+```php
+$destination = $_POST['destination'];
+$_FILES['file-0'] or foreach($_FILES)
+```
 --------------------
-#### Download / Preview file
-    URL: fileManagerConfig.downloadFileUrl, Method: GET
-##### Http query params
+#### Download / Preview file (URL: fileManagerConfig.downloadFileUrl, Method: GET)
+**Http query params**
 ```
 [fileManagerConfig.downloadFileUrl]?mode=download&preview=true&path=/public_html/image.jpg
 ```
-##### Response
+**Response**
 ```
 -File content
 ```
 --------------------
 ##### Errors / Exceptions
 Any backend error should be with an error 500 HTTP code.
+
 Btw, you can also report errors with a 200 response both using this json structure
 ```json
 { "result": {

assets/js/fileuploader.js

@@ -4,25 +4,25 @@
 
         var self = this;
         self.requesting = false; 
-        self.upload = function(fileList, path, success, error) {
-            var form = new window.FormData();
- 
+        self.upload = function(fileList, path) {
+            var form = new window.FormData();  
             form.append('destination', '/' + path.join('/'));
-            for (var file in fileList) {
-                var fileObj = fileList[file];
-                typeof fileObj === 'object' && form.append('file-' + (1 + parseInt(file, null)), fileObj);
+
+            for (var i = 0; i < fileList.length; i++) {
+                var fileObj = fileList.item(i);
+                fileObj instanceof window.File && form.append('file-' + i, fileObj);
             }
 
             self.requesting = true;
             return $http.post(fileManagerConfig.uploadUrl, form, {
                 transformRequest: angular.identity,
-                headers: {'Content-Type': undefined}
+                headers: {
+                    "Content-Type": undefined
+                }
             }).success(function(data) {
-                self.requesting = false;
-                typeof success === 'function' && success(data);
+                self.inprocess = false;
             }).error(function(data) {
-                self.requesting = false;
-                typeof error === 'function' && error(data);
+                self.inprocess = false;
             });
         };
     }]);