Blogs

EMAIL: info@example.com

mark.ie: Creating an ‘Add to Calendar’ Widget in Drupal

Creating an ‘Add to Calendar’ Widget in Drupal

A simple request: we need an ‘Add to Calendar’ widget to add our events to Google Calendar, iCal, and Outlook. Simple (once I had completed it!).

markconroy
Tue, 01/08/2019 – 21:11

There’s a module for that. There is, it’s called, obviously, addtocalendar. It works very well, if you:

  • want to use the addtocalendar.com service,
  • want to pay for this service

If you don’t want to use an external service for something as simple as adding an event to a calendar, then it looks like you’ll need a custom solution. Their smallest plan only allows 2 events per month.

The PatternLab Part

Here’s the custom solution I came up with (in the future, I’ll look at creating a module for this with a settings/UI page for site builders). Note, it’s a PatternLab implementation; if you don’t use PatternLab and just want to work directly in your Drupal theme, it would be even easier.

Here’s the code for the ‘Add to Calendar’ pattern in PatternLab (some classes and things are removed to make it easier to read):

  1. {%
  2. set classes = [
  3. "add-to-calendar"
  4. ]
  5. %}
  6.  
  7. {% set ical_link = 'data:text/calendar;charset=utf8,BEGIN:VCALENDAR%0AVERSION:2.0%0ABEGIN:VEVENT%0ADTSTART:' ~ atc_start_date|date("Ymd\THi00\Z") ~ '%0ADTEND:' ~ atc_end_date|date("Ymd\THi00\Z") ~ '%0ASUMMARY:' ~ atc_title ~ '%0ADESCRIPTION:' ~ atc_details|striptags ~ '%0ALOCATION:' ~ atc_location|replace({'
    '
    : ' ', '
    '
    : ' ', '

    '

    : ' ', '': ''}) ~ '%0AEND:VEVENT%0AEND:VCALENDAR' %}
  8.  
  9. {% set google_link = 'https://www.google.com/calendar/r/eventedit?text=' ~ atc_title ~ '&dates=' ~ atc_start_date|date("Ymd\THi00\Z") ~ '/' ~ atc_end_date|date("Ymd\THi00\Z") ~ '&details=' ~ atc_details|striptags ~ '&location=' ~ atc_location|replace({'
    '
    : ' ', '
    '
    : ' ', '

    '

    : ' ', '': ''}) %}
  10.  
  11. {{ attributes.addClass(classes) }}>
  12.  
  13.  
  14.  
  15.  

What does the above code do?

  • Creates a Google Calendar variable and creates an iCal variable. Outlook will also use iCal.
  • Uses these variables as links to add the event to their respective calendars.

Within the variables, we have some more variables (start date, end date, etc), which we should probably wrap in conditional statements so that their clauses don’t print unless they are present in Drupal (some fields might be optional on your event content type, such as end time).

These variables are:

  • atc_start_date: Start Date and time
  • atc_end_date: End Date and time
  • atc_title: the name of the event
  • atc_details: description for the event
  • atc_location: place of event

In our Event pattern in PatternLab, we then have a variable called ‘add_to_calendar’ so that events have the option to have this widget or not. In event.twig, we simply print:

  1. {% if add_to_calendar %}
  2. {% include '@site-components/add-to-calendar/add-to-calendar.twig' %}
  3. {% endif %}

The Drupal Part

In Drupal we create a boolean field on our event content type field_event_add_to_calendar, if this is ticked, we will display the Add to Calendar widget.

Here’s the code from node–event–full.html.twig

  1. {# Set the Add to Calendar Variables #}
  2.  
  3. {% if node.field_add_to_calendar.value %}
  4. {% set add_to_calendar = true %}
  5. {% endif %}
  6.  
  7. {% if node.field_event_date.value %}
  8. {% set atc_start_date = node.field_event_date.value %}
  9. {% endif %}
  10.  
  11. {% if node.field_event_date.end_value %}
  12. {% set atc_end_date = node.field_event_date.end_value %}
  13. {% endif %}
  14.  
  15. {% if node.title.value %}
  16. {% set atc_title = node.title.value %}
  17. {% endif %}
  18.  
  19. {% if node.field_event_intro.value %}
  20. {% set atc_details = node.field_event_intro.value %}
  21. {% endif %}
  22.  
  23. {% if node.field_event_location.value %}
  24. {% set atc_location = node.field_event_location.value %}
  25. {% endif %}
  26.  
  27. ...
  28.  
  29. {% include "@content/event/event.twig" %}

To explain:

If the ‘Add to Calendar’ boolean is on, we set the add to calendar variable as true

This in turn tells patternlab to render the Add to Calendar component.

We then check if each field we might use has a value in it – such as a start date and end date

If so, we map the values from each of those fields to variables in our Add to Calendar component (such as atc_start, atc_title, etc)

Now, when you view a node, you will see your Add to Calendar widget on any nodes that the editors choose to put it. You can see a sample of the Add to Calendar widget in my PatternLab.

Simple, once I figured it out.

Got an improvement for this? The comments are open.