Basics of store locator feature


Customers are able to combine their online shopping experience with the ability to search their brand branches and stores in their state and local area. This can be accomplished through SAP Hybris core accelerator offering of Store Locator functionality, which couples with a GoogleMaps API approach to providing customers with a way to search, browse, and view detail pages for a specific store.

WCMS Content Slots

Store locator functionality could have several content slots available for content managers to create and insert specific content they wish to display on the store locator page. The left side content slot displayed on the store locator page will not contain navigation links as on other category landing/search result list pages, but will rather be empty slots for content authors to fill with additional advertising, imagery, or text. The top content slot will likewise be blank and managed within the WCMS and will feature the same functionality as the left content slot. If the content authors declare that a content slot links out to another area of the site or outside of the site, clicking on the content within the slot will redirect the user to that landing page. Clicking on static content like images or static text will have no functionality.

Point of Service Item

The Store Locator introduces new item type, PointOfService. The purpose of this item is to equip address data of AddressModel data type with geographic position. Managers can attach the PointOfService to some other items to make them geographically searchable. Moreover, thanks to PointOfServiceModel, Store Locations can be represented on a map.

Find-a-Store Search Box

The Store Search page allows a customer to search for stores by territory. It commonly gets a significant volume of traffic from customers visiting the storefront to find details of offline stores, where applicable. Due to this volume, this page is often merchandised to:

  • Suggest the customer shops online.
  • Inform the customer of online-only promotions, such as free delivery and discount codes.
  • Promote new product ranges or speed of delivery.

Users will be prompted to enter either an alpha-numeric search OR to enter a numeric zip code into the “Town/City/Zip Code” field.

  • Upon clicking within the search box, the user will be able to input their search query. Clicking away from the search box will retain the users search term. User must click on “Search” button in order for the system to execute the search query.
  • Upon clicking search, the system will communicate and share data with Google Maps API to determine the location of the user and then display the nearest stores in proximity to the entered location.
  • If the user’s search query is not recognized, or if no stores are available within the area that the user declared to search (search radius can be a configurable attribute within the hybrishMC) the system will display error messaging in the Error Message Area.


Store Detail Page

The Store Detail page provides the customer with details about a specific store. Selecting a store from the search results page will redirect the user to the store results detail page, which will feature more specific store content.

As with the search page, the search detail page will feature several blank content slots, which will be managed and edited by the content editors. Content slots can feature text, images, or any other display that the brand wishes to push forth. Upon reaching the store detail page for a particular store, the breadcrumb path will likewise dynamically update to display “Home -> Store Locator -> Name of Store”. The breadcrumb path will remain actionable, with the user able to navigate back to higher level navigation through clicking on the breadcrumb path.

Within the store detail page, users will view a larger image from the Google maps API which will display an icon on the map for the store they are looking for. Clicking on the Google Map provided will redirect the user to, which will open with the selected address highlighted and selected with a pin point. From there the user will interact with Google Maps to research directions. Clicking on other content such as static images or text on the page will have no effect. Content slots that have an associated URL attached to user interaction with the content within will serve to redirect the user to the declared landing page upon the user click.

A greater amount of store details will display in the Store Detail page than was seen in the search results list page, as stores will have the following attributes provided to the customers browsing the page

  • Distance
  • Address
  • Telephone
  • Email Address
  • Store Hours
  • Features

All store specific information will be defined and managed in the hMC.

Page Components



Store Name

Displays the name of the store as the title of the page.

Store Image

An image of the store.

Google Map

A map showing the position of the store.

Store Details

A list of details about the store including store-specific content.

local_offerevent_note July 26, 2017

account_box Mickael