---
description: This add-on allows you to insert events into your emails.
---

# DPCalendar

### Insert events in an email

{% tabs %}
{% tab title="One by one" %}
![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-M3QEbjlUgQw67lEMqXs%2F-M3QHzmTE6CgyOUFTt-e%2Fonebyone.png?alt=media\&token=926a84a1-be25-409f-b80e-7e71903f3129)

* **Content to insert**: The listed events are ordered by starting date, for events with multiple occurrences you can hover the displayed date to see the full version with the starting hour.

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-M3QEbjlUgQw67lEMqXs%2F-M3QI1QmCeA2w04AanSw%2Foptions1.png?alt=media\&token=087b7f57-f216-4246-9562-b46d3537224c)

* **Display**: Choose here the content you want to be inserted in your email
* **Custom fields**: The custom fields are displayed between the inserted event and its "read more" link

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-M3QEbjlUgQw67lEMqXs%2F-M3QI4DRP5u6FeN0MoMv%2Foptions2.png?alt=media\&token=48cd24ae-58ab-4e43-887f-1de0187fd0d9)

* **Display pictures**: You can resize or remove pictures included in the description part of the event you insert in your email. If you select "No", it will remove the images from the custom fields / description, but not the main image if you selected it in the "Display" part
* **Clickable title**: A link will be added on the event's title, leading to this event's detail page on your site
* **Truncate the text**: This will cut the description part of the event you insert
* **Read more**: If turned On, a "Read more" link will be added just below the inserted event

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MQS6URmMI_hDwYXHgUA%2F-MQS9abnHPWHU5YSqjaI%2FCapture_d_e%CC%81cran_07_01_2021_14_57.png?alt=media\&token=16dcf99f-644d-405d-ad34-b92c51210b14)

* **Custom view**: You can edit the view of the articles that you insert&#x20;
{% endtab %}

{% tab title="By category" %}
If you select "By category", you will be able to insert multiple events at a time.

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-M3QEbjlUgQw67lEMqXs%2F-M3QI7nTzAF81YFebD61%2Fbycat.png?alt=media\&token=3b73aaa9-f6ba-4776-97a6-b69b6ce99939)

* **Content to insert**: You can insert events of one or more categories, or all events if you don't select anything
* **Display, Custom fields and Display pictures**: see "One by one" options

![](https://963725040-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-M3QEbjlUgQw67lEMqXs%2F-M3QIAGSeP3YJm1l11v5%2Fcatoptions.png?alt=media\&token=5d88f4d9-2885-4946-84e3-67f4bf2988d7)

* **First options**: see "One by one" options
* **Only featured elements**: You can choose to only insert featured events with this option
* **Columns**: You can insert for example 2 events per row in your email&#x20;
* **Column horizontal padding**: Allows you to adjust the horizontal padding between 2 columns
* **Column vertical padding**: Allows you to adjust the vertical padding between 2 columns
* **Max.number of elements**: This is the maximum number of events inserted in your email
* **From**: Only insert events starting after the specified date. You can specify a relative date if you're currently creating a campaign sent automatically in its "Send settings" tab.
* **To**: Only insert events starting before the specified date.
* **Order by**: By default, events are sorted by starting date to show the ones about to begin first
* **Automatic campaigns options**: See [the dedicated documentation](../../../main-pages/campaigns/automatic-campaigns#dont-send-twice-the-same-content)
{% endtab %}
{% endtabs %}

### Settings

Here are the settings available for this add-on:\
**Custom view**: override the content inserted in your email\
**Front-end access**: this settings allows you let your users access to this add-on in the frontend campaign management or not\
**Hide past events**: This option allows you to hide or not past event in the listing in the drag & drop editor
