add Chinese(Simplified) language

.gitignore

@@ -12,3 +12,4 @@
 xcuserdata/
 project.xcworkspace/
 tags
+.idea

README.md

@@ -8,9 +8,14 @@ Cordova Plugin For Multiple Image Selection - implemented for iOS and Android 4.
 The plugin conforms to the Cordova plugin specification, it can be installed
 using the Cordova / Phonegap command line interface.
 
-    phonegap plugin add https://github.com/wymsee/cordova-imagePicker.git
+    # without desc
+    phonegap plugin add https://github.com/Telerik-Verified-Plugins/ImagePicker.git
+    cordova plugin add https://github.com/Telerik-Verified-Plugins/ImagePicker.git
+
+    # with desc
+    phonegap plugin add https://github.com/Telerik-Verified-Plugins/ImagePicker.git --variable PHOTO_LIBRARY_USAGE_DESCRIPTION="your usage message"
 
-    cordova plugin add https://github.com/wymsee/cordova-imagePicker.git
+    cordova plugin add https://github.com/Telerik-Verified-Plugins/ImagePicker.git --variable PHOTO_LIBRARY_USAGE_DESCRIPTION="your usage message"
 
 
 ## Using the plugin
@@ -20,54 +25,92 @@ The plugin creates the object `window.imagePicker` with the method `getPictures(
 Example - Get Full Size Images (all default options):
 ```javascript
 window.imagePicker.getPictures(
-	function(results) {
-		for (var i = 0; i < results.length; i++) {
-			console.log('Image URI: ' + results[i]);
-		}
-	}, function (error) {
-		console.log('Error: ' + error);
-	}
+    function(results) {
+        for (var i = 0; i < results.length; i++) {
+            console.log('Image URI: ' + results[i]);
+        }
+    }, function (error) {
+        console.log('Error: ' + error);
+    }
 );
 ```
 
 Example - Get at most 10 images scaled to width of 800:
 ```javascript
 window.imagePicker.getPictures(
-	function(results) {
-		for (var i = 0; i < results.length; i++) {
-			console.log('Image URI: ' + results[i]);
-		}
-	}, function (error) {
-		console.log('Error: ' + error);
-	}, {
-		maximumImagesCount: 10,
-		width: 800
-	}
+    function(results) {
+        for (var i = 0; i < results.length; i++) {
+            console.log('Image URI: ' + results[i]);
+        }
+    }, function (error) {
+        console.log('Error: ' + error);
+    }, {
+        maximumImagesCount: 10,
+        width: 800
+    }
 );
 ```
 
 ### Options
 
     options = {
-        // max images to be selected, defaults to 15. If this is set to 1, upon
-    	// selection of a single image, the plugin will return it.
-    	maximumImagesCount: int,
-
-    	// max width and height to allow the images to be.  Will keep aspect
-    	// ratio no matter what.  So if both are 800, the returned image
-    	// will be at most 800 pixels wide and 800 pixels tall.  If the width is
-    	// 800 and height 0 the image will be 800 pixels wide if the source
-    	// is at least that wide.
-    	width: int,
-    	height: int,
-
-    	// quality of resized image, defaults to 100
-    	quality: int (0-100)
+        // Android only. Max images to be selected, defaults to 15. If this is set to 1, upon
+        // selection of a single image, the plugin will return it.
+        maximumImagesCount: int,
+
+        // max width and height to allow the images to be.  Will keep aspect
+        // ratio no matter what.  So if both are 800, the returned image
+        // will be at most 800 pixels wide and 800 pixels tall.  If the width is
+        // 800 and height 0 the image will be 800 pixels wide if the source
+        // is at least that wide.
+        width: int,
+        height: int,
+
+        // quality of resized image, defaults to 100
+        quality: int (0-100),
+
+        // output type, defaults to FILE_URIs.
+        // available options are 
+        // window.imagePicker.OutputType.FILE_URI (0) or 
+        // window.imagePicker.OutputType.BASE64_STRING (1)
+        outputType: int
     };
 
 ### Note for Android Use
 
-The plugin returns images that are stored in a temporary directory.  These images will often not be deleted automatically though.  The files should be moved or deleted after you get their filepaths in javascript.
+When outputType is FILE_URI the plugin returns images that are stored in a temporary directory.  These images will often not be deleted automatically though.  The files should be moved or deleted after you get their filepaths in javascript. If Base64 Strings are being returned, there is nothing to clean up.
+
+## Android 6 (M) Permissions
+On Android 6 you need to request permission to read external storage at runtime when targeting API level 23+.
+Even if the `uses-permission` tags for the Calendar are present in `AndroidManifest.xml`.
+
+Note that the `hasReadPermission` function will return true when:
+
+- You're running this on iOS, or
+- You're targeting an API level lower than 23, or
+- You're using Android < 6, or
+- You've already granted permission.
+
+```js
+  function hasReadPermission() {
+    window.imagePicker.hasReadPermission(
+      function(result) {
+        // if this is 'false' you probably want to call 'requestReadPermission' now
+        alert(result);
+      }
+    )
+  }
+
+  function requestReadPermission() {
+    // no callbacks required as this opens a popup which returns async
+    window.imagePicker.requestReadPermission();
+  }
+```
+
+Note that backward compatibility was added by checking for read permission automatically when `getPictures` is called.
+If permission is needed the plugin will now show the permission request popup.
+The user will then need to allow access and invoke the same method again after doing so.
+
 
 ## Libraries used
 
@@ -109,4 +152,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+THE SOFTWARE.

demo/index.html

@@ -0,0 +1,53 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta name="format-detection" content="telephone=no">
+  <meta name="msapplication-tap-highlight" content="no">
+  <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width">
+  <link rel="stylesheet" type="text/css" href="css/index.css">
+  <title>ImagePicker demo</title>
+</head>
+<body>
+<div class="app">
+  <h1>ImagePicker demo</h1>
+
+  <div id="deviceready" class="blink">
+    <p class="event listening">Connecting to Device</p>
+
+    <p class="event received">Device is Ready</p>
+    <button onclick="getPics()">get pics</button>
+  </div>
+</div>
+<script type="text/javascript" src="cordova.js"></script>
+<script type="text/javascript" src="js/index.js"></script>
+<script>
+  function getPics() {
+    imagePicker.getPictures(
+        function (result) {
+          var content = '';
+          for (var i = 0; i < result.length; i++) {
+            content += '<img src="' + result[i] + '" style="max-width:200px"/>';
+            //content += '<img src="data:image/jpg;base64,'+result[i]+'" style="max-width:200px"/>';
+          }
+          document.getElementById("imageOutput").innerHTML = content;
+        }, function (error) {
+          alert('Error: ' + error);
+        }, {
+          // if no title is passed, the plugin should use a sane default (preferrably the same as it was, so check the old one.. there are screenshots in the marketplace doc)
+          maximumImagesCount: 10,
+          title: 'Select pix',
+          message: 'Pick max 10 items', // optional default no helper message above the picker UI
+          // be careful with these options as they require additional processing
+          width: 400,
+          quality: 80
+          //             outputType: imagePicker.OutputType.BASE64_STRING
+        }
+    );
+  }
+</script>
+
+<div id="imageOutput">
+</div>
+
+</body>
+</html>