- Getting Started
- Browser Support
- Languages Support
- Shortcuts
- Activation
- Examples
- Customize the Editor
- Use-cases
- Plugins
- APIs
- Development Frameworks
- Server Integrations
- Server SDKs
- Migration Guides
- Changelog
- Tutorials
- Froala Docs
- /
- SDKs
- /
- Node JS
- /
- Image Server Upload
Node.JS Image Server Upload
How it works
- Specify upload options when initializing the editor.
- On image insertion, the editor automatically makes an AJAX request to the server.
- Once the request reaches the server, it stores the image and sends back to the client the link to the uploaded image.
Initialize the javascript editor
First, add the imageUploadURL
option, as its value enter the upload destination for the images.
Next, set any additional options to configure upload methods and allowed file types: imageUploadParam
, imageUploadParams
, imageUploadMethod
, imageMaxSize
, imageAllowedTypes
.
<script>
new FroalaEditor('.selector', {
// Set the image upload URL.
imageUploadURL: '/upload_image'
})
</script>
Receive the uploaded image and store it
The server implementation is responsible for receiving the request and handling it appropriately. In Node.JS, the uploaded image is available in the request
received by your application. The Node.JS editor SDK detects the uploaded image automatically but you have to specify the path where to store it.
Note: The path of the image is relative to the root of your application.
FroalaEditor.Image.upload(req, '/uploads/', function (err, data) { ... });
To store the uploaded image, the server needs write rights on the uploads folder. Additionally, check uploaded images are publicly accessible in the browser.
Return the path to the uploaded image
If the save action is successful, the SDK generates an ImageResponse
object with the absolute path to the uploaded image and the server returns the path to the client side.
if (err) {
return res.send(JSON.stringify(err));
}
res.send(data);
Complete Example
<script>
new FroalaEditor('.selector', {
// Set the image upload URL.
imageUploadURL: '/upload_image'
})
</script>
var express = require('express');
var app = express();
var bodyParser = require('body-parser')
var path = require('path');
var fs = require('fs');
var FroalaEditor = require('PATH_TO_FROALA_SDK/lib/froalaEditor.js');
app.use(express.static(__dirname + '/'));
app.use('/bower_components', express.static(path.join(__dirname, '../bower_components')));
app.use(bodyParser.urlencoded({ extended: false }));
// Path to upload image.
app.post('/upload_image', function (req, res) {
// Store image.
FroalaEditor.Image.upload(req, '/uploads/', function(err, data) {
// Return data.
if (err) {
return res.send(JSON.stringify(err));
}
res.send(data);
});
});
Do you think we can improve this article? Let us know.