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.
!Generate dynamic contents for EMAILS or HTML pages

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.

$3

#### 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:
``json [ { "email": "miquel@n8nhackers.com", "name": "Miquel", "primary": true }, { "email": "contact@n8nhackers.com", "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:`


  {{#each items}}
  {{name}}: {{email}} {{#if (eq primary true)}}(primary){{/if}}

  {{/each}}

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


Miquel: miquel@n8nhackers.com (primary)

Contact: contact@n8nhackers.com


Property items is always mandatory to iterate over all items.
$3
#### 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:`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

!Banner image