Drupal sites with events functionality, often have to allow their users to export events in their personal calendars. On a recent Drupal 8 project we were asked to integrate 3rd party service Add to Calendar to their events and having found no formal integration of the widget with Drupal we developed and contributed this module. The widget provided by Add to calendar supports export of Dates / events to iCalender, Google Calendar, Outlook, Outlook Online and Yahoo Calendar.
Why use Add To Calendar Service?
- Add to Calendar Module provides a widget to export events.
- With Add to Calendar Module, you can create event button on a page and allow guests to add this event to their calendar.
How Does Add to Calendar Module Works?
Add to Calendar Module provides third party field formatter settings for DateTime fields. Module internally uses services provided by http://addtocalendar.com to load free add to calendar button for event page on website and email. Clicking on this button, the event is exported to the corresponding website with proper information in the next tab where a user can add the event to their calendar. Besides, it provides a handful of configuration for a really flexible experience, Allowing you to use your datetime format along with Add to Calendar button.
Using Add to Calendar
Download and enable Add to Calendar module (https://www.drupal.org/project/addtocalendar)
The module has both D8 and a backported D7 versions.
Adding Add to Calendar button to any datetime field would require enabling “Show Add to Calendar” checkbox present at format configurations on Manage Display page of the desired content type.
Following configurations are available:
|Style||Three basic styles are available: Basic, Blue and Glow Orange|
|Display Text||Text for the display button.|
|Event Details||Module provides you three options here. You may opt for static data, tokenized value or any field value, specific to the current entity.|
|Privacy||Use public for free access to event information while private if the event is closed to public access.|
|Security Level||To specify whether button link should use http or https|
|Calendars to show||Select Calendars to be enabled for the display.|
4. Save the settings and visit content display page.
Devs have the option to add "Add to Calendar" button anywhere on the website by following below steps:
1. Include base library ('addtocalendar/base') for add to calendar basic functionality. Optionally, You may also one of the following style libraries for styling the display button:
$variables['#attached']['library'] = 'addtocalendar/base';
2. Place event data on the page as:
<span class="addtocalendar atc-style-blue"> <var class="atc_event"> <var class="atc_date_start">2016-05-04 12:00:00</var> <var class="atc_date_end">2016-05-04 18:00:00</var> <var class="atc_timezone">Europe/London</var> <var class="atc_title">Star Wars Day Party</var> <var class="atc_description">May the force be with you</var> <var class="atc_location">Tatooine</var> <var class="atc_organizer">Luke Skywalker</var> <var class="atc_organizer_email">[email protected]</var> </var> </span>
For further customization of this custom button visit: http://addtocalendar.com/ Event Data Options section.
3. This would create "Add to Calendar" button for your website.