# Configuration of e-mail templates and reminders



# Overview of the template configuration

All templates linked to your journal are stored in the templates configuration:

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/nvZlx42CbyHAjyFQ-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/nvZlx42CbyHAjyFQ-image.png)

</td></tr></tbody></table>

---

Existing templates are sorted:

- First, by recipient. Each family of recipient gets a thumbnail, where all templates are stored for this family:

<table border="1" id="bkmrk--1" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-01/scaled-1680-/66PdYiP9OeTQsUF0-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-01/66PdYiP9OeTQsUF0-image.png)</td></tr></tbody></table>

- Second, by chronological order in the worflow process:
    
    
    - starting with account creation
    - following with peer review and decision events
    - up until production

<table border="1" id="bkmrk--2" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/4cwbfIcGT0SaRRXK-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/4cwbfIcGT0SaRRXK-image.png)

</td></tr></tbody></table>

- Note that [editable and automatic e-mails ](https://doc.nestor-edp.org/books/editorial-office-guide/page/editable-automated-e-mails)are distinguished by the following icons:

<table border="1" id="bkmrk--3" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-01/scaled-1680-/ybo4oWye6rSBjteB-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-01/ybo4oWye6rSBjteB-image.png)</td></tr></tbody></table>

<div data-layout="center" data-node-type="mediaSingle" data-width="" id="bkmrk--21"><div data-alt="" data-collection="contentId-2057797641" data-context-id="2057797641" data-file-mime-type="image/png" data-file-name="Capture.PNG" data-file-size="50341" data-height="261" data-id="5b936473-246e-412a-aa68-c24f017f008c" data-node-type="media" data-type="file" data-width="967" style="display: inline-block; border-radius: 3px; background: #EBECF0; box-shadow: 0 1px 1px rgba(9, 30, 66, 0.2), 0 0 1px 0 rgba(9, 30, 66, 0.24);" title="Attachment">  
</div></div>

# Editable / automated e-mails

E-mails are the primary mean of communication through Nestor:

- Authors and editors may not check the sytem regularly, and overlook their to-do list.
- Referees may not have an active account, and by nature will take action only when prompted by e-mail

Consequently, understanding and properly configuring the mail engine will ensure your users are timely informed of their ongoing workload.

---

##### Actions &amp; types of e-mails

When people work in Nestor, the system will detect important events and generate e-mails according to your configuration.

E-mails can be of two types:

- Editable e-mails
- Automated e-mails

Some events only generate editable e-mails, while others only generate automated e-mails. A few events can generate both types. In those rare cases, Nestor will guide you during the template creation:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/TbLo8QEz8BxQIkCi-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/TbLo8QEz8BxQIkCi-image.png)

---

##### Editable e-mails

Editable e-mails are triggered when a user wants to specifically get in touch with another user. Most common cases are:

- the Editor-in-Chief assigns an associate editor
- the associate editor invites a referee
- the associate editor requests a revision to the authors

Several templates can be linked to the same event. In this case, the user will have to select which template is the most relevant for the situation:

<table border="1" id="bkmrk--0" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/hHuv1EvBpHlW8MrW-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/hHuv1EvBpHlW8MrW-image.png)

</td></tr></tbody></table>

After selecting the relevant template, the user has access to an editing box, where the template can be corrected before sending the mail:

<table border="1" id="bkmrk--3" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/4nbQabIDTuAPQhiV-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/4nbQabIDTuAPQhiV-image.png)

</td></tr></tbody></table>

---

##### Automated e-mails  


Some specific events will trigger automatic e-mails. Most common cases are:

- the author submits his revision &gt; can trigger an automatic mail to the current editor
- the referee declines the invitation to review &gt; can trigger an automatic mail to the current editor
- the article is published online &gt; can trigger an automatic mail to the corresponding author, or a co-author

The following events are used by the system for account management. Please take caution when editing templates linked to these:

<table border="1" id="bkmrk-name-of-the-event-de" style="border-collapse: collapse; width: 100%; height: 178.8px;"><colgroup><col style="width: 30.926%;"></col><col style="width: 69.1976%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Name of the event**  
</td><td style="height: 29.8px;">**Description**  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">USER\_REGISTRATION</td><td style="height: 29.8px;">E-mail sent when an author creates his account  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">USER\_REGISTRATION\_ON\_BEHALF</td><td style="height: 29.8px;">E-mail sent when the editorial office creates an account for someone else  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">USER\_UPDATE\_EMAIL</td><td style="height: 29.8px;">E-mail sent when a user updates his mail address (= login)  
</td></tr><tr style="height: 29.8px;"><td style="height: 29.8px;">USER\_CHANGE\_PASSWORD</td><td style="height: 29.8px;">E-mail sent to a user requesting a password reset  
</td></tr></tbody></table>

<div data-layout="center" data-node-type="mediaSingle" data-width="" id="bkmrk--23"><div data-alt="" data-collection="contentId-2057797641" data-context-id="2057797641" data-file-mime-type="image/png" data-file-name="edit.PNG" data-file-size="49354" data-height="260" data-id="6314c49d-6769-4527-af13-c04d99888d33" data-node-type="media" data-type="file" data-width="964" style="display: inline-block; border-radius: 3px; background: #EBECF0; box-shadow: 0 1px 1px rgba(9, 30, 66, 0.2), 0 0 1px 0 rgba(9, 30, 66, 0.24);" title="Attachment">  
</div></div>

# Creating a new e-mail template

Creating an e-mail template is straightforward, just click here:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/ZrwNOpLIjSNMjqle-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/ZrwNOpLIjSNMjqle-image.png)

You will be prompted with the template creation form, where you first must select an event. It is very important to select the correct event, as the system will use your template only when this event is detected:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-01/scaled-1680-/AJrJ6rSG9dQZfdxv-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-01/AJrJ6rSG9dQZfdxv-image.png)

After selecting the event, Nestor will prefill the form with possible configurations to help you set up the template.

# Drafting templates with variables!

Writing in progress... ↁ\_ↁ

Any enquiries? please contact us: <support@nestor-edp.org>

---

#### Modifying date formats

{{ "now"|date("m/d/Y") }}

---

#### Test variables

{% if article.articleType.code == 'LETTER' %}letter{% else %}paper{% endif %}

{% if articleEntity.finalDecision == 'CLOSED' %}

{% elseif articleEntity.finalDecision == 'WITHDRAWN' %}

##### Coauthor variables

<span data-testid="issue-activity-feed.feed-display-with-intersection-observer"><span class="prismjs css-1ilmmim" data-code-lang="" data-ds--code--code-block="">`{% if recipient.isPending %}`</span></span>

<span data-testid="issue-activity-feed.feed-display-with-intersection-observer"><span class="prismjs css-1ilmmim" data-code-lang="" data-ds--code--code-block="">`{% if recipient.hasValidated %}`</span></span>

<span data-testid="issue-activity-feed.feed-display-with-intersection-observer"><span class="prismjs css-1ilmmim" data-code-lang="" data-ds--code--code-block="">`<span class="">{% if recipient.validOrcid %}</span>`</span></span>

# Drafting templates with conditions!

Nestor uses a [programming language](https://twig.symfony.com/) to generate text in messages. You can harness this and use branching conditions in your templates: [https://twig.symfony.com/doc/2.x/tags/index.html](https://twig.symfony.com/doc/2.x/tags/index.html). The configuration is a bit technical, but will result in:

- modulable texts
- cleaner interfaces
- less technical support

The description below gives one typical example, but the possibilities are endless.

---

#### E-mail conditions: a case study

Let us consider the case of the acceptance letter, where we want to:

- use some general text to inform the author that the article is accepted
- IF certain conditions are met, modify a few parts of the text

For this purpose, we could create two different templates:

<table border="1" id="bkmrk-template-of-acceptan" style="border-collapse: collapse; width: 100%; height: 266.8px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.8px;"><td style="height: 29.8px;">**Template for a "regular article"**  
</td><td style="height: 29.8px;">**Template for a "note to the editor"**  
</td></tr><tr style="height: 237px;"><td style="height: 237px;">Dear author,

Congratulations on being accepted! We have received all source files and your <span style="color: rgb(224, 62, 45);">paper is now in the hands of the copy editor.</span>

You will receive the galley proofs in about <span style="color: rgb(224, 62, 45);">two weeks</span>.

Best regards,

The Editorial Office

</td><td style="height: 237px;">Dear author,

Congratulations on being accepted! We have received all source files and your <span style="color: rgb(224, 62, 45);">note to the editor is about to be published!</span>

You will receive the galley proofs <span style="color: rgb(224, 62, 45);">by tomorrow</span>.

Best regards,

The Editorial Office

</td></tr></tbody></table>

This presents the following downsides:

- now we have two similar templates to maintain
- this clutters the editor interface:

<table border="1" id="bkmrk--0" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/z2BUVu6ctrcjXy6Q-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/z2BUVu6ctrcjXy6Q-image.png)

</td></tr></tbody></table>

---

Instead, let us create one single template, inserting cool conditions when needed:

<table border="1" id="bkmrk-global-template-of-a" style="border-collapse: collapse; width: 100%;"><tbody><tr><td>**Global template**  
</td></tr><tr><td>Dear author,

Congratulations on being accepted! We have received all source files and your <span style="color: rgb(224, 62, 45);">{% if article.articleType.code == 'REGULAR' %}paper is now in the hands of the copy editor{% else %}note to the editor is about to be published!{% endif %}</span>.

You will receive the galley proofs in about <span style="color: rgb(224, 62, 45);">{% if article.articleType.code == 'REGULAR' %}two weeks{% else %}by tomorrow{% endif %}.</span>

Best regards,  
The Editorial Office

</td></tr></tbody></table>

This results in a single template to maintain, and a cleaner editor interface:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/CH6Gc0xjAMsYisV7-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/CH6Gc0xjAMsYisV7-image.png)

# Attaching rules to templates

In Nestor, critical actions will trigger a message and update the article status / dates when necessary. There are also cases when sending an e-mail should trigger an update of the article data, such as the section, or typically, a custom field.

---

#### E-mail rules: a case study

Let us consider this case, where a journal has a special procedure to highlight good papers on the journal website. For this purpose, the editorial office keeps track of the procedure, by using an article [custom field](https://doc.nestor-edp.org/books/editorial-office-guide/page/standard-categorizations):

<table border="1" id="bkmrk--0" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/la9NvRpiAp4ldelG-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/la9NvRpiAp4ldelG-image.png)

</td></tr></tbody></table>

We want the above field to be set automatically to "proposal sent" when sending this message :

<table border="1" id="bkmrk--2" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/aP1iDesE6BW6tLWm-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/aP1iDesE6BW6tLWm-image.png)</td></tr></tbody></table>

Resulting automatically in:

<table border="1" id="bkmrk--4" style="border-collapse: collapse; width: 57.5309%; height: 83px;"><colgroup><col style="width: 100%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/bas8F2C2y0ak6EYs-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/bas8F2C2y0ak6EYs-image.png)</td></tr></tbody></table>

To do so, the Editorial Office can configure an update rule in the template configuration:

<table border="1" id="bkmrk--5" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/73ibMVNlk8cgLtCk-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/73ibMVNlk8cgLtCk-image.png)</td></tr></tbody></table>

<table border="1" id="bkmrk--6" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/aESOien1qD61MFTc-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/aESOien1qD61MFTc-image.png)</td></tr></tbody></table>

After saving the configuration, each time this e-mail is sent, the "Highlight paper" value of the article will be set to "highlight proposed".

# Notification bells

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/G1rqI2gPncqdgISL-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/G1rqI2gPncqdgISL-image.png)

Important e-mails are sometimes lost in the crowd and overlooked by editors. This is especially true for e-mails outside of the workflow, dealing with particular cases etc. Notifications are here to prevent this! Nestor tracks e-mails tagged as "important" and highlights them in the recipient interface.

- In the home page, editors will retrieve important e-mails they have received via the notifications menu:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/63SftkFotQSXk7j6-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/63SftkFotQSXk7j6-image.png)

- In each article, they will retrieve them in the message history:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/nmM1K7wXAVMNtYTj-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/nmM1K7wXAVMNtYTj-image.png)

---

### Setting up notification bells

##### Automatic notification bells

Nestor can tag an e-mail as "important" as soon as the mail is sent. To do so, the template must be configured accordingly:

<table border="1" id="bkmrk--4" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/33Hok5KdYn198Q96-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/33Hok5KdYn198Q96-image.png)</td></tr></tbody></table>

In this example:

- when the editorial office sends this message to an editor
- then, this message will be tagged with a bell in the recipient editor interface (in the message history).

##### Manual notifications

Regardless of the template configuration, notification bells can be set up manually on specific e-mails, when needed.

Note that an editor can see and uncheck important mails **if he/she is the recipient.** He cannot vizualize/uncheck notification bells on other e-mails (to other users). For example below, connected as Phil Palaeon, checking the message history of article jeos20220021. We observe notification bells appear only if I am the recipient:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/xQ8NueaAqOIe4mMi-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/xQ8NueaAqOIe4mMi-image.png)

#####   


### Profile right: access to all notifications

The right below allows the editorial office to have complete control over every user notifications in the journal:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/AT4gs6yyyoDbFoZr-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/AT4gs6yyyoDbFoZr-image.png)

- First, this right unlocks a special view on all active notifications in the journal (regardless of the recipient)

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/4AvTt5h7knpkoAXc-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/4AvTt5h7knpkoAXc-image.png)

- Second in the message history, the Editorial Office can check/uncheck any mail deemed important (even when the EO is not recipient):

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/ur9Cl4OyOtemHXOW-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/ur9Cl4OyOtemHXOW-image.png)

# Configuration of automatic reminders

Automatic reminders are configured here, they are sorted by family of recipients:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/RiOZODFLCQrkz5o3-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/RiOZODFLCQrkz5o3-image.png)

---

##### Author and referee reminders

Author and referee reminders work similarly. Every morning after coffee, Nestor will check all articles submitted in the journal:

- for each article, Nestor evaluates if an action is expected from the author or referees
- if so --&gt; Nestor checks the author/referee due date
- it compares today's date with with the delay configured in the reminder
- if the delay is met, Nestor triggers an automatic e-mail

<table border="1" id="bkmrk-example-1---reminder" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 99.8765%;"></col></colgroup><tbody><tr><td>Example 1 - Reminder for a revision

- In my journal, one article is in revision: the author has a due date to revise (May 17)
- The reminder configuration indicates: remind delayed author 3 days before due date
- Nestor will send an e-mail to this author on May 14 (8am), reminding him to submit his revision

</td></tr><tr><td>Example 2 - Reminder for a referee report

- In my journal, one article is in peer review: the referee has a due date to send his report (June 12)
- The reminder configuration indicates: remind delayed referees 1 day after due date
- Nestor will send an e-mail to this referee on June 13 (8am), reminding him to upload his report

</td></tr></tbody></table>

---

##### Editor reminders

Editor reminders work differently: editors usually work on several manuscripts at the same time, so it is not possible to send them one e-mail for each manuscript. Instead, Nestor will regularly send a summary of the [editor to-do list](https://doc.nestor-edp.org/books/editor-guide/page/current-editor-and-to-do-list), in this format:

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/UdqBtxRMXTmdQNrz-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/UdqBtxRMXTmdQNrz-image.png)

Note that editor reminders are configured by profile: this way you can remind different profiles using different frequencies. Typically EIC do not need to be reminded as often as Associate Editors. In the screenshot below, we can observe that:

- This reminder will send an e-mail only to Editors-in-Chief
- On May 18
- And then, every 7 days (May 25, June 1 etc.)

[![image.png](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/scaled-1680-/SL1Pa0G0co3zH5BQ-image.png)](https://doc.nestor-edp.org/uploads/images/gallery/2023-05/SL1Pa0G0co3zH5BQ-image.png)

NB the template letter selection will propose all templates linked to the event EDITOR AUTOMATIC REMINDER. Make sure these templates include the variable {{ editorReminderList }}

If an editor complains about receiving too many automatic reminders, note that he/she can disable the reminders in his own account (check "[configure e-mail alerts](https://doc.nestor-edp.org/books/editor-guide/page/faq)" in the editor guide).