Advanced Recurring Usage

The Advanced Recurring add-on takes recurring Events to the next level, allowing them to recur in more custom combinations than our bundled Standard Recurring feature.

Requirements

  • WordPress 5.7 or higher
  • PHP 7.2.0 or higher
  • Sugar Calendar 2.2.1 or higher
  • A Professional or Ultimate license to Sugar Calendar

After you have installed and activated the Advanced Recurring Add-On you are ready to set up your first advanced recurring Event!

Navigate to Calendar → Add New to create a new Event.

Frequencies

After adding a new Event , click on the "Recurrence" tab and choose a "Frequency" (other than Never)

Choose a Frequency

Daily

Daily recurring Events allow you to set the Interval and Ending.

Weekly

Weekly recurring Events allow you to set the Interval, Day-of-Week, and Ending

Monthly

Monthly recurring Events allow you to set the Interval, Day-of-Month or Ordinals, and Ending

Yearly

Yearly recurring Events allow you to set the Interval, Month and Ordinals, and Ending.

Intervals

Pictured above with the "Every" label, the Interval determines how many of the frequency will pass until the Event occurs again. Intervals are supported by all Frequencies.

Ordinals

Pictured above with the "first" and "Sunday" placeholders, Ordinals determine how many, what day-of-week, or what type-of-day an Event will occur on. Ordinals are only supported by Monthly and Yearly frequencies, and work differently for each.

The most popular combinations are provided: day-of-week, day, weekday, and weekend.

Endings

Pictured above with the "Ending" label, a recurring Event could never end, end on a specific future date, or end after a specific number of occurrences.

There is no performance difference between an Event with an ending or one that goes on forever, so there is no need to end your Events arbitrarily.

Support

The following features are currently supported:

  • Admin area Calendar views
  • Theme-side Calendar views

The following features are currently in development:

  • Theme-side Event lists, widgets, and shortcodes
  • Theme-side Event archives and single Event pages

Exclusions

Coming in summer of 2021, you will be able to exclude specific occurrences. This functionality is complete, but the UI was not ready for our initial release.

Sequence Breaks

Coming in summer of 2021, you will be able to break a single Event sequence in half, or make a new Event out of a specific Event occurrence. This functionality is complete, but the UI was not ready for our initial release.

Add-on Support

Coming in summer of 2021, Calendar Feeds and Event Ticketing will have support for Advanced Recurring and/or individual Event Sequences. These functionalities are not yet complete.

Caveats

Because Dates and Times can act differently with each other, it is possible to create recurring Event sequences that are seemingly impossible but are actually completely valid. For example, an Event that starts on Thursday, June 17, 2021 at 20:00, ends the following Friday at 02:00, that recurs every 5 Saturday's. This combination of properties makes no sense, but is not invalid. So, take care when creating your Events and contact us if you think we can improve the way anything works.