====== Magento 2 Store Pickup Extension ======

===== Extension context =====

This is a Toweringmedia Magento 2 extension guide in the **Store Operations** category. Use this page for pickup scheduling and order flow validation.

  * **Module name**: `Toweringmedia_StorePickup`
  * **Composer package**: `toweringmedia/module-store-pickup`

===== Quick links =====

  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:extensions:toweringmedia-module-store-locator|Magento 2 Store Locator Extension]]
  * [[magento2:extensions:toweringmedia-module-distance-delivery|Magento 2 Distance Delivery Extension]]

===== Overview =====

Store Pickup extends Store Locator with pickup-specific checkout and operations behavior, including pickup slot selection and pickup order tracking.

Core capabilities:
  * Store pickup as a checkout fulfillment option.
  * Pickup slot validation based on location schedules.
  * Pickup order management workflows in admin.

===== Installation =====

<code bash>
cd /path/to/magento
composer require toweringmedia/module-store-pickup:<VERSION>
php -d memory_limit=-1 bin/magento setup:upgrade
php -d memory_limit=-1 bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
</code>

===== Versioning notes =====

  * Pick the version you are licensed for.
  * To see available versions for your credentials:
    * `composer show -a toweringmedia/module-store-pickup`

===== Configuration =====

Primary admin areas:
  * **Stores > Towering Media > Store Locator > Pickup Orders**
  * **Stores > Configuration > Towering Media > Store Locator** (pickup rules)

Recommended setup order:
  - Confirm Store Locator is configured with active locations.
  - Configure pickup rules (prep time/cutoff/schedule).
  - Verify pickup option visibility in checkout.
  - Test pickup slot selection and order submission.

===== Validation checklist =====

  * Pickup option appears at checkout for valid carts.
  * Available slots respect location hours and blackout dates.
  * Pickup order metadata persists on order/admin views.
  * Admin pickup workflow (new to completed) is traceable.

===== Troubleshooting =====

  * **Pickup not shown**: verify module enablement, location status, and checkout shipping config.
  * **No slots available**: verify schedule config, blackout dates, and store timezone.
  * **Pickup metadata missing**: retest with clean checkout session and confirm extension integration points.

===== Related Magento 2 docs =====

  * [[magento2:extensions:start|Magento 2 extension index]]
  * [[magento2:start|Magento 2 docs home]]
  * [[magento2:extensions:toweringmedia-module-store-locator|Magento 2 Store Locator Extension]]
  * [[magento2:extensions:toweringmedia-module-distance-delivery|Magento 2 Distance Delivery Extension]]