Version 1.3.

Author: cretueusebiu

autoload.md

@@ -11,15 +11,15 @@ First we start with the PHP:
 session_start();
 
 // Let's say that you grab the user id from the session
-$user_id = $_SESSION['user_id'];
+$userId = $_SESSION['user_id'];
 
 // Include ImgPicker.php class
-require dirname(__FILE__) . '/ImgPicker.php';
+require __DIR__ . '/ImgPicker.php';
 
 // ImgPicker options
 $options = array(
     // Upload directory path
-    'upload_dir' => dirname(__FILE__) . '/../files/',
+    'upload_dir' => __DIR__ . '/../files/',
     // Upload directory url
     'upload_url' => 'files/',
     // Image versions
@@ -32,33 +32,28 @@ $options = array(
         )
     ),
     // !!! Here you have to return the user image
-    'load' => function($instance) {
-        global $user_id;
+    'load' => function () use ($userId) {
         // Make a query from database and return the filename:
         return '123.png';
     },
-    
     // Upload start callback
-    'upload_start' => function($image, $instance) {
-        global $user_id;
+    'upload_start' => function ($image) use ($userId) {
         // Name the temp image as $user_id
         $image->name = '~'.$user_id.'.'.$image->type;   
     },
     // Crop start callback
-    'crop_start' => function($image, $instance) {
-       global $user_id;
+    'crop_start' => function ($image) use ($userId) {
        // Change the name of the image
        $image->name = $user_id.'.'.$image->type;
     },
     // Crop complete callback
-    'crop_complete' => function($image, $instance) {
+    'crop_complete' => function ($image) use ($userId) {
         // Save the image to database
     }
 );
 
 // Create ImgPicker instance
 new ImgPicker($options);
-?>
 ```
 
 And the JavaScript code:

configuration.md

@@ -2,17 +2,17 @@
 
 - [Options](#options)
 - [Callback Options](#callback-options)
+- [Messages](#messages)
 
 When you create a new instance of `ImgPicker` you can pass some options:
 
 ```php
 <?php
 $options = array(
-   'upload_dir' => dirname(__FILE__) . '/../files/',
+   'upload_dir' => __DIR__ . '/../files/',
    'max_file_size' => 3000000 
 )
 new ImgPicker($options);
-?>
 ```
 
 ## Options
@@ -99,9 +99,9 @@ Image versions. Array with image versions to be created. Each element is another
     // This will create 2 image versions: the original one and a 200x200 one
     'avatar' => array(
         // Other upload directory path (Default: main upload_dir)
-        'upload_dir' => dirname(__FILE__) . '/../files/avatar/',
+        'upload_dir' => __DIR__ . '/../files/avatar/',
         // Other upload directory url (Default: main upload_url)
-        'upload_url' => 'http://localhost/imgPicker/files/avatar/',
+        'upload_url' => 'files/avatar/',
         // Create square image (Default: false)
         'crop' => true,
         // Max width (Default: n/a)
@@ -133,10 +133,9 @@ Called when autoloading image.
 
 ```php
  /**
- *  @param  ImgPicker       $instance
  *  @return string|array
  */
-'load' => function($instance) {
+'load' => function () {
     // You can make a query from your database and return the image:
     // return '123.jpg'; |  return array('1.jpg', '2.jpg');
 },
@@ -148,11 +147,10 @@ Called when trying to delete image.
 
 ```php
  /**
- *  @param  stdClass        $filename
- *  @param  ImgPicker       $instance
+ *  @param  stdClass $filename
  *  @return boolean
  */
-'delete' => function($filename, $instance) {
+'delete' => function ($filename) {
     // Wether to allow file deletion
     return true;
 },
@@ -164,11 +162,10 @@ Called before the upload starts.
 
 ```php
  /**
- *  @param  stdClass        $image
- *  @param  ImgPicker       $instance
+ *  @param  stdClass $image
  *  @return void
  */
-'upload_start' => function($image, $instance) {
+'upload_start' => function ($image) {
 },
 ```
 
@@ -178,11 +175,10 @@ Called after upload.
 
 ```php
  /**
- *  @param  stdClass        $image
- *  @param  ImgPicker       $instance
+ *  @param  stdClass $image
  *  @return void
  */
-'upload_complete' => function($image, $instance) {
+'upload_complete' => function ($image) {
 },
 ```
 
@@ -192,11 +188,10 @@ Called before the crop starts.
 
 ```php
  /**
- *  @param  stdClass        $image
- *  @param  ImgPicker       $instance
+ *  @param  stdClass $image
  *  @return void
  */
-'crop_start' => function($image, $instance) {
+'crop_start' => function ($image) {
 },
 ```
 
@@ -206,11 +201,10 @@ Called after cropping.
 
 ```php
  /**
- *  @param  stdClass        $image
- *  @param  ImgPicker       $instance
+ *  @param  stdClass $image
  *  @return void
  */
-'crop_complete' => function($image, $instance) {
+'crop_complete' => function ($image) {
 },
 ```
 
@@ -226,3 +220,38 @@ In all callbacks the `$image` parameter is an `stdClass` object and has the foll
 - `versions` _array_ (available only in _upload_complete_ and _crop_complete_)
 
 You can access them like this: `$image->name`, `$image->path`.
+
+### Messages
+
+If you wish to change the messages, pass an array with the messages:
+
+```php
+<?php
+
+$options = array();
+
+$messages = array(
+    1 => 'The uploaded file exceeds the upload_max_filesize directive in php.ini',
+    2 => 'The uploaded file exceeds the MAX_FILE_SIZE directive that was specified in the HTML form',
+    3 => 'The uploaded file was only partially uploaded',
+    4 => 'No file was uploaded',
+    6 => 'Missing a temporary folder',
+    7 => 'Failed to write file to disk',
+    8 => 'A PHP extension stopped the file upload',
+    'gd' => 'PHP GD library is NOT installed on your web server',
+    'post_max_size' => 'The uploaded file exceeds the post_max_size directive in php.ini',
+    'max_file_size' => 'File is too big',
+    'min_file_size' => 'File is too small',
+    'accept_file_types' => 'Filetype not allowed',
+    'max_width'  => 'Image exceeds maximum width of ',
+    'min_width'  => 'Image requires a minimum width of ',
+    'max_height' => 'Image exceeds maximum height of ',
+    'min_height' => 'Image requires a minimum height of ',
+    'upload_failed' => 'Failed to upload the file',
+    'move_failed' => 'Failed to upload the file',
+    'invalid_image' => 'Invalid image',
+    'image_resize' => 'Failed to resize image',
+    'not_exists' => 'Failed to load the image'
+); 
+new ImgPicker($options, $messages);
+```

database.md

@@ -4,9 +4,9 @@ This example will show to save and load an image from database using the some fu
 
 Before continuing with this example make sure you have read the [Modal & Inline](modal-inline.md) example.
 
-For this we need some functions to connect to database, insert, update and select. The script comes with a Database class that can be found in `server/Database`.
+For this we need some functions to connect to database, insert, update and select. The script comes with a Database class that can be found in `server/DB`.
 
-First you need to edit `server/Database/config.php` and set you database connection details. 
+First you need to edit `server/DB/config.php` and set you database connection details. 
 You also need a table where you insert the images (or you can use your own table), but for this example I'll use the included SQL table: `example_images.sql`.
 
 Now in `upload_avatar.php` include the Database class and use it as shown below:
@@ -16,19 +16,21 @@ Now in `upload_avatar.php` include the Database class and use it as shown below:
 <?php
 session_start();
 
-// Let's say that you grab the user id from the session
-$user_id = $_SESSION['user_id'];
+// Include Database classs
+require  __DIR__.'/DB/Database.php';
 
-// Include ImgPicker.php class
-require dirname(__FILE__) . '/ImgPicker.php';
+Database::connect(require __DIR__.'/DB/config.php');
 
-// Include Database classs
-require dirname(__FILE__) . '/Database/Database.php';
+// Include ImgPicker class
+require __DIR__ . '/ImgPicker.php';
+
+// Let's say that you grab the user id from the session
+$userId = $_SESSION['user_id'];
 
 // ImgPicker options
 $options = array(
     // Upload directory path
-    'upload_dir' => dirname(__FILE__) . '/../files/',
+    'upload_dir' => __DIR__ . '/../files/',
     // Upload directory url
     'upload_url' => 'files/',
     // Image versions
@@ -40,60 +42,57 @@ $options = array(
             'max_height' => 200
         )
     ),
-    'load' => function($instance) {
-        global $user_id;        
+    'load' => function () use ($userId) {
         // Select the image for the current user
         $db = new Database;
         $results = $db->table('example_images')
-                      ->where('user_id', $user_id)
+                      ->where('user_id', $userId)
                       ->limit(1)
                       ->get();
-        if ($results) 
+
+        if ($results) {
             return $results[0]->image;
-        else 
+        } else {
             return false;
+        }
     },
-    
     // Upload start callback
-    'upload_start' => function($image, $instance) {
-        global $user_id;
-        // Name the temp image as $user_id
-        $image->name = '~'.$user_id.'.'.$image->type;   
+    'upload_start' => function ($image) use ($userId) {
+        // Name the temp image as $userId
+        $image->name = '~'.$userId.'.'.$image->type;   
     },
     // Crop start callback
-    'crop_start' => function($image, $instance) {
-       global $user_id;
+    'crop_start' => function ($image) use ($userId) {
        // Change the name of the image
-       $image->name = $user_id.'.'.$image->type;
+       $image->name = $userId.'.'.$image->type;
     },
     // Crop complete callback
-    'crop_complete' => function($image, $instance) {
-        global $user_id;
+    'crop_complete' => function ($image) use ($userId) {
         // Save the image to database
         $data = array(
-           'user_id' => $user_id,
+           'user_id' => $userId,
            'image' => $image->name
         );
 
         $db = new Database;
         // First check if the image exists
         $results = $db->table('example_images')
-                      ->where('user_id', $user_id)
+                      ->where('user_id', $userId)
                       ->limit(1)
                       ->get();
 
         // If exists update, otherwise insert
-        if ($results) 
+        if ($results) {
             $db->table('example_images')
-               ->where('user_id', $user_id)
+               ->where('user_id', $userId)
                ->limit(1)
                ->update($data);
-        else
+        } else {
             $db->table('example_images')->insert($data);
+        }
     }
 );
 
 // Create ImgPicker instance
 new ImgPicker($options);
-?>
 ```

installation.md

@@ -32,8 +32,8 @@ This is how the PHP class options look like:
 
 ```php
 $options = array(
-    'upload_dir' => dirname(__FILE__) . '/../files/',
-    'upload_url' => 'http://localhost/imgPicker/files/',
+    'upload_dir' => __DIR__ . '/../files/',
+    'upload_url' => 'files/',
     'accept_file_types' => 'png|jpg|jpeg|gif',
     'versions' => array(
         'avatar' => array(
@@ -61,4 +61,6 @@ Image Picker works on all major browsers (including mobile) with some exceptions
 - Safari 5+
 - IE8+
 
+Starting with version 47, Chrome requires a secure connection (SSL) in order to use the Webcam. Read more [here](https://sites.google.com/a/chromium.org/dev/Home/chromium-security/deprecating-powerful-features-on-insecure-origins).
+
 In Safari 5, IE8 and IE9 only the upload works due to no [XHR](http://caniuse.com/#search=XMLHttpRequest) support.

modal-inline.md

@@ -22,7 +22,7 @@ The fist option is to have the ImagePicker as a modal. For this you have to defi
 
 
 <!-- Image -->
-<img src="assets/img/default-avatar.png" id="avatar" width="200" height="200">
+<img src="http://www.gravatar.com/avatar/0?d=mm&s=150" id="avatar" width="200" height="200">
 
 <!-- Button trigger modal -->
 <button type="button" data-ip-modal="#myModal">Launch modal</button>
@@ -82,7 +82,7 @@ $(function() {
         aspectRatio: 1,
         deleteComplete: function() {
             // Restore default avatar
-            $('#avatar').attr('src', 'assets/img/default-avatar.png');
+            $('#avatar').attr('src', 'http://www.gravatar.com/avatar/0?d=mm&s=150');
             // Hide modal
             this.modal('hide');
         },
@@ -146,7 +146,7 @@ $(function() {
         url: 'server/upload_avatar.php',
         aspectRatio: 1,
         deleteComplete: function() {
-            $('#avatar').attr('src', 'assets/img/default-avatar.png');
+            $('#avatar').attr('src', 'http://www.gravatar.com/avatar/0?d=mm&s=150');
             this.modal('hide');
         },
         cropSuccess: function(image) {