Places Extension

The Places extension is a feature you can use for presenting a various list of locations such as event gatherings, theatres, shops, bakeries, gas stations or any venue for which you need to share certain pieces of information.

For each place, you can save its address from where your app users can get directions easily, contact information such as phone number and/or email address. Website link, or if you are preparing an event and need to share guest invitations, you can also save RSVP link. 

In this article, we will guide you on how to add Places to your Shoutem app and fill the required information.

Add Places screen

In the Screens area, click on + symbol and under the Content section, search for Places screen.

Adding Places items

You can add your list of locations manually one by one, or you can populate a CSV file and import the whole list. 
In this first part, we will guide you through the manual adding, if you are interested in CSV import, skip until CSV Places import title.
In the builder Places area, click on Create items button to open a Places modal window for content editing.

This window is only for content editing, sorting items specifically in this area will not be manifested to sorting in the live app. If you mess up the order, nothing to worry about as it won’t be reflected in your app.

Click on + ADD ITEM button, and start filling the information you want to share for your Place. Apart from all fields, only Place name is mandatory.

In the Description area, you can easily customize the text using supported HTML tags.

Add section

You can easily categorize your locations into categories. One location item can be added to more than one category at the same time.

Image Gallery

Adding up to 5 images, you can create a nice image gallery of your venues or events.

My Places feature

My Places screen can be found once you hover with your mouse over Places feature in the Screens > Content section.
It will automatically list favorite locations selected by your app user.

CSV Places import

A general overview of how content can be imported via CSV files is shared in our support article here, but there is a trick you should now when importing locations via CSV file.
We advise you to use Google Spreadsheets for creating CSV files.

The first step would be to name columns as fields provided in our places screen.

If you would like to categorize your locations in the CSV file directly, that’s possible as well. Simply add Section column after the last Phone column and fill it with categories.
If you would like to add HTML styling in the Description area, our importer will recognize it.

The second step and the most important step is to add Latitude and Longitude values. If you are using Google Spreadsheet, here is a nice free Chrome add-on you could use for generating latitude and longitude coordinates – Geocode.