Configuration
The Qoliber_StorePickup module provides extensive configuration options to customize the pickup experience for your specific business needs. All settings are managed through the Magento Admin panel with intuitive interfaces.
Shipping Method Configuration
Navigate to Stores → Configuration → Sales → Delivery Methods → Store Pickup
Basic Settings
| Setting | Description | Default |
|---|---|---|
| Enabled | Enable/disable the Store Pickup shipping method | No |
| Title | Title displayed in checkout shipping step | Store Pickup |
| Method Name | Name shown for the shipping method | Pick up in store |
| Price | Base price for store pickup (can be 0 for free pickup) | 0.00 |
| Sort Order | Position in the list of shipping methods | 0 |
Pricing & Handling
| Setting | Description | Options |
|---|---|---|
| Calculate Handling Fee | How to apply handling fees | Fixed / Percent |
| Handling Fee | Additional handling charge | 0.00 |
Availability Settings
| Setting | Description | Options |
|---|---|---|
| Enable Store Selection | Allow customers to choose pickup location | Yes / No |
| Pickup Availability Mode | When orders are ready for pickup | Immediate / After Processing / Manual |
| Default Lead Time | Minimum time before pickup (minutes) | 120 |
| Ship to Applicable Countries | Country restrictions | All / Specific |
| Show Method if Not Applicable | Display even when unavailable | Yes / No |
Store Pickup Module Settings
Navigate to Stores → Configuration → Qoliber → Store Pickup Settings
General Settings
| Setting | Description | Required |
|---|---|---|
| Module Enabled | Master enable/disable switch | Yes |
Checkout Display Settings
Display Style
Choose how stores appear in checkout: - Dropdown - Compact dropdown selector (best for many locations) - Tiles - Visual tile layout (best for few locations)
Information Display
Control what store information is visible:
| Setting | Description | Default |
|---|---|---|
| Enable Store Search | Allow searching by address/zip | Yes |
| Show Store Name | Display location name | Yes |
| Show Store Address | Display full address | Yes |
| Show Store Phone | Display contact number | Yes |
| Show Store Email | Display email address | No |
| Show Opening Hours | Display business hours | Yes |
| Show Store Image | Display location photo | No |
| Show Store Description | Display additional details | No |
Date & Time Configuration
Display Control
| Setting | Description | Impact |
|---|---|---|
| Display Date/Time Selection | Show date/time picker in checkout | Yes = visible, No = hidden |
| Enable Date Picker | Allow customer to choose date | Yes = manual selection, No = auto-assign |
| Enable Time Slot Selection | Show time slot options | Yes = specific times, No = date only |
Time Slot Settings
| Setting | Description | Options |
|---|---|---|
| Time Slot Interval | Duration of each slot | 15 / 30 / 60 minutes |
| Slots per Interval | Max orders per time slot | Default: 5 |
| Show Slot Availability | Display remaining capacity | Yes / No |
| Make Time Slot Mandatory | Require time selection | Yes / No |
Email Notifications
Configure automated customer communications:
| Setting | Description | Default |
|---|---|---|
| Enable Email Notifications | Master email switch | Yes |
| Email Sender | Sender identity | General Contact |
| Send Pickup Reminders | Enable reminder emails | Yes |
| Reminder After (Days) | Days before sending reminder | 3 |
Email Templates
- Ready for Pickup Template - Sent when order is marked ready
- Pickup Reminder Template - Sent X days after ready status
Configuration Scenarios
Scenario 1: Simple Free Pickup
Best for single location with immediate availability: - Price: 0.00 - Pickup Availability: Immediate - Store Selection: No - Date/Time Selection: No
Scenario 2: Multi-Store with Scheduling
Best for chains with preparation time: - Enable Store Selection: Yes - Display Style: Tiles - Enable Date/Time Selection: Yes - Time Slot Interval: 30 minutes - Default Lead Time: 240 minutes (4 hours)
Scenario 3: High-Volume with Capacity Management
Best for busy locations with limited capacity: - Enable Time Slot Selection: Yes - Slots per Interval: 3 - Show Slot Availability: Yes - Make Time Slot Mandatory: Yes - Send Pickup Reminders: Yes
Scenario 4: B2B Scheduled Pickups
Best for trade customers with specific windows: - Pickup Availability: Manual - Enable Date Picker: Yes - Time Slot Interval: 60 minutes - Default Lead Time: 1440 minutes (24 hours)
Performance Optimization
For optimal performance: 1. Enable only necessary display fields 2. Use appropriate time slot intervals (larger = better performance) 3. Set reasonable slot capacity limits 4. Configure proper cache settings 5. Use CDN for Google Maps API
Multi-Store Configuration
Store Pickup supports different settings per store view: 1. Configure global defaults at Default Config scope 2. Override specific settings at Website or Store View level 3. Create location-specific email templates per store view 4. Set different prices for different websites
Troubleshooting Configuration
Common configuration issues and solutions:
Store Pickup not appearing in checkout: - Verify module is enabled in both locations - Check country restrictions match customer address - Ensure at least one active location exists
Time slots not showing: - Confirm "Display Date/Time Selection" is Yes - Check "Enable Time Slot Selection" is Yes - Verify store locations have opening hours configured
Email notifications not sending: - Check "Enable Email Notifications" is Yes - Verify email sender configuration - Test email template rendering - Check cron is running for reminders