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)
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
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.