The Calendar Week Start function makes Voxel date pickers respect your WordPress “Week Starts On” setting. Fix calendars that start on the wrong day by syncing them with your site’s configuration.
Overview
By default, Voxel’s date picker (Pikaday) starts weeks on Monday regardless of your WordPress settings. This function overrides that behavior to match your WordPress “Week Starts On” setting under Settings > General.
Key Features
Respects WordPress “Week Starts On” setting
Works with all Voxel date pickers
Supports Sunday, Monday, or any day start
No configuration required
Automatic sync with WordPress setting
Setup Instructions
Step 1: Configure WordPress Setting
Go to Settings > General in WordPress admin
Find “Week Starts On” dropdown
Select your preferred first day of the week
Click Save Changes
Step 2: Enable the Function
Navigate to Voxel Toolkit > Functions
Find Calendar Week Start in the list
Toggle the switch to enable the function
Click Save Changes
All Voxel date pickers will now start on your configured day.
WordPress Week Start Options
Day
Value
Common Regions
Sunday
0
USA, Canada, Japan
Monday
1
Europe, UK, Australia
Tuesday
2
–
Wednesday
3
–
Thursday
4
–
Friday
5
–
Saturday
6
Some Middle Eastern countries
How It Works
Function reads WordPress start_of_week option
JavaScript wrapper is added after Pikaday loads
Wrapper intercepts Pikaday constructor calls
Override firstDay option with WordPress value
Calendar displays with correct week start
This technique preserves all other Pikaday functionality while only changing the week start day.
Affected Elements
This function affects all Voxel components that use Pikaday date pickers:
Date picker search filters
Date range selectors
Booking calendars
Date fields in forms
Event date selectors
Use Cases
US-Based Sites
Set week to start on Sunday to match American calendar conventions.
European Sites
Keep default Monday start which matches European ISO week standard.
Multilingual Sites
Configure based on your primary audience’s expectations.
Troubleshooting
Calendar Still Starting on Monday
Verify the function is enabled
Check WordPress Settings > General > “Week Starts On”
