Skip to content

qoliber Store Pickup - Installation

Installation of the extension should be performed by a professional developer / Agency.

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:

    php bin/magento module:status Qoliber_StorePickup
    

  2. Verify database tables were created:

  3. qoliber_store_pickup_location
  4. qoliber_store_pickup_quote
  5. qoliber_store_pickup_order
  6. qoliber_store_pickup_slot_capacity

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

  8. 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]