qoliber Store Pickup - Installation

System Requirements

• Magento Open Source or Adobe Commerce 2.4.6 or higher
• PHP 8.1 or newer
• Composer based environment
• MySQL 8.0+ or MariaDB 10.6+

Installation

Store Pickup extension can be installed through your qoliber packagist.com license key.

1. Install via Composer

composer require qoliber/store-pickup

2. Enable the Module

php bin/magento module:enable Qoliber_StorePickup

3. Run Setup Commands

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

4. Clear Cache

php bin/magento cache:clean
php bin/magento cache:flush

Hyvä Checkout Compatibility

If you're using Hyvä Checkout, install the compatibility module:

composer require qoliber/store-pickup-hyva-checkout
php bin/magento module:enable Qoliber_StorePickupHyvaCheckout
php bin/magento setup:upgrade

Post-Installation Steps

1. Configure Shipping Method

Navigate to Stores → Configuration → Sales → Delivery Methods → Store Pickup and enable the shipping method.

2. Create Store Locations

Go to Sales → Store Pickup → Locations to add your pickup locations.

3. Set Up Email Templates (Optional)

Configure email notifications in Stores → Configuration → Qoliber → Store Pickup Settings → Email Notifications.

4. Google Maps Integration (Optional)

Add your Google Maps API key in Stores → Configuration → Qoliber → Store Pickup Settings → General Settings for map functionality.

Verification

To verify successful installation:

1. Check if the module is enabled:

   Shell

   php bin/magento module:status Qoliber_StorePickup

2. Verify database tables were created:

   • qoliber_store_pickup_location
   • qoliber_store_pickup_quote
   • qoliber_store_pickup_order
   • qoliber_store_pickup_slot_capacity

3. Confirm admin menu items appear under Sales → Store Pickup

4. Test checkout to ensure Store Pickup appears as a shipping method

Compatibility Notes

• ElasticSuite: Fully compatible, no additional configuration required
• MSI (Multi-Source Inventory): Ready for integration (coming in v1.2)
• Hyvä Theme: Full compatibility with dedicated integration module
• PWA Studio: API endpoints available for headless implementations
• Page Builder: Compatible with all page builder solutions

Troubleshooting

If Store Pickup doesn't appear in checkout:

• Ensure the module is enabled in configuration
• Check that at least one store location is created and active
• Verify the shipping method is enabled for the current store view
• Clear all caches and reindex if necessary

For support, contact [email protected]