Menu

#11776 Article plugin

Parent Category:
DPCalendar
Category:
Calendar plugins
Last Updated:
Allon Moritz, Monday, 24 August 2026 14:11 (2 weeks ago.)
Created:
Wednesday, 22 October 2025 08:10
Hits:
2151

This feature is part of the DPCalendar Standard subscription.
SubscribePHP 8Joomla 4.4Joomla 5Joomla 6

Introduction

The DPCalendar - Articles plugin allows to seamlessly integrate Joomla articles with DPCalendar. It supports two-way synchronization:

  • Display Joomla articles as events in DPCalendar.
  • Automatically create and update Joomla articles from DPCalendar events.

This makes it ideal for websites where content needs to appear both as calendar events and as regular articles, such as news posts, event announcements, blog entries, or course descriptions.

Display articles as events

Once configured, DPCalendar can display Joomla articles as events throughout the extension, including:

  • Calendar views
  • Event list views
  • Calendar modules
  • Upcoming event modules
  • Any other view that displays DPCalendar events

Articles can be selected based on their categories or tags, allowing the site admin to decide exactly which articles should appear as events. Since Joomla articles do not natively contain event information such as start dates or locations, the plugin uses Joomla Custom Fields to store this information. These fields are mapped in the plugin configuration, allowing DPCalendar to interpret articles as calendar events.

Configure custom fields

To display articles as events, DPCalendar requires several event-related fields, such as:

  • Start date
  • End date
  • All-day flag
  • Location
  • Calendar
  • Additional event metadata

These values are stored in article Joomla Custom Fields. The plugin configuration allows to map each DPCalendar attribute to the corresponding custom field.

Article plugin configuration

Create articles from events

The plugin can also work in the opposite direction by automatically creating Joomla articles from native DPCalendar events. In the Sync tab, it is possible to define which DPCalendar calendars should synchronize with which Joomla article categories. Whenever an event is created or updated in one of the configured calendars, the plugin will automatically create or update the corresponding Joomla article.

This is particularly useful for:

  • Publishing event announcements as blog posts
  • Creating searchable event archives
  • Improving SEO by giving events dedicated article pages
  • Sharing event information outside the calendar

In addition to the article title and content, it is possible to map DPCalendar event custom fields to Joomla Custom Fields, allowing event metadata to be transferred automatically.

The intro and full text options do allow to define custom article texts with more properties from events. Like that it is possible to display the date and location within the article description or intro text. If no intro text is set in the event, then the intro text in the article is also empty, except when more fields are specified in the intro text option which render a value beside the event intro text.

Article plugin sync configuration

DPCalendar Options

These settings are the same for every calendar configured in the plugin.

Start Date Field [Type: Dpcfields]
The article custom field to use as start date.
End Date Field [Type: Dpcfields]
The article custom field to use as end date.
Recurrence Rule Field [Type: Dpcfields]
The article custom field to use as recurrence rule.
Location Field [Type: Dpcfields]
The article custom field to use as location.
Colour Field [Type: Dpcfields]
The article custom field to use as event colour.
Category Filter [Type: Dpcalendar] [Default: root]
Select the category to filter the articles.
Tags Filter [Type: Tag]
Select the tags to filter the articles.

Plugin Options

Sync Calendars [Type: Subform]
Sync native DPCalendar events to articles.
Sync Fields [Type: Subform]
The custom fields mapping between events and articles.
Article Intro Text Format [Type: Textarea] [Default: {{#events}}{{{introText}}}{{/events}}]
The format of the article intro text.
Article Full Text Format [Type: Textarea] [Default: {{#events}}<p>{{date}}</p>{{#location}}<p>{{full}}</p>{{/location}}{{{description}}}{{/events}}]
The format of the full article text.

Plugin Options

Caching [Type: List] [Default: Joomla]
Select whether to cache the calendar data.
The following options are available:
  1. Joomla
  2. Database
  3. Never
Cache Time [Type: Text] [Default: 900]
The time for the cache in sec.
Sync Start [Type: Text] [Default: -3 year]
The relative start date to sync from.
Sync End [Type: Text] [Default: +3 year]
The relative end date to sync from.
Sync Steps [Type: Text] [Default: 1 year]
The sync steps.

Comments (0)