Installation

• Install Image Picker
• Quick Configuration
• Server Requirements
• Browser Support

Install Image Picker

• Extract and copy the files from the archive you have downloaded from github to your server or local server.
• Make sure that the files directory has 755 (or 777) permission.
• Now you can run the script in your browser. See the included examples.

Quick Configuration

Image Picker 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' => __DIR__ . '/../files/',
    'upload_url' => 'files/',
    'accept_file_types' => 'png|jpg|jpeg|gif',
    'versions' => array(
        'avatar' => array(
            'crop' => true,
            'max_width' => 200,
            'max_height' => 200
        )
    )
);

new ImgPicker($options);

Server Requirements

Image Picker requires PHP 8+ with GD.

Browser Support

Image Picker works on all major browsers (including mobile) with some exceptions:

• Chrome
• Firefox
• Opera
• Safari 5+
• IE8+

Starting with version 47, Chrome requires a secure connection (SSL) in order to use the Webcam. Read more here.