Installation Guide

1) Add Maps by Develic to your store

You can add our app to your store from Shopify App Store. After installation, you will have to accept recurring payment for $4.99 per month (first 7 days are free to use). If you uninstall the app within this trial period, you will not be charged.

2) Enable our storefront component for map rendering

Upon installation, you will have to decide if you want to use out storefront component for map rendering. We suggest using our component because it's simple, light, and easy to use. You can turn it on from the application dashboard:

If you have skilled developers on your team, you may prefer to use your own map rendering mechanism. In this case, you should disable our storefront component and handle map rendering by yourself.

Also, you can disable this component if you want to briefly hide the map from visitors (for example, when you want to update the map). Just don't forget to enable it back!

3) Fix liquid templates of necessary pages

Be sure, you added the following code to the liquid templates of the pages with maps:

<div develic-map="{{page.metafields.maps-by-develic.data | escape}}"></div>

You can edit your liquid template file by clicking on "Edit HTML/CSS" menu item of your current theme ("Online store" section of the admin in "Themes" sub-section):

Let's create a separate template for the map page. To do that, click on "Add a new template". In the dialog select "page" in the dropdown, set "map" as the name, and click on the "Create template" button. This will create a page.map.liquid template.

Now open newly created page.map.liquid template under Templates category and add the necessary code there:

Make sure you specified this template as the primary for the page. Please, note that map should be published (Visibility set to 'Visible') for your customers to see it.

4) Generate Google Maps / Geocoding API key

Our application requires you to generate Google Maps / Geocoding API key and provide it in the maps settings so our widgets can properly render Google Maps. The only pre-requisite for this is having a Google account.

To begin the generation, open Google cloud console page here: https://console.cloud.google.com/

Then create the project there with any name you want:

Next step, open "APIs & Services" and on Dashboard click on the button "Enable APIs and Services".
Then find and enable 2 APIs: "Maps JavaScript API" and "Geocoding API".

Now navigate to "Credentials" section under "APIs & Services" and click on "Create credentials" button. Pick "API key" as a type of credential (not "Oauth client ID" and not "Service account key"). Eventually, you will get the API key that you can use in our app:

Now you can use this generated API key in our application in the "Google Maps API key" field to render maps and import CSV data:

5) Add locations to the map

Get back to the application dashboard, pick your page and hit "Add or modify the map" button. Add your locations there via the map editor component.

Here, you can use the API key you created on the previous step...

Hint! Don't forget to save your map before continue (just click on 'Save' button on the map editor page).

6) Check your map on the storefront

Now, open your page on the storefront (as you open all other pages). If everything is done correctly, you should see the map there.

That's all! At this point, you should have working maps widget on your store.

If you're experiencing any troubles with the process, please let us know!