Google Maps Usermap

by itsmeJAY 0 Stars 60 Downloads

Usermap is a plugin which add a map where your user can pin their location on using Google Maps.

Project Details

/***************************************************************************
*
*   Usermap-system for MyBB
*   Copyright: © 2008-2013 Online - Urbanus / Website: http://www.Online-Urbanus.be
*
*   Copyright: © 2016 Jockl
*   http://forum.mybboard.de/user-2693.html
*
*   Copyright: © 2019 itsmeJAY
*   https://www.mybb.de/forum/user-10220.html
*
***************************************************************************/


English

Usermap is a plugin which add a map where your user can pin their location on using Google Maps.

Usermap is using Google Maps. To use the usermap, you have to generate a Google-Maps JavaScript Maps API Key, Geocoding API Key and Elevation API Key and have to accept the Google-Maps-API terms. 

   • You can choose if a link to the user location will be shown on the member profile or in the postbit. None of those links can bee seen by guests
   • Each user can delete his own PIN in the usermap
   • Admins can delete the PIN of a user in the ACP at the user account settings
   • If you need to show some additional locations beside the users, you are now able to put those in the plugin settings
       ◦ You can decide if guests can see those locations
       ◦ The Google Maps nfo-Pin is set as default. You can choose your own Pin image in the ACP
   • You can choose if the elevation of a user location will be shown in the user avatars of the usermap (settings in Meter or Feet are possible)
   • The language of the Google Map changes according the language settings of the MyBB board and can display German and English language
   • Adapt the plugin settings

You will find English and German language files included (translations done by BeeJayZZR and Gerti).

Read the README file for installation and upgrade instructions

Installation instructions:
   • upload all files and folders to the root-folder of your MyBB board
   • Activate & install the plugin
   • Get a Google Maps API key
   • Adapt the plugin settings
     
A little tip:

I have added one field per function (key) in the ACP. Theoretically one key could be set for all 3 APIs (without restrictions).  However, you should restrict your keys so that other users cannot use your keys.  For example, it is recommended to create a key only for the JavaScript Maps API and restrict it via HTTPS (your domain). The geocoding key would have to be restricted by your web server's IP address. This conflicts because Google only allows one restriction per key. Get a little involved with the Google Maps API and you'll quickly see the advantage. Have fun! The plugin comes today or tomorrow.

Deutsch:

Usermap ist ein Plugin für das MyBB, welches eine Karte hinzufügt, auf der User anhand eines Pin´s / Fähnchens ihren Wohnort kennzeichnen können. Usermap nutzt derzeit Google Maps. 
Um die Usermap verwenden zu können, musst Du einen JavaScript Google Maps API Key generieren und die Nutzungsbedingungen der Google-Maps-API akzeptieren. Es wird ebenfalls für die Ermittlung bestimmter Standorte der Geocoding API Key benötigt und zum berechnen der Höhe des Wohnorts der Elevation Key.

   • Ein Link zum Wohnort eines User kann nun sowohl im Profil als auch im Postbit über das ACP eingestellt werden. Beides ist aber für Gäste nicht sichtbar.
   • Ein User kann jetzt seinen eigenen PIN in der Usermap löschen
   • Ein Admin kann im ACP unter den Account-Einstellungen eines Users ebenfalls den PIN löschen
   • Neben den User Pins können nun auch wahlweise zusätzliche Orte im ACP eingestellt werden.
       ◦ Man kann entscheiden, ob Gäste diese Plätze sehen können oder nicht.
       ◦ Als Standard ist das Google Maps Info-Pin gesetzt. Man kann aber auch ein eigenes PIN-Bild vergeben.
   • Man kann auswählen, ob bei den Usern in der Usermap die Höhe eines Ortes angegeben werden soll. Angabe wahlweise in "Meter" oder "Feet" möglich.
   • Die sprachliche Darstellung der Google Map orientiert sich nach der eingestellten Forensprache und unterscheidet zwischen Deutsch und Englisch

Dem Plugin liegen die englischen aber auch deutschen Sprachpakete bei (Übersetzungen von BeeJayZZR und Gerti). 

Lesen Sie die README-Datei für die Installation und Upgrade-Anweisungen

Installation:
   • Lade alle Dateien in das root-Verzeichnis Deines MyBB-Forums
   • Aktiviere das Plugin im ACP
   • Hole Dir den Google Maps API Schlüssel inkl. Geocoding Key und Elevation Key
   • Füge alle Schlüssel in den Usermap-Einstellungen im ACP ein
   • Nehme entsprechende Einstellungen im Plugin vor
     
Ein kleiner Hinweis:

Ich habe pro Funktion (Schlüssel) ein Feld im ACP hinzugefügt. Theoretisch könnte ein Schlüssel für alle 3 APIs eingestellt werden (ohne Einschränkungen). Allerdings solltet ihr eure Schlüssel einschränken, damit andere Benutzer eure Schlüssel nicht verwenden können. Es empfiehlt sich bspw. ein Schlüssel nur für die JavaScript Maps API zu erstellen und per HTTPS (eure Domain) einzuschränken. Den Geocoding-Schlüssel müsste über IP-Adresse von eurem Webserver eingeschränkt werden. Dies steht im Konflikt zueinander weil Google nur eine Beschränkung pro Schlüssel zulässt. Beschäftigt euch ein wenig mit Google-Maps-API und ihr werdet den Vorteil schnell feststellen. Viel Spaß! Das Plugin kommt heute oder morgen.

Previews

Author
itsmeJAY
Collaborators
None
Version
1.5.0
Submitted
04-14-2019, 07:26 PM
Last Updated
05-01-2019, 10:58 AM
Bug Tracking
Disabled
MyBB Versions
1.8.x