Weekday Recurrences

The Weekday Recurrences function adds weekday options to the Period dropdown on Voxel's recurring-date fields, so owners can enter schedules like "every 3rd Saturday of the month" — something the native day/week/month/year periods cannot express.

Overview

A farmers' market on the 3rd Saturday of each month doesn't fall on the same date twice. With this function enabled, the recurring-date entry in the create/edit post form gains one option per weekday ("Monday of month" through "Sunday of month"), and the existing "Repeats every N" number becomes the ordinal — repeats every 3 + Saturday of month = the 3rd Saturday of every month.

Key Features

• Seven new weekday options in the recurring-date Period dropdown
• Nth-weekday-of-month semantics ("every 3rd Saturday")
• Native recurrences (day/week/month/year) completely untouched
• Months without an Nth occurrence are skipped, not shifted
• Pairs with the Day of Week (VT) and Month (VT) search filters

Setup Instructions

1. Navigate to Voxel Toolkit → Functions
2. Find Weekday Recurrences, toggle it on, and click Save Changes

There is no configuration. Any post type with a recurring-date field picks the options up in its create/edit form immediately.

How Owners Use It

In a recurring-date entry on the front-end form:

1. Pick the start date and times as usual
2. In the Period dropdown, choose a weekday option — e.g. Saturday of month
3. Set Repeats every to the ordinal — 1 for the 1st Saturday, 3 for the 3rd
4. Set the end date of the recurrence

Choosing a weekday snaps the start date to that occurrence within the month, so the entry always reflects a real date.

Example: Every 3rd Saturday, May to August

An event starting in May 2026, set to "Repeats every 3" + "Saturday of month", running until the end of August, produces:

• May 16 (3rd Saturday of May)
• June 20
• July 18
• August 15

Each occurrence keeps the entry's times, including multi-day and overnight spans.

Months without an Nth occurrence are skipped

"Every 5th Friday" only fires in months that actually have five Fridays. A missing occurrence is skipped for that month — never clamped to the 4th or pushed into the next month.

How It Behaves Elsewhere

• Search and calendars — occurrences are stored as concrete dates in Voxel's recurring-dates table, so availability filters, upcoming-date displays, and the Day of Week (VT) and Month (VT) filters all see the real dates with nothing extra to configure
• Native recurrences untouched — entries using the standard day/week/month/year periods are stored and behave exactly as Voxel stores them, bit for bit. The weekday behaviour only applies to entries where a weekday period was chosen
• If another plugin already overrides Voxel's recurring-date field type, this function backs off rather than fighting it

Troubleshooting

The Weekday Options Don't Appear

• Confirm the function is enabled
• The options appear in the front-end create/edit post form's recurring-date entries — not in the wp-admin post editor

Occurrences Stop Too Early

• Check the recurrence's end date — occurrences are only generated up to it (and very long recurrences are capped at 20 years out)

Requirements

• Voxel Theme with a recurring-date field on the post type
• Voxel Toolkit plugin with Weekday Recurrences enabled