📅 DeliverDate Pro Installation Guide

🎯 What You Need

• BigCommerce store admin access with app installation permissions
• Stencil or Catalyst theme (both fully supported!)
• Products with date modifiers configured as "Date" type in BigCommerce
• Multi-Storefront ready - automatically injects across all your storefronts

Install the App from BigCommerce Marketplace

1. Log in to your BigCommerce admin dashboard
2. Navigate to Apps & Features → Apps → My Apps
3. Search for "DeliverDate Pro"
4. Click the app card to view details
5. Click "Install" button
6. Review the permissions requested and click "Install" to confirm

Authorize the App

1. In BigCommerce admin, go to Apps & Features → My Apps
2. Find "DeliverDate Pro" in your installed apps list
3. Click "Launch" to open the app admin panel
4. You'll be redirected to the BigCommerce OAuth authorization screen
5. Review the requested scopes and click "Install"
6. The app admin panel will load automatically

Initial Configuration

The app admin panel opens with sensible defaults. You can customize:

Basic Settings

• Store Timezone: Select your store's timezone for accurate date handling
• Minimum Delivery Days: Days before a customer can select a delivery date (default: 0)
• Maximum Delivery Days: Latest delivery date allowed (default: 365 days)

Business Hours

• Select which days you're open for orders
• Sunday's label defaults to "Pickup Only" but can be customized
• Choose which days customers can select for delivery

Holidays & Blackout Dates

• Holidays: Add annual dates (e.g., Christmas, Thanksgiving)
• Blackout Dates: Add specific dates your store is closed
• Add custom tooltip text for holidays

Recurring Closures

• Disable specific days of the week (e.g., Sundays and Mondays)
• Customers won't be able to select these days

Custom Button Text

• Button Text: Customize the date picker button label
• Use {date} placeholder to show the selected date (e.g., "Deliver by {date}")
• If no placeholder, text appears before the date

✅ Verify Installation

1. Go to your BigCommerce storefront
2. Navigate to any product with a date modifier
3. You should see a calendar icon 📅 and date picker button
4. Click the button to open the Flatpickr calendar interface
5. Verify that:
   • ✓ Disabled dates (weekends, holidays, blackouts) appear grayed out with tooltips
   • ✓ You can only select valid dates (rules enforced)
   • ✓ The selected date appears on the button with day-of-week labels
   • ✓ Works on both desktop and mobile devices
   • ✓ Catalyst storefronts show proper single-input date display

Common Issues & Solutions

📱 Date picker not appearing on product page

• Solution 1: Hard refresh your browser (Ctrl+Shift+R on Windows, Cmd+Shift+R on Mac)
• Solution 2: Clear your browser cookies and cache, then refresh
• Solution 3: Verify the product has a date modifier configured in BigCommerce
• Solution 4: Check that you've saved your config in the admin panel

🗓️ Disabled dates not showing correctly

• Check timezone: Ensure your store timezone is set correctly in the admin panel
• Check holiday dates: Verify holidays are entered in YYYY-MM-DD format
• Clear cache: Hard refresh your browser to see updated rules

❓ Can't access the admin panel

• Check permissions: Ensure your BigCommerce user has app installation permissions
• Try again: Go to Apps & Features → My Apps → DeliverDate Pro → Launch
• Contact support: If you continue to see errors, reach out to us

📧 Getting an authorization error

• The app store token may have expired
• Solution: Uninstall and reinstall the app, then reauthorize

🆘 Still having issues?

Contact our support team at support@shareflowx.com with:

• Your store URL
• Screenshots of the issue
• Steps you've already tried