← All modules

Magento 2 module

Retail Store

Store locator for shops with physical branches: manage retail stores in the admin, show them on Google Maps, let shoppers search for the nearest store and give every store its own page.

StorefrontAdminStore locatorContentHyvä

Merchants with physical shops want online customers to find the nearest branch, its opening hours and contact details. This module adds retail stores to Magento: you maintain your branches in the admin, show them on Google Maps, offer a location search with a radius, and each store gets its own detail page with its own URL. The pages and search results are designed with CMS blocks, so their layout can be changed without touching the theme.

Features

  • Manage retail stores with code, name, description, image, opening hours, special opening hours, active status, email, phone and fax number, address (street, postal code, city, country, directions), latitude and longitude, and a map image.
  • Manage store features (for example “Parking” or “Wheelchair accessible”) with name, image and active status, and assign them to stores.
  • A detail page for every active store under its own URL key (with the category URL suffix of the store, e.g. “.html”). The page title is the store name, the description is used as meta description. Per store you can set a template, an SEO text and a note with a note type (“Detail”, “Important”, “Notice”).
  • The detail page also lists the three nearest other stores.
  • Widget “Retails Stores Search”: a search field with Google address suggestions, a radius selection (10, 25, 50 or 100 km), a “Search Retail Store” button and a “Determine location” button that uses the visitor’s current position.
  • Search results are sorted by distance and show the distance to each store. Separate CMS blocks are used for the result and for “no result”.
  • Widget “Retails Stores Map”: a Google map with all active stores as markers, with info windows.
  • Widget “Retails Stores Map within Radius”: a map with all active stores within a given distance of a fixed point, with optional header, result and footer CMS blocks.
  • All map widgets offer the display options of “Google Maps” (size, zoom, controls, visible map details).
  • Demo stores and demo templates can be imported from the command line, which helps agencies to set up a first version.

Configuration

  • Stores and features: Infrangible > Retail Store > Manage Retail Stores and Manage Features.
  • Default templates: Stores > Configuration > Infrangible Solutions > Retail Store > Retail Store, with “CMS Block” (default template for detail pages) and “Info Window CMS Block” (content of the marker info windows on maps).
  • Search and map widgets are placed with “Insert Widget” in CMS pages and blocks.
  • The Google API key is set in the “Google Maps” module.

Good to know

  • Requires “Google Maps” and “CMS Filter”, which are installed automatically. You need a Google API key for maps, address suggestions and the geocoding of search terms.
  • Store data is the same for all store views; there are no translations per store view.
  • For stores using the Hyvä theme, install “Retail Store Hyvä Theme”. “Retail Store Sitemap” adds the store pages to the XML sitemap.

Installation

Install the module with Composer in your Magento root directory:

composer require infrangible/m2-retail-store

Then enable it and update the store as described in the installation guide. Composer installs the required modules listed on this page automatically.

Using the Hyvä theme? Also install the companion module Retail Store Hyvä Theme:

composer require infrangible/m2-retail-store-hyva

Builds on

Composer installs these modules together with Retail Store.

Used by

Modules that build on Retail Store.