====== Magento 2 Store Locator Extension ======

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

This is a Toweringmedia Magento 2 extension guide in the **Store Operations** category. Use this page for location setup, schedules, blackout dates, and add-on integrations.

  * **Module name**: `Toweringmedia_StoreLocator`
  * **Composer package**: `toweringmedia/module-store-locator`

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

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

===== Overview =====

Store Locator is the foundation module for location-aware fulfillment. It manages store locations, schedules, and blackout dates, and provides shared location data used by pickup and delivery add-ons.

Core capabilities:
  * Location CRUD management in admin.
  * Pickup and delivery schedule support.
  * Blackout date handling for fulfillment constraints.
  * Shared Google Maps configuration for location services.

===== Installation =====

<code bash>
cd /path/to/magento
composer require toweringmedia/module-store-locator:<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-locator`

===== Configuration =====

Primary admin areas:
  * **Stores > Towering Media > Store Locator** (location management)
  * **Stores > Configuration > Towering Media > Store Locator** (global settings)

Recommended setup order:
  - Add location records with complete address and contact data.
  - Configure pickup and delivery schedules per location.
  - Configure blackout dates.
  - Configure Google Maps API key/settings if using map and distance features.
  - Validate location visibility in dependent modules.

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

  * Locations can be created/edited/deactivated from admin.
  * Schedules persist correctly by location.
  * Blackout dates are enforced in pickup/delivery slot calculations.
  * Store Pickup and Distance Delivery modules can read location data.

===== Troubleshooting =====

  * **Location not available at checkout**: verify status, store scope, and dependent module mapping.
  * **Schedule mismatch**: re-check timezone and location-specific schedule overrides.
  * **Map/geocode issues**: verify Google API key and enabled APIs for the project.

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

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