n8n-nodes-document-generator

n8n-nodes-document-generator

This is an n8n community node. It helps you to create:

• One dynamic content per all input items.
• One dynamic content per input item.

If you have any questions or remarks please contact me.

n8n is a fair-code licensed workflow automation platform.

TL;DR

Don't want to read? Import the sample workflow Generate dynamic contents for EMAILS or HTML pages to test this node with random samples.

Installation

Follow the installation guide in the n8n community nodes documentation.

Compatibility

This node was developed and tested with version 0.193.5 of n8n.

Dependencies

If you install this node, n8n will install automatically the next extra npm packages:

• @jaredwray/fumanchu: this new Handlebars replacement provides Handlebars + Helpers Together.

Usage

The node can solve multiple use cases when creating content like:

• Email generation (HTML or TEXT)
• Static HTML pages
• WordPress posts
• Telegram/Slack messages
• Use helpers to filter templates

The sky is your limit!

Just follow the next samples to create your dynamic content and forget to use SET, FUNCTION, or FUNCTION ITEM nodes.

All input items in one template

Cases

• You want to send a list of recent news about n8n.
• You want to send the list of the customers created in the last hour in your database.

Template

Supposing that you have a customer list in JSON:

[
	{
		"email": "[e-mail]",
		"name": "Miquel",
		"primary": true
	},
	{
		"email": "[e-mail]",
		"name": "Contact",
		"primary": false
	}
]

We will try a Handlebars helper #if to show if the contact is the primary email or not.

If you use the next template:

<ul id="customer_list">
  {{#each items}}
  <li>{{name}}: {{email}} {{#if (eq primary true)}}(primary){{/if}}</li>
  {{/each}}
</ul>

And you will get the next output to send by email in HTML format:

<ul id="customer_list">
<li>Miquel: [e-mail] (primary)</li>
<li>Contact: [e-mail]</li>
</ul>

Property items is always mandatory to iterate over all items.

One input item per template

Cases

• You have an invoice with header and lines and you want to send it by email.

Template

If you have one item/invoice with this JSON:

{
	"date": "2022-01-12",
	"to": "N8n hackers",
	"address": "Granollers, Spain",
	"total": 133.10,
	"lines": [
		{
			"description": "Create a node to render items in handlebar templates",
			"quantity": 1,
			"amount": 100,
			"vat": 21,
			"total": 121
		},
		{
			"description": "Test a node to render items in handlebar templates",
			"quantity": 1,
			"amount": 10,
			"vat": 2.10,
			"total": 12.1
		}
	]
}

You need to use this template:

Date: {{date}}
To: {{to}}
Address: {{address}}
Details:
{{#each lines}}
- "{{description}}" x {{quantity}} = {{amount}}€ + {{vat}}€ = {{total}}€
{{/each}}
Total invoice: {{total}}€

And you will get the next output to send by email in TEXT format:

Date: 2022-01-12
To: N8n hackers
Address: Granollers, Spain
Details:
- "Create a node to render items in handlebar templates" x 1 = 100€ + 21€ = 121€
- "Test a node to render items in handlebar templates" x 1 = 10€ + 2.10€ = 12.10€
Total invoice: 133.10€

I recommend using this method if you want to send multiple invoices.

Helpers

Now the node supports helpers thanks to the @jaredwray/fumanchu package.

We recommend checking

Doubts about templates syntax

Please, check the official page to review all the existing expressions in Handlebars.

Another way to try it out

N8N documentation on custom nodes

Clone the n8n-nodes-document-generator repository and execute:

# Use v20.12.2 = lts/iron
nvm use lts/iron

# Install dependencies
npm install

# Build the code
npm run build

# "Publish" the package locally
npm link

Create an N8N installation and add the n8n-nodes-document-generator to it:

# Ensure that custom nodes directory exists in your .n8n
mkdir ~/.n8n/custom

# Init npm packages (intro to all questions)
cd ~/.n8n/custom && npm init

# "Install" the locally published module
npm link n8n-nodes-document-generator

# Start n8n
n8n start

Contribution

To make this node even better, please let us know, how you use it. Commits are always welcome.

Issues

If you have any issues, please let us know on GitHub.

About

Nodes by n8nhackers.com. For productive use and consulting on this, contact us please.

Special thanks to N8n nodemation workflow automation by Jan Oberhauser.

License

MIT