This module doesn't expose tags, but it makes it possible to do some operations on the docx itself.

The META module currently can :

• Make a document readonly
• Add a text watermark
• Update the margins
• Change the hyperlink base for the whole document
• Restrict edition of document using a password

Usage

To use this module, do your operations before the call to the render method.

Readonly

const DocxtemplaterMetaModule = require("docxtemplater-meta-module");
const metaModule = new DocxtemplaterMetaModule();
const doc = new Docxtemplater(zip, {
    modules: [metaModule],
});
metaModule.readonly();
doc.render(data);
const buffer = doc.getZip().generate({ type: "nodebuffer" });

Watermark

const DocxtemplaterMetaModule = require("docxtemplater-meta-module");
const metaModule = new DocxtemplaterMetaModule();
const doc = new Docxtemplater(zip, {
    modules: [metaModule],
});
metaModule.addTextWatermark("DRAFT", {
    diagonal: true,
});
doc.render(data);
const buffer = doc.getZip().generate({ type: "nodebuffer" });

Restrict Edition using a password

Word has a "restrict edition" mode that one can setup so that the document will be readonly unless you have a specific password.

The meta module can protect a document in this way.

Note that the content of the document will not be encrypted, the Microsoft Office software will simply respect the restriction and a malicious user could quite easily remove that protection.

Usage is like this :

const DocxtemplaterMetaModule = require("docxtemplater-meta-module");
const metaModule = new DocxtemplaterMetaModule();
const doc = new Docxtemplater(zip, {
    modules: [metaModule],
});
metaModule.restrictEdition({
    password,
    protect = "readOnly",
    algorithm = "sha512", // You most likely should not change this, this is the most secure algorithm that word does support
    spinCount = 100000, // You most likely should not change this, a high spinCount will make the password much more difficult to guess
    // salt: "...." base64 string (very optional, it will be randomly generated when not provided)
});

doc.render(data);
const buffer = doc.getZip().generate({ type: "nodebuffer" });

The password length must be of at least 6 characters.

Note that spinCount and algorithm options already have default values which are secure enough for most use cases.

The protect option can take one of the following values :

• "readOnly" => The document cannot be edited at all
• "trackedChanges" => The document can be edited, all changes are tracked
• "forms" => Only forms can be edited
• "comments" => Only comments can be added/changed

There also is a salt parameter which is a base64string of 24 characters, but this value is generated by the library so you don't have to, in most cases.

Margins

const DocxtemplaterMetaModule = require("docxtemplater-meta-module");
const metaModule = new DocxtemplaterMetaModule();
const doc = new Docxtemplater(zip, {
    modules: [metaModule],
});
// Margins are in inches, and apply to all pages
metaModule.setMargins({
    top: 0.5,
    left: 0.8,
    right: 1.2,
    bottom: 1,
});
doc.render(data);
const buffer = doc.getZip().generate({ type: "nodebuffer" });

Hyperlink Base

const DocxtemplaterMetaModule = require("docxtemplater-meta-module");
const metaModule = new DocxtemplaterMetaModule();
const doc = new Docxtemplater(zip, {
    modules: [metaModule],
});
const baseLink = "https://github.com/facebook/react";
metaModule.setHyperlinkBase(baseLink);
doc.render(data);
const buffer = doc.getZip().generate({ type: "nodebuffer" });

After installing the module, you can use a working demo by running node sample.js.