1. 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)

Discussion in 'Showcase Closed Suggestions' started by Bob, Jan 21, 2016.

  1. Bob

    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
     
    Neal, fatih, 0ptima and 1 other person like this.
  2. Bob

    Bob Developer Staff Member

    NOTE: This functionality is about Showcase ITEMs (the actual Item Pages themselves), not Showcase CATEGORY Pages, so please do not discuss Showcase CATEGORY Page functionality in this thread.
     
    Dadparvar likes this.
  3. Dadparvar

    Dadparvar Member AMS Premium CAS Premium RMS Premium SC Premium UBS Premium

    Awesome.
    As you know, long time I was waiting for that (even before purchasing showcase itself!)
    So, thanks a lot.

    Just a question: EDIT moved to own thread.
     
    Last edited by a moderator: Jan 21, 2016
  4. beanfan78

    beanfan78 Member AMS Premium SC Premium

    Funny, I know I am tired when I am running 2.5.4 and searching high and low for this option. Then I realized this is in 2.6.0 beta...I can't wait to get this. I need this for my project :) Are we able to beta test?
     
  5. Bob

    Bob Developer Staff Member

    Showcase Early Adopters will be getting it first (for beta testing) and being that you are an AMS Early Adopter, you will see it in action at the private development site soon.
     
  6. beanfan78

    beanfan78 Member AMS Premium SC Premium

    Ahh ok, I wasn't around when Showcase was beta so I didn't realize that it's like AMS. Thanks, and I am sure many of us are excited about 2.6!
     
  7. Bob

    Bob Developer Staff Member

    Early Adopter license isn't about the initial creation of an addon, its the TOP TIER license. Both Showcase and AMS have 3 license tiers (Basic, Premium and Early Adopter). Early Adopter license are for people that want to be deeply involved with the development process (as you know from being part of AMS development). Im probably going to change the name from Early Adopter to Platinum or something so that people stop thinking its only about the initial development of AMS lol
     
  8. beanfan78

    beanfan78 Member AMS Premium SC Premium

    Okay that makes a lot more sense when you put it that way. I like the tiered renaming of it. Early adopter made me think that there is a secret little club that got in early and I missed it, but I am happy to be wrong about it. Thanks for explaining it!
     
  9. Bob

    Bob Developer Staff Member

    You can convert your Showcase "Basic" license to either Premium or Early Adopter. Inbox me if you are interested. Most of the AMS Early Adopters have upgraded their Showcase License.
     
  10. mouth

    mouth Member CAS Premium EMS Early Adopter RMS Premium SC Premium UBS Premium Sportsbook

    @Bob, is there plans to extend this functionality a little further and allow map routes?
    I'm thinking Google Maps Embed API where the user interacts with the map on the map tab to drop pins and show a route taken.
     
  11. Bob

    Bob Developer Staff Member

    I don't have any specific plans right now. Feel free to make a suggestion (and quote the specific part of the API that does what you are asking for).
     
  12. Kintaro

    Kintaro Active Member AMS RMS Premium Showcase Pickem Sportsbook

    Can you please activate this in the test category? in this way we can create some item with address included.
     
  13. Bob

    Bob Developer Staff Member

    Should already be activated... I just added one to this showcase item: 110 Gallon Aquarium Starter Kit

    leave the category, come back to it, then try and create (or edit an existing one if you have one). The address field is at the top just below the description field.
     
    Kintaro likes this.
  14. Kintaro

    Kintaro Active Member AMS RMS Premium Showcase Pickem Sportsbook

    opsssss I think I'm blind!

    how about using Google Maps API to suggest the address while typing in the text field?
     
  15. Bob

    Bob Developer Staff Member

    There are SEVERAL different Google Maps API's (not just one). The one that I am using for ITEMS is the Embed API. The Embed API is a NON METERED API (all the rest are METERED). Its only function is to display a Map, it doesn't have functionality like Auto Suggest (that is actually a special API in and of itself). Its very basic, but that is all that is needed for an ITEM PAGE IMO.

    The JS API is now METERED (It was unlimited up until the start of this year). I don't feel right slapping in a METERED API into core (which is why I choose the Embed API for core). I plan on developing a couple Maps addons for Showcase at some point and those will use the JS API (one will be the Categories Pages). Free until exceeding 25,000 map loads per day for 90 consecutive days (which is why I will not include with code). Also must have credit card validation for an API Key.

    The Auto Suggest address is now its OWN "Places" API Web Service( and actually is LIMITED and Metered as well). Its based on Businesses that have been vetted into Googles DB (so you can't add just any old location). Google Places API Web Service :150,000 free requests per day (after credit card validation)

    Anyway... CORE will only be using the EMBDED API (Google Maps Embed API  |  Google Developers)
     
    Kintaro likes this.
  16. Stuart Wright

    Stuart Wright Member Showcase

    Sorry if I missed it, but is there a map page where all the showcases with a map location can be seen? Lots of pushpins on a map, one for each showcase? Click the pushpin and it opens a small pop-up information box. Click a 'More' link in the box and it will open the showcase?
     
  17. Bob

    Bob Developer Staff Member

    Not yet. I went with the Embed API for item pages as its an UNMETERED API and doesn't require a Credit Card to get an API key. The Embed API is only for SINGLE points on a MAP, so another API (one of the more powerful ones) needs to be used for the Category Pages implementation (which has been suggested here: Google Maps API integration for Showcase Items (Category Pages)
     
  18. TomChuck

    TomChuck New Member Showcase

    Anyway to paste in a the gps or Google maps url here vs the address?
     
  19. Bob

    Bob Developer Staff Member

    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.
     
  20. Kintaro

    Kintaro Active Member AMS RMS Premium Showcase Pickem Sportsbook

    take a look at this:
    Unmaintained - Auto Complete Location

    EDIT: oopssss I saw only now the METERED thingy... :(
     
  1. This site uses cookies to help personalise content, tailor your experience and to keep you logged in if you register.
    By continuing to use this site, you are consenting to our use of cookies.