[2.0.0] Zwirnis Usermap

Zwirnis Usermap
Einbindung einer Usermap ins Forum in dem sich jeder mit seiner Position eintragen kann

Plugin Version: 2.0.0
Plugin Kompatibilität: CF4 / Version >= 4.7.0
enthaltene Sprachen: Deutsch, Englisch

Deutsch
Dieses Plugin ermöglicht die Ausgabe einer UserMap der Foren-Mitglieder mittels OpenStreetMap und Leaflet.js mit folgenden Features:

• Eintrag von genau einer Position pro Foren-Mitglied möglich
  
• jeder Eintrag kann abhängig von den generellen Sichtbarkeitseinstellungen öffentlich oder nur für eingeloggte Nutzer angezeigt werden
  
• Ausgabe der Position eines Foren-Mitglieds auch in dessen Foren-Profil wenn entweder alle Einträge öffentlich sind oder der Nutzer explizit gewählt hat, dass sein Eintrag öffentlich angezeigt werden darf
  
• Zugriff auf Map-Daten zur Darstellung per mapbox.com-Token (Details siehe https://www.mapbox.com/)
  
• Auswahl eines Map-Types, den Leaflet.js bietet, möglich (Standard: Straßen-Ansicht)
  
• Angabe einer Position beim Laden der Seite inkl. Zoom-Faktor (Standard: Mitte von Deutschland)
  
• Auswahl zwischen verschiedenen Varianten zur Icon-Darstellung (Standard: keiner - muss nach Installation ausgewählt werden)
  
• die Darstellung der geschlechterspezifischen Icon-Variante kann mit eigenem CSS beliebig beeinflusst werden
  
• optionale E-Mail-Benachrichtigung an Administratoren über neue oder entferne Positionen
  
• optionale Einstellung um Foren-Nutzern die Möglichkeit zu geben ihren Eintrag selbst nachträglich zu bearbeiten
  
• optionale Möglichkeit zur Bearbeitung von Markern durch einzelne Foren-Nutzergruppen möglich (Standard: keine Bearbeitung)
  
• Verwaltung von Einträgen durch Administratoren in ACP möglich (hinzufügen und entfernen)
  

Beachte, dass für den Betrieb der UserMap ein Account bei mapbox.com notwendig ist. Dort fallen ggfs. Kosten für die Ausgabe an, die Du unter mapbox.com nachlesen kann. Dieses Plugin stellt lediglich die technischen Voraussetzungen dafür bereit.

Beachte weiterhin: Nach Installation ist ebenfalls eine Anpassung deiner .htaccess-Datei notwendig. Details kannst Du der mitgelieferten readme.txt entnehmen.

Im Anhang dieses Beitrag ist ein Screenshot der Usermap-Ansicht von https://www.siedler3.net aus Sicht eines Administrator mit eigenem Eintrag in der Map zu finden.

Das Plugin ist kompatibel mit folgenden Plugins:

• Zwirnis Sitemap - ergänzt die konfigurierte Usermap-URL zur SitemapXML
  
• Zwirnis Portal - ergänzt optional eine Box für die Portalausgabe mit einer Liste der neusten Usermap-Einträge
  

English
This plugin enables the output of a UserMap of the forum members via OpenStreetMap and Leaflet.js with the following features:

• Entry of exactly one position per forum member possible
  
• each entry can be shown publicly or only for logged in users depending on the general visibility settings
  
• Output of the position of a forum member also in his forum profile if either all entries are public or the user has explicitly chosen that his entry may be displayed publicly
  
• Access to map data for display via mapbox.com token (for details see https://www.mapbox.com/)
  
• Selection of a map type that Leaflet.js offers is possible (default: street view)
  
• Specification of a position when loading the page including zoom factor (default: middle of Germany)
  
• Choice between different icon display variants (default: none - must be selected after installation)
  
• the display of the gender-specific icon variant can be influenced with your own CSS
  
• optional e-mail notification to administrators about new or removed positions
  
• optional setting to give forum users the possibility to edit their entry afterwards
  
• optional possibility to edit markers by individual forum user groups (default: no editing)
  
• Administrators can manage entries in ACP (add and remove)
  

Note that an account at mapbox.com is required to run the UserMap. There you might have to pay for the output, which you can read at mapbox.com. This plugin only provides the technical requirements for this.

Also note: After installation you will also need to adjust your .htaccess file. Details can be found in the included readme.txt.

In the appendix of this article you can find a screenshot of the usermap view of https://www.siedler3.net from the perspective of an administrator with his own entry in the map.

The plugin is compatible with the following plugins:

• Zwirnis Sitemap - adds the configured usermap URL to the SitemapXML
  
• Zwirnis Portal - optionally adds a box for the portal output with a list of the latest usermap entries
  

Hinweise:
Dieses Plugin ist eines von vielen Plugins, die die Siedler 3 Community seit langer Zeit im eigenen Cback-Forum erfolgreich betreibt. Der Entwickler Zwirni ist auch hier im Cback-Forum angemeldet und kann eure Fragen beantworten.

Changes in Version 1.2.2 and 1.2.3:

• fixed installer
  
• fixed template-variables to prevent PHP-notices
  
• changed cp-icon
  

Seit Version 1.3.0 ist das Plugin einzig mit CBACK 4.7 oder neuer kompatibel.

Version 2.0.0 bringt eine große Menge an Anpassungen mit sich:

• Das Plugin wurde nahezu komplett neu geschrieben für eine bessere Performance und leichtere Möglichkeit der künftigen Weiterentwicklung.
  
• Die Installation ist erheblich vereinfacht: das Plugin läuft nun "out of the box". Es sind keine weiteren Anpassungen an irgendwelchen Dateien notwendig. Man braucht weiterhin lediglich einen mapbox.com-Account.
  
• Unterstützung für Content Security Policy-Header via Plugin zwirni_codeoptimizer ergänzt.
  
• Optional kann man einen Link zur Usermap im Kopfbereich (neben Inbox etc.) einblenden.
  
• Unterstützung für CBACK Portal - man kann ein einzelnes Widget in dem Portal platzieren, welches eine Minimap der Usermap zeigt.
  
• Neues Box-Template "Usermap" für das Plugin Zwirnis Portal, welches eine Minimap der Usermap zeigt.
  
• Erweiterter Support für Zwirnis Portal: das Box-Template "Usermap" kann beliebig oft auf einer Portal-Seite platziert werden.
  
• Die leaflet-Bibliothek, auf deren Basis die Map-Darstellung realisiert wird, kommt nun mit dem Plugin mit statt das sie bei jedem Aufruf von einem externen Server abgerufen wird.
  
• Die gleiche Bibliothek ist nun in der neuesten Version 1.7.1 eingebunden.
  
• Korrigierte Verwendung auf Nutzerprofil: das JavaScript zur Darstellung der Usermap dort wurde bisher doppelt eingebunden.
  
• Korrigierte Templates, die noch individuelle Anpassungen für die Community des Plugin-Entwicklers enthielt. Sie sind nun anonymisiert und unspezifisch.
  
• Bei Verwendung mit Zwirnis Portal muss dieses in Version 3.0.0 oder neuer genutzt werden.