Calendar Week Start

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

1. Go to Settings → General in WordPress admin
2. Find “Week Starts On” dropdown
3. Select your preferred first day of the week
4. Click Save Changes

Step 2: Enable the Function

1. Navigate to Voxel Toolkit → Functions
2. Find Calendar Week Start in the list
3. Toggle the switch to enable the function
4. 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

1. Function reads WordPress start_of_week option
2. JavaScript wrapper is added after Pikaday loads
3. Wrapper intercepts Pikaday constructor calls
4. Override firstDay option with WordPress value
5. 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”
• Clear browser cache (JavaScript may be cached)
• Clear any site caching

Date Picker Not Working

• Check browser console for JavaScript errors
• Verify Pikaday script is loading
• Disable other date-related plugins temporarily