Usermap for phpbb

Die Extension "Usermap for phpbb" fügt dem Forum eine interaktive Mitgliederkarte mit den Standorten der registrierten Benutzer hinzu. Die Bestimmung der Standorte erfolgt Über die Angabe des Landes (Staates), in dem der Benutzer wohnt sowie der Angabe der Postleitzahl des Wohnortes. Aus diesen beiden Angaben wird aus der entsprechenden Datenbank von Geonames.org die dort hinterlegte Koordinate ausgelesen und in die Karte eingetragen. Darüber hinaus wird bei mehreren Ergebnissen für eine Postleitzahl das bereits in phpbb vorhandene Profilfeld "Wohnort" mit ausgewertet und die gefundene Koordinate so verfeinert. Die Anzeige des Standortes erfolgt mit einem (Kreis-)Marker, der in der Farbe der Hauptgruppe des jeweiligen Benutzers gehalten ist.
Jeder in der Karte enthaltene Benutzer kann im Umkreis von 1km - 100km in vorgegebenen Entfernungen nach anderen Benutzern suchen. Diese werden ihm mit ihrem Nickname und Entfernung in aufsteigender Entfernung angezeigt. Über den Nickname ist das Profil verknüpft, das in einer neuen Registerkarte (Tab) angezeigt wird.
Die Eingabe oder Änderung von Land und Postleitzahl erfolgt im Profil des einzelnen Benutzers, entweder durch den Benutzer selbst oder einen Administrator. Werden Land und Postleitzahl bei der Registrierung angegeben (Voreinstellung), werden die Daten für die Mitgliederkarte bei der Aktivierung ausgewertet und bei positivem Ergebnis der Benutzer in der Karte dargestellt.
Benutzer, die diese Angaben nicht gemacht haben, können die Karte nicht sehen, so ist auch ein rudimentärer Datenschutz gegeben (wer diese Daten nicht angibt, darf auch die der Anderen nicht sehen).
Als Karte wird eine OSM Karte verwendet.
Der Administrator kann im ACP Breiten- und Längengrad des Kartenzentrums sowie den Zoom-Faktor bestimmen, mit dem die Karte geöffnet wird. Zudem können Über das ACP zusätzliche Sprachpakete für die Extension nachinstalliert werden.
Vor einer möglichen Verwendung der Mitgliederkarte MUSS der Administrator einen (kostenfreien) Account bei Geonames.org einrichten und den Benutzernamen dieses Accounts im ACP eingeben, um die Abfrage der Koordinaten zu ermöglichen. Ohne diese Angabe funktioniert die Mitgliederkarte nicht!

Ab der Version 0.6.0 ist ein spanisches Sprachpaket enthalten (Danke an Jorge alias Jorup16).
Zusätzlich zur Standardsuche auf geonames.org können jetzt auch Koordinaten über die Google Maps API gesucht werden (API Key benötigt!!) sowie eine interne Datenbank abgefragt werden, die allerdings vorher durch den Admin im ACP befüllt werden muss. Hintergrund dieser Ergänzungen ist, dass geonames.org nicht alle Länder in der Datenbank enthält, bis auf wenige Ausnahmen (z.B. Israel) liefert Google Maps dazu Ergebnisse. Für die Länder, für die beide Datenbanken keine Koordinaten liefern, können diese durch den Admin in der internen Datenbank bereitgestellt werden, ggf. müssen die betroffenen Nutzer ihn dabei durch die Bereitstellung von Koordinaten unterstützen.
ACHTUNG: Bugfix für Version 0.6.0! Hier hat sich ein Fehler in der Migration-Datei v_0_6_0_0.php eingeschlichen, der zusammen mit einem Fehler in der Sprachdatei 'language/en/countrycode.php' zu Fehlermeldungen und einer unvollständigen Aktivierung führt. Diese Fehler sind in der Version 0.6.1 behoben.
Zur Korrektur (nur wenn bei der Aktivierung oder in der Nutzung Fehler gemeldet werden!) die Extension im ACP deaktivieren, die Arbeitsdaten der Extension löschen, den Board-Cache löschen, alle Dateien der Extension löschen und durch die im Download-Paket der Version 0.6.1 ersetzen. Anschließend die Extension wieder aktivieren und die Einstellungen im ACP wieder eintragen. Die Nutzerdaten sind ebenfalls verloren und müssen durch die Nutzer wieder im Profil eingetragen werden. Soll dies vermieden werden oder soll eine lauffähige Version der Usermap auf 0.6.1 upgedatet werden, der Anleitung auf phpbb.de folgen.

In der Version 0.6.2 ist der OSM Tile Server umgestellt auf das https-Protokoll, um Warnanzeigen in Boards mit diesem Protokoll zu vermeiden. Außerdem wurde ein Seiteneffekt der optimierten sql-Datenbankabfrage beseitigt, der auch Usern ohne Eintrag in der Usermap deren Betrachten erlaubte.

Die Version 0.7.0 ist verfügbar, sie beinhaltet ein neues Feature, mit dem auf der Karte ein zusätzliches Overlay mit selbst erstellten (durch den Admin) Points of Interest (POI) durch den Nutzer hinzugefügt werden kann. Dazu wurde in der oberen rechten Ecke der Karte ein Bedienfeld für die Auswahl der Overlays hinzugefügt.
Zum Erstellen und zur Pflege von POIs ist im ACP ein weiterer Tab hinzugefügt worden. Zur Unterscheidung verschiedener Kategorien von POIs sind verschiedenfarbige Marker als Auswahlliste verfügbar. In den Einstellungen kann dieses Feature aktiviert werden. Zudem kann dort ausgewählt werden, ob alle Nutzer (also auch die, die nicht in der Karte erfasst sind und sie deshalb nicht sehen können) diese POIs sehen dürfen. Wird dies bejaht, können alle Nutzer dieses Overlay sehen, das Overlay mit den Nutzer-Standorten wird aber für sie nicht angezeigt. Ebenfalls im Einstellungs-Tab kann eine zusätzliche Legende für das POI-Overlay erstellt und editiert werden. Die Karte selbst bietet neben der bisherigen Grundkarte eine topografische Karte zur Auswahl an.
Hinweis: Wer von der Version 0.5.x updaten möchte, muss die obigen Hinweise zum Bugfix für Version 0.6.0 beachten!

Usermap ver 0.8.0 ist jetzt zum Download bereit. Die Änderungen umfassen einige Bugfixes, die entweder bei einzelnen Nutzern aufgetreten sind bzw. beim Code-Review aufgefallen sind. Weiterhin enthält das Paket jetzt eine README.md Datei mit einer detaillierten Anleitung, die html-Dateien für den Style prosilver sind auf die TWIG-Syntax umgestellt und (GANZ WICHTIG!!!):
Die für zukünftige Versionen von phpBB als "deprecated" (überholt, veraltet) gekennzeichnete Nutzung der Sprachvariablen über das Nutzer-Objekt wurde umgewandelt in die Nutzung des Sprach-Objektes ($language). Damit ist die Usermap ab dieser Version nicht mehr kompatibel mit phpBB 3.2.5 und darunter. Wer also noch eine solche Version von phpBB benutzt, DARF NICHT UPDATEN oder er muss sein Forum auf phpBB 3.2.6 oder neuer updaten/upgraden. Zum Schutz vor einer versehentlichen Aktivierung auf dafür nicht geeigneten Foren wird die verwendete phpBB-Version vor Aktivierung geprüft.

Usermap ist jetzt in der Version 0.9.0 verfügbar. Neben einigen kosmetischen Änderungen (die über "Schnellzugriff" und "User Dropdown" erreichbaren Menus werden nicht mehr durch die Karte verdeckt und bei fehlenden POI-Beschreibungen wird kein leeres Popup-Fenster mehr geöffnet) wurde die neueste Leaflet-Version 1.7.1 integriert. Weiterhin ist die Größe (Durchmesser) der Marker für die Standorte der Benutzer getrennt für die Darstellung auf Computern und portablen Geräten (Smartphone) definierbar. Zur einfacheren Integration von selbsterstellten Icons für die POI-Darstellung werden nunmehr auch die Größe und der Ankerpunkt der Icons in der Datenbank erfasst.
Die mit der Version 0.8.0 eingeführte Begrenzung auf phpBB-Versionen 3.2.6 und größer wurde durch Änderung des Zugriffes auf die globale Sprachvariable so weit rückgängig gemacht, dass die Usermap mit allen phpBB-Versionen ab 3.2.0 aufwärts kompatibel ist.
Einzelheiten der Änderungen enthält die Datei CHANGELOG.md

Usermap ver 0.9.1 ist verfügbar, sie behebt einen SQL Fehler, der durch eine unbeabsichtigte Änderung einer SQL-Abfrage entstanden ist.

Usermap ver 0.9.2 ist verfügbar, sie enthält ein französisches Sprachpaket.

• Ergänzend zu den beiden Grundkarten "Straße" und "Topogafisch" kann nun auch ein Satellitenbild ausgewählt werden
• Die das einzelne Mitglied repräsentierenden Marker öffnen beim Anklicken eine Textblase mit einem Link zum Profil des betreffenden Mitgliedes
• Im ACP wird im Fuß der jeweiligen Tabs die Version angezeigt
• Ein neues Berechtigungssystem, mit dem der Administrator die Berechtigungen für die einzelnen Rollen/Gruppen festlegen kann; die Berechtigung zum Administrieren der Mitgliederkarte wurde der Rolle "Umfassender Administrator" zugewiesen, die ACP Tabs der Erweiterung werden mittels einer Migrationsdatei gelöscht und mit der Berechtigungsabfrage neu erstellt, um das Berechtigungssystem für den ACP einzurichten
• Mitglieder können POIs durch Rechtsklick in die Karte erstellen (sofern sie dazu berechtigt wurden)
• Administratoren/Moderatoren werden entsprechend ihrer Berechtigung über Benachrichtigungen informiert, wenn ein Benutzer einen neuen POI angelegt hat
• Ein Polnisches Sprachpaket
• Die Standardgrößen für POI-Marker können in den Einstellungen frei definiert werden, um dem Admin eine grundsätzliche Größenänderung der mitgelieferten POI-Marker bzw. die Definition der Standardgröße eigener POI-Marker zu ermöglichen
• Alle Aktionen werden im Log festgehalten
• Berichtigungen an den Ländereinträgen des Benutzerdefinierten Profilfeldes "mot_land"

• Zusätzliche Suchoptionen für die Suche nach Mitgliedern und POIs sowie Adressen und anderen Suchbegriffen in der Google Maps API
• Eine Liste mit Berechtigungen des aktuellen Nutzers unterhalb der Legende
• Einen Link aus dem Mitgliederprofil zur Position auf der Karte
• Admin-definierte Kartenebenen für POIs
• Username und User_colour werden nicht mehr in der USERMAP_USERS_TABLE gespeichert, sondern zur Laufzeit aus der USERS_TABLE gelesen
• Links zum Mitgliederprofil werden nicht mehr aus den config-Variablen für den Server gebildet (verhindert Fehler durch falsche Werte)
• Das Kartenzentrum kann jetzt feiner eingestellt werden, weil mehr als eine Nachkommastelle verwendet wird
• Das Icon für den Navbar-Link der Mitgliederkarte wurde von "Globus" auf "Karte" geändert
• In allen Eingabefenstern für POIs kann die Kartenebene ausgewählt werden, auf der dieser POI angezeigt wird
• Ein zusätzlicher ACP-Reiter zum Administrieren der Kartenebenen, einschließlich der Möglichkeit der Definition eines Standard-Icons für die Ebene
• Vermeidung von Fehlermeldungen und/oder weiße Seite durch Abfangen einer Bedingung, die auftritt, wenn keine Moderator-Rolle das Genehmigen von POIs beinhaltet
• Datenbank-Einträge (Kombination aus Land und PLZ, die eine Koordinate für diesen Ort enthalten) im Admin-Bereich enthalten nun ein Namensfeld zur besseren Identifikation
• Diese Datenbank-Einträge können jetzt auch bearbeitet werden
• Ein Abschnitt mit Allgemeinen Einstellungen im Reiter "Einstellungen", um die Zeilenzahl pro Tabellenseite für die Reiter "Datenbank", "POI-Bearbeitung" und Kartenebenen" einstellen zu können
• Über die Google Maps API kann die Koordinate des Mitglieder-Markers auf der Karte nunmehr bis auf die Straßenanschrift verfeinert werden. Dazu muss die Adresse im Profilfeld "Wohnort" (Nutzer) und das jeweilige Land in der Google-Suche (Administrator) angegeben werden

Die Usermap ist in der Version 1.1.1 verfügbar; diese behebt zwei Bugs, die zu einer Fehlermeldung bei Neu-Installation führen sowie die Anzeige aller mit Javascript erzeugten Elemente (Suchfelder, Karte) verhindern, wenn die Anzeige von POIs ausgeschaltet ist.

Die Usermap ist in der Version 1.1.2 verfügbar; diese beinhaltet Änderungen, die während des Validierungsprozesses zur Aufnahme in die CDB von phpbb.com notwendig wurden und behebt das Anhängen der SID an den Pfad zu den POI-Images auf manchen Mobilgeräte-Browsern, was die Anzeige der Images verhinderte.

Ab sofort ist die Usermap über den Download-Link im Startbeitrag in der Version 1.1.3 verfügbar.
Diese Version beinhaltet Änderungen, die verhindern, dass Spammer bei Sichtbarkeit der Usermap für Gäste Einträge in der USERMAP_POI_TABLE generieren konnten, die zum teilweisen Funktionsausfall der Such-Tabs und des Kartenkontrollelementes (Auswahl der Karte und der Overlays) führten. Außerdem wurde ein Fehler behoben, der zu falschen Suchanfragen über die Google Maps API und damit zu Fehlermeldungen führte.
Ein weiteres Problem war die Länge des PLZ-Feldes in der USERMAP_USERS_TABLE, das zwar die international maximale Stellenanzahl berücksichtigte, nicht aber zusätzliche Trennzeichen wie z.B. den Bindestrich.
Seit 10.03.2022 ist ein Niederländisches Sprachpaket integriert, das auch getrennt verfügbar ist (siehe Download-Link am Seitenende).

The extension "Usermap for phpbb" adds an interactive map with the users' positions to your forum. To determine those positions the extension uses the country and postal code (zip code) of each user's location to look up the coordinates in the Geonames.org database. If the database contains more than one coordinate for this country/postal code combination Usermap uses the predefined profile field "location" to improve the determination of the coordinates. The positions are displayed by a circular marker coloured in the colour of the main group of the respective user.
Every user contained in the map can search for other users within predefined distances of 1km - 100km (0.6mi - 62mi) around his position. Results are displayed with the nicknames and distances in ascending order. The nickname works as a link to the profile of the respective user which will be opened in a new browser tab.
Input or change of country and/or postal code is done in the user's profile, either by himself or an administrator. If country and postal code are provided at registering (default) the respective user will be added to the Usermap at activation, if the coordinates can be determined.
Users neglecting provision of this data are not authorized to see the Usermap, therefore a very basic privacy protection is implemented (users not willing to provide this data are not eligible to see the data of others).
An OSM map is used for displaying the user positions.
The administrator can select latitude and longitude of the map center as well as the zoom at initial display of the map in the ACP. In addition the administrator can install additional language packs for this extension.
Prior to usage of Usermap the administrator MUST open a (free) account with Geonames.org and enter the according username(s) in the ACP in order to enable usage of the database. Without at least one Geonames.org user name the Usermap is NOT functioning!





Starting with version 0.6.0 Usermap contains a Spanish language pack (thanks to Jorge aka Jorup16).
In addition to the standard query at geonames.org ist is now possible to obtain coordinates through the Google Maps API (an API Key must be obtained!!) as well as through an internal data base. Using the last possibility requires the admin to fill this data base in the ACP. The reason for these additions is that the geonames.org data base does not contain coordinates for all countries. In those cases a query to the Google Maps data base is possible but some countries (e.g. Israel) are not in the Google Maps data base either so for those cases the admin can provide coordinates through the internal data base. Support of users living in such a country could be necessary by providing coordinates to their postal code.
ATTENTION: Bugfix for version 0.6.0! This version contains a an error in the migration file v_0_6_0_0.php which in conjunction with an error in the language file 'language/en/countrycode' leads to error messages and a prematurely concluded activation. Those errors are corrected in version 0.6.1
If you experienced error messages during activation or while using the extension please deactivate it, purge the extension data and the board cache in the ACP, delete all files of the extension, upload all files of the new version and activate it in the ACP. Then edit the necessary data within the ACP settings menu. Unfortunately all user data is lost and the users have to edit their profile data in order to use the usermap. If you want to avoid this or if you are updating a functioning version 0.6.0 please follow the steps described on phpbb.com.

Version 0.6.2 now provides the https protocol for the OSM tile server to prevent warnings in environments using this protocol. An effect of the optimized sql query allowing unlisted users to see the usermap has been corrected.


Version 0.7.0 is available, sporting as a new feature an additional overlay with points of interest (POI) which the admin can generate and edit/delete through an additional ACP tab. These POIs are displayed on an additional map overlay which users can select through a newly added layer control element in the upright corner of the map. To distinguish different POI catagories the admin can select from various colored markers during generation of a POI. This new feature can be enabled through the settings tab. There you can select whether the POI layer ist displayed to all users (and not only to those whose location is on the map). If this selection is enabled every user can see the map and the POI overlay but for users not on the map the user locations are not displayed. A legend for the POI overlay may be generated and edited through the settings tab as well. In addition to the previous base map a topographic map is now available for selection by the user. Note: If you are going to update from version 0.5.x please follow the above mentioned instructions for the bugfix of version 0.6.0!




Usermap ver 0.8.0 is available for download.Changes include some bug fixes either experienced by single users or have been noted through a code review. Additionally the package includes a README.md file with a detailed manual and all prosilver style html files are converted to TWIG syntax and (VERY IMPORTANT!!!):
The (in future phpBB versions marked as deprecated) usage of language variables through the user object has been changed to the usage of the "$language" object thus making Usermap starting with this version incompatible with phpBB 3.2.5 or prior. If you are still using one of these versions of phpBB you either MUST NOT update to Usermap 0.8.0 or update/upgrade your forum to a phpBB version 3.2.6 or newer. As a protection against accidentally enabling Usermap on a forum not suited for it a version test is part of the enabling procedure.



Usermap ver 0.9.0 is available. Apart from changes in the "look" (quick links and user dropdown menus are no longer partially hidden by the Usermap's map object and there will no longer be an empty popup window if the POI description is missing) the latest Leaflet version 1.7.1 has been incorporated. In addition the administrator can define the radius of the markers showing user locations on the map for computers and mobile devices independently. For easier usage of user defined icons to display POI icons the administrator can now define size and anchor of POI icons in the data base.
The limitation to phpBB versions of 3.2.6 and later has been changed, Usermap is now compatible with all phpBB versions from 3.2.0 upwards.
Please refer to the CHANGELOG.md file for details.



Usermap ver 0.9.1 is available which contains a bug fix resulting in an sql error due to an inadvertently changed query statement.

Usermap ver 0.9.2 is available, it contains a French language pack.

• In addition to the base maps "street" and "topografic" a satelite image is available
• A popup to user markers containing a link to the user's profile which will open in a new browser tab or window
• A footer line with version and copyright information on each of the ACP tabs
• A permission system allowing the administrator to set permissions for each role/group; the permission to manage the extension has been added to the role "full administrator" and all ACP tabs will be deleted and recreated in order to set this permission into force for the ACP
• The possibility for users to create new POIs by right-clicking into the map at the desired location (if permitted to do so)
• A notification system in order to notify administrators/moderators that a new POI has been created by a user
• A Polish language pack
• The default size of POI markers can be defined by the administrator now in order to enable him to set the size of POI markers delivered with Usermap or to define the default value for own POI markers
• All activities are logged
• Corrections regarding the table entries for the custom profile field "mot_land"

• Additional options to search for members and POIs as well as for addresses and other stuff from the Google Maps API
• A list with current permissions underneath the legends box
• A link from a user's profile to his/her location on the map
• Multiple, admin defined POI layers
• Username and user colour are no longer stored in the USERMAP_USERS_TABLE but are read from the USERS_TABLE during run time
• Links to the user profiles are no longer generated by using the server config variables (which could lead to errors if not set correctly)
• The map center can be positioned more accurately due to using more than one digit after the decimal point
• The Usermap icon was changed from "Globe" to "Map"
• In all POI input windows you can now choose which overlay will be used to accommodate this POI
• An additional ACP tab to administer map overlays, including the possibility to select a default icon for each overlay
• Bug fix to prevent fatal errors due to an empty array if moderating POIs hasn't been assigned to at least one moderator role
• Database items (country and postal code with a coordinate representing this location) in the ACP now contain an additional name field to better identify them
• ACP database items can now be edited
• A general settings section in the ACP Settings tab to select the number of rows per table page on the tabs "Internal Database", "POI handling" and "Map overlays"
• Using a Google Maps API key it is now possible to identify a location down to rooftop level (street address) by entering the address into phpBB's location profile field (user) and forcing the coordinate lookup for the respective country code with Google Maps (admin)

Usermap Version 1.1.1 is available; it contains two bug fixes which led to an error message during a new installation and prevented display of all Javascript elements (search forms, map) if displaying POIs was disabled.

Usermap Version 1.1.2 is available; it contains changes necessary for the validation prior to incorporate this extension into phpbb.com's CDB and fixes appending the SID to the POI image path with some mobile device browsers which prevented display of those images.

Usermap Version 1.1.3 is available; it contains changes necessary to prevent spammers from saving entries into the USERMAP_POI_TABLE which led to misfunctioning search tabs and layer control element.
A possible source for a bad HTML request to the Google Maps API was fixed which led to error messages using that service.
The length of the column containing the postal code in the USERMAP_USERS_TABLE has been adjusted to consider e.g. a dash with the maximum number of characters (internationally the maximum number of characters for postal codes is 8).
Since March 10, 2022 a Dutch language pack is part of Usermap. It is available seperately for download, please refer to the download link at the bottom of this page.

Aktuelle Beta Version der Extension 'Usermap for phpbb' ist 1.1.3 (28.12.2021)

Das niederländische Sprachpaket für ver1.1.3 kann unabhängig vom Gesamtpaket hier heruntergeladen werden (10.03.2022):

Current beta version of phpBB3 extension mot/usermap is 1.1.3 (December 28, 2021)

You can download the Dutch language pack for ver1.1.3 as stand alone here (Mar. 10, 2022):