• REGISTRATION REQUIREMENTS:

    Your username here MUST MATCH your XenForo username (connected to your XF license).

    Once you have registered here, then you need to start a conversation at xenforo.com w/Bob and provide the following:
    1. Your XenForo License Validation Token
    2. The Domain Name associated with the License
    NOTE: Your account will be validated once ALL requirements are verified/met. Thank you for your patience.

Implemented Google Maps Embed API integration for Showcase Items (Item Pages)

Bob

Developer
Staff member
Showcase Items can now display a google map to pin point a location via the address entered into a location field that is now part of the Item Create and Edit forms for Categories that allow maps. Allowing a google map is a per category setting.

This is an API driven function which requires a registered API Key from google, so in order to use this functionality, you need to obtain a Google Maps Embed API Key: Google Maps Embed API

Once you obtain a key, you simply add the key to the new Showcase Global Option (as shown below) which is located on the Showcase Options >> Item Page tab (at the very bottom of the options).

Selection_004.png

Once you add the key, the Map Location field will be visible on the Create Item and Edit Item forms.
Selection_013.png

As mentioned, Google Maps for Showcase Items can be Enabled/Disabled on a Per Category Basis. Along with that, you can also override the Global Map Options and set them specifically for that category (which currently is limited to display locations) (see below image)

The "Allow Google Maps for Item" category option is ENABLED by default, so if you want to allow maps for items in all of your categories, you don't have to do anything, however, if you don't want maps for items in specific categories, you need to edit them and disable the option.

NOTE: If you don't want maps period, you simply do not add an API key (or remove the API Key in the global options).

Selection_005.png


Lets look at the locations...

As shown in the above images, there are FOUR display locations that can be set. Each location is independent from the other and can be modified without effecting the other locations.

NOTE: Just because you CAN set all 4, doesn't mean you SHOULD set all 4. This is NOT designed to use all four locations at the same time. The only reason I made it so that you could is because there are use cases where you might want multiple locations enabled.

Here is a shot with the locations: Own Tab & Sidebar enabled.
Selection_006.png


Here is a shot with the locations: Header and Sidebar enabled.
Selection_007.png


Here is a shot of an associated discussion thread with the location: Header enabled.
Selection_008.png


Here is a shot of the locations: Below Item Content and Sidebar enabled.
Selection_009.png
 
Upvote 4
This suggestion has been implemented. Votes are no longer accepted.
I am aware of that API (which is part of a METERED additional Web Services API). Its also recently (may 2016) been depreciated and will be unsupported May 2017. Both the JS API and Andriod API have is built in now. You could probably implement it on your own fairly easy on your own for the few months left that it will be available (might even be available longer, just not supported).
 
Anyway to paste in a the gps or Google maps url here vs the address?

no. It has to be a correctly formed address. To do stuff like that, you'd need to use one of the Advanced Map APIs and do A LOT of programming.

I'm not sure if GPS coordinates are what you were referring to @TomChuck, but I am using them with success (example: 45°40'38.7"N 122°17'01.4"W).
 
Back
Top