# 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 
  {% 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 
* **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](https://docs.acymailing.com/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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acymailing.com/addons/joomla-add-ons/dpcalendar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.