Jquery File Upload Function With Database Integration
Cloudinary jQuery Plugin with file upload - bower and npm repository
Cloudinary is a cloud service that offers a solution to a spider web awarding'southward unabridged image management pipeline.
Easily upload images to the deject. Automatically perform smart epitome resizing, cropping and conversion without installing whatsoever complex software. Integrate Facebook or Twitter profile image extraction in a snap, in any dimension and style to friction match your website's graphics requirements. Images are seamlessly delivered through a fast CDN, and much much more.
Cloudinary offers comprehensive APIs and administration capabilities and is easy to integrate with any web application, existing or new.
Cloudinary provides URL and HTTP based APIs that can be hands integrated with any Web development framework.
For Javascript, Cloudinary provides a jQuery plugin for simplifying the integration fifty-fifty further.
The direct image upload feature of the plugin is based on https://github.com/blueimp/jQuery-File-Upload
Getting started guide
Have a look at our Getting started guide for jQuery.
Installation
bower
-
Install the files using the following command. Use the optional
--save
parameter if you wish to save the dependency in your bower.json file.bower install cloudinary-jquery-file-upload
-
Include the javascript file in your HTML. For Example:
< script src="bower_components/jquery/dist/jquery.js" type="text/javascript"> </ script > < script src="bower_components/blueimp-file-upload/js/vendor/jquery.ui.widget.js" type="text/javascript"> </ script > < script src="bower_components/blueimp-file-upload/js/jquery.iframe-transport.js" type="text/javascript"> </ script > < script src="bower_components/blueimp-file-upload/js/jquery.fileupload.js" type="text/javascript"> </ script > < script src="bower_components/cloudinary-jquery-file-upload/cloudinary-jquery-file-upload.js" type="text/javascript"> </ script >
NPM
-
Install the files using the post-obit commands. Utilize the optional
--save
parameter if you wish to save the dependency in yourpackage.json
file.npm install jquery npm install blueimp-file-upload npm install cloudinary-jquery-file-upload
-
Include the javascript file in your HTML. For Example:
< script src="node_modules/jquery/dist/jquery.js" type="text/javascript"> </ script > < script src="node_modules/blueimp-file-upload/js/vendor/jquery.ui.widget.js" blazon="text/javascript"> </ script > < script src="node_modules/blueimp-file-upload/js/jquery.iframe-transport.js" type="text/javascript"> </ script > < script src="node_modules/blueimp-file-upload/js/jquery.fileupload.js" type="text/javascript"> </ script > < script src="node_modules/cloudinary-jquery-file-upload/cloudinary-jquery-file-upload.js"> </ script >
For the server side NPM library, refer to https://github.com/cloudinary/cloudinary_npm.
Setup
In guild to properly utilize this library you have to provide it with a few configuration parameters:
Required:
-
cloud_name
- The cloudinary deject proper noun associated with your Cloudinary account.
Optional:
-
private_cdn
,secure_distribution
,cname
,cdn_subdomain
- Delight refer to Cloudinary Documentation for information on these parameters.
To set up these configuration parameters utilise the Cloudinary::config
function (see below).
Note:
When loading the jQuery Cloudinary library directly (using a script
tag), the library automatically converts the relevant fileupload tags to utilize the upload functionality. If jquery.cloudinary is loaded as an AMD withal, you need to initialize the Cloudinary fileupload fields e.g., past calling $("input.cloudinary-fileupload[type=file]").cloudinary_fileupload();
Usage
The following web log post details the process of setting upwardly a jQuery based file upload. http://cloudinary.com/web log/direct_image_uploads_from_the_browser_to_the_cloud_with_jquery
The Cloudinary Documentation can be institute at: http://cloudinary.com/documentation
Cloudinary JavaScript library
The Cloudinary JavaScript library API reference can be found at: https://cloudinary.github.io/pkg-cloudinary-jquery-file-upload
The Cloudinary JavaScript library provides several classes, defined under the "cloudinary
" domain.
Configuration
Start by instantiating a new Cloudinary course:
Equally jQuery plugin
An example of the Cloudinary jQuery main class, CloudinaryJQuery
, is instantiated every bit $.cloudinary
.
$ . cloudinary . config ( { cloud_name: "demo" } ) ;
Explicitly
var cl = cloudinary . CloudinaryJQuery . new ( { cloud_name: "demo" } ) ;
Using the config function
// Using the config role var cl = cloudinary . CloudinaryJQuery . new ( ) ; cl . config ( "cloud_name" , "demo" ) ;
From meta tags in the electric current HTML document
When using the library in a browser environment, you can use meta tags to define the configuration options.
The init()
function is a convenience function that invokes both fromDocument()
and fromEnvironment()
.
For case, add the following to the header tag:
< meta name="cloudinary_cloud_name" content="demo">
In your JavaScript source, invoke fromDocument()
:
var cl = cloudinary . Cloudinary . new ( ) ; cl . fromDocument ( ) ; // or cl . init ( ) ;
From environment variables
When using the library in a backend environs such every bit NodeJS, you can utilise an surround variable to ascertain the configuration options.
Prepare the environment variable, for case:
export CLOUDINARY_URL=cloudinary://demo
In your JavaScript source, invoke fromEnvironment()
:
var cl = cloudinary . Cloudinary . new ( ) ; cl . fromEnvironment ( ) ; // or cl . init ( ) ;
URL generation
cl . url ( "sample" ) // "http://res.cloudinary.com/demo/image/upload/sample" cl . url ( "sample" , { width: 100 , crop: "fit" } ) // "http://res.cloudinary.com/demo/image/upload/c_fit,w_100/sample"
HTML tag generation
You lot can generate HTML tags in several ways:
Cloudinary::image()
generates a DOM tag, and prepares it for responsive functionality. This is the same functionality as $.cloudinary.prototype()
. (When using the jQuery plugin, the src-cache
data attribute is stored using jQuery'south information()
method and so is not visible.)
produces:
< img src="http://res.cloudinary.com/demo/prototype/upload/sample">
You tin can generate an image Tag using the imageTag
function:
var tag = cl . imageTag ( "sample" ) ; tag . toHtml ( ) ;
which produces:
< img src="http://res.cloudinary.com/demo/epitome/upload/sample">
and:
tag . transformation ( ) . crop ( "fit" ) . width ( 100 ) . toHtml ( ) ;
which produces:
< img src="http://res.cloudinary.com/demo/paradigm/upload/c_fit,w_100/sample">
You can likewise use ImageTag
independently:
var tag = cloudinary . ImageTag . new ( "sample" , { cloud_name: "some_other_cloud" } ) ; tag . toHtml ( ) ;
which produces:
< img src="http://res.cloudinary.com/some_other_cloud/image/upload/sample">
Transformation
In addition to using a apparently object to define transformations or using the builder methods (both described above), yous can ascertain transformations past using the Transformation course:
var tr = cloudinary . Transformation . new ( ) ; tr . crop ( "fit" ) . width ( 100 ) ; tr . serialize ( ) // "c_fit,w_100"
You lot tin also chain transformations together:
var tr = cloudinary . Transformation . new ( ) ; tr . width ( 10 ) . crop ( 'fit' ) . concatenation ( ) . angle ( 15 ) . serialize ( ) // "c_fit,w_10/a_15"
jQuery plugin
This Cloudinary jQuery plugin is fully astern compatible with the previous cloudinary_js version. When loaded, the new JavaScript library instantiates a CloudinaryJQuery object and attaches it to jQuery.
The post-obit listing includes a sample of the API provided by this library:
-
$.cloudinary.config(parameter_name, parameter_value)
- Sets parameter_name's value to parameter_value. -
$.cloudinary.url(public_id, options)
- Returns a cloudinary URL based on your configuration and the given options. -
$.cloudinary.image(public_id, options)
- Returns an HTML image tag for the photo specified by public_id -
$.cloudinary.facebook_profile_image
,$.cloudinary.twitter_profile_image
,$.cloudinary.twitter_name_profile_image
,$.cloudinary.gravatar_image
,$.cloudinary.fetch_image
- Same equallyprototype
just returns a specific type of image. -
$(jquery_selector).cloudinary(options)
- Goes over the elements specified by the jQuery selector and changes all the images to be fetched using Cloudinary's CDN. Using options, you can likewise specify transformations to the images. Theoptions
parameters are similar across all cloudinary frameworks. Please refer to jQuery image manipulation for a more than consummate reference regarding the options.
See our documentation for more information almost displaying and transforming images using jQuery.
Other Cloudinary JavaScript libraries
Core Javascript library
The Core Cloudinary JavaScript library does not depend on jQuery: https://github.com/cloudinary/pkg-cloudinary-core.
jQuery plugin
If you are using jQuery, but are not using the Blueimp File Upload library you tin have advantage of the Cloudinary jQuery plugin at https://github.com/cloudinary/pkg-cloudinary-jquery.
Additional resources
Additional resources are available at:
- Website
- Documentation
- Knowledge Base
- Documentation for jQuery integration
- jQuery image upload documentation
- jQuery image manipulation documentation
- Prototype transformations documentation
Support
Yous can open an issue through GitHub.
Contact us at http://cloudinary.com/contact.
Stay tuned for updates, tips and tutorials: Blog, Twitter, Facebook.
License
Released nether the MIT license.
Source: https://www.npmjs.com/package/cloudinary-jquery-file-upload?activeTab=readme
0 Response to "Jquery File Upload Function With Database Integration"
Post a Comment