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.
- 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.
After adding a new Event , click on the "Recurrence" tab and choose a "Frequency" (other than Never)
Daily recurring Events allow you to set the Interval and Ending.
Weekly recurring Events allow you to set the Interval, Day-of-Week, and Ending
Monthly recurring Events allow you to set the Interval, Day-of-Month or Ordinals, and Ending
Yearly recurring Events allow you to set the Interval, Month and Ordinals, and Ending.
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.
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.
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.
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
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.
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.
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.
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.