Open source docxtemplater image module

This repository holds an updated version of docxtemplater image module.

This package is open source. There is also a paid version maintained by docxtemplater author.

Note this version is compatible with docxtemplater 3.x.

Installation

You first need to install docxtemplater by following its installation guide.

For Node.js install this package:

npm install open-docxtemplater-image-module

For the browser find builds in build/ directory.

Alternatively, you can create your own build from the sources:

npm run compile
npm run browserify
npm run uglify

Usage

Assuming your docx or pptx template contains only the text {%image}:

1//Node.js example
2var ImageModule = require('open-docxtemplater-image-module');
3
4//Below the options that will be passed to ImageModule instance
5var opts = {}
6opts.centered = false; //Set to true to always center images
7opts.fileType = "docx"; //Or pptx
8
9//Pass your image loader
10opts.getImage = function(tagValue, tagName) {
11    //tagValue is 'examples/image.png'
12    //tagName is 'image'
13    return fs.readFileSync(tagValue);
14}
15
16//Pass the function that return image size
17opts.getSize = function(img, tagValue, tagName) {
18    //img is the image returned by opts.getImage()
19    //tagValue is 'examples/image.png'
20    //tagName is 'image'
21    //tip: you can use node module 'image-size' here
22    return [150, 150];
23}
24
25var imageModule = new ImageModule(opts);
26
27var zip = new JSZip(content);
28var doc = new Docxtemplater()
29    .attachModule(imageModule)
30    .loadZip(zip)
31    .setData({image: 'examples/image.png'})
32    .render();
33
34var buffer = doc
35        .getZip()
36        .generate({type:"nodebuffer"});
37
38fs.writeFile("test.docx",buffer);

Some notes regarding templates:

• docx files: the placeholder {%image} must be in a dedicated paragraph.
• pptx files: the placeholder {%image} must be in a dedicated text cell.

Centering images

You can center all images by setting the global switch to true opts.centered = true.

If you would like to choose which images should be centered one by one:

• Set the global switch to false opts.centered = false.
• Use {%image} for images that shouldn't be centered.
• Use {%%image} for images that you would like to see centered.

In pptx generated documents, images are centered vertically and horizontally relative to the parent cell.