Storemapper Integration adds a Storemapper store locator map to the Joomla articles you choose. You enter your Storemapper ID and start value, pick where the map appears on the page, and select the menu items that open those articles.
It is for store owners who already have a Storemapper account and want the locator on a page of their J2Commerce site.
Requirements
- J2Commerce 6.0.0 or later.
- A Storemapper account with a store locator set up. Storemapper is a separate service from J2Commerce.
- A Joomla article that has its own Single Article menu item. The map only appears on articles reached this way.
Installation
Storemapper Integration is a separate add-on available from the J2Commerce Extensions Store.
- Go to System -> Install -> Extensions and upload the plugin package.
- Go to System -> Plugins and search for Storemapper Integration.
- Set the status to Enabled, then open the plugin to set it up.
Finding Your Storemapper Values
Storemapper gives you an embed code for your locator. Two values in that code go into the plugin.
- Sign in to Storemapper and open the embed code for your locator.
- Copy the number after
data-storemapper-id=. This is your Storemapper ID. - Copy the value after
data-storemapper-start=, without the quote marks. It looks like a date inYYYY,MM,DDformat.
Settings
All settings are on the Basic tab of the plugin.
| Setting | What It Does | Default | Options |
|---|---|---|---|
| Storemapper ID | The ID from your Storemapper embed code. | Empty | Text |
| Storemapper Start | The start value from your Storemapper embed code, entered without quote marks. | Empty | Text, such as YYYY,MM,DD |
| Display Location | Where the map appears on the article page. | None selected | Display After Title, Display Before Content, Display After Content |
| Menu Display | The menu items whose articles show the map. | None selected | Any published menu item; select more than one |
Warning
The map does not appear until you choose a Display Location and at least one menu item.
Showing the Map on a Page
- Create an article for your store locator page, or pick an existing one.
- Go to Menus, open the menu you use, and add a menu item of type Articles -> Single Article that points to that article.
- Open the Storemapper Integration plugin. Enter the Storemapper ID and Storemapper Start.
- Choose a Display Location.
- In Menu Display, select the menu item from step 2, then save.
- Open the page on your site and check that the map loads.
Info
Visitors see the text "Store Locator is loading from Storemapper store locator app..." until the map appears.
Troubleshooting
| Problem | What To Check |
|---|---|
| No map on the page | Confirm the plugin is enabled, a Display Location is chosen and the page's menu item is selected in Menu Display. The menu item must be a Single Article type. |
| The loading text stays on screen | Check the Storemapper ID and Storemapper Start against your embed code. Make sure neither value includes quote marks. |
| The map shows in the wrong place | Change the Display Location. |
Uninstalling
Go to System -> Manage -> Extensions, find Storemapper Integration and uninstall it. The map no longer appears on your pages.