DOCUMENTATION.

1.2

Installation

Install ImagePicker

Extract from the downloaded archive the entire imgPicker folder or the contents of it you your server.
Make sure that the files directory has 777 permission.
Now you can run the script in your browser. See the included examples.

Quick Configuration

ImagePicker has two sets of options: the jQuery plugin options (see Options section) and the PHP class options (see Configuration section). The included examples have some options set, but you can change them however you want.

This is how the jQuery plugin options look like:

$('#avatarModal').imgPicker({
    url: 'server/upload_avatar.php',
    aspectRatio: 1,
    cropSuccess: function(image) {
        $('#avatar').attr('src', image.versions.avatar.url);
        this.modal('hide');
    }
});

This is how the PHP class options look like:

$options = array(
    'upload_dir' => dirname(__FILE__) . '/../files/',
    'upload_url' => 'http://localhost/imgPicker/files/',
    'accept_file_types' => 'png|jpg|jpeg|gif',
    'versions' => array(
    	'avatar' => array(
    	    'crop' => true,
            'max_width' => 200,
            'max_height' => 200
    	)
    )
);

new ImgPicker($options);

Requirements

ImagePicker requires PHP >= 5.3.

Browser Compatibility

ImagePicker works on all major browsers (including mobile) with some exceptions*:

  • Chrome
  • Firefox
  • Opera
  • Safari 5*
  • Safari 7
  • IE8* and IE9*
  • IE10 and IE11

*Only upload works due to no XHR support.