Neueste Version / Latest version:
Kompatibel mit: / Compatible with:
Sprachen / Languages:
Kompatibel mit Toggle Control (Schalter-Stil zentral festlegen) / Compatible to Toggle Control (centrally set style of yes/no switches)
Nachdem ich die phpBB-Erweiterung Adressverwaltung Tourziele von waldkatze am 22.03.2022 übernommen habe, habe ich sie grundlegend überarbeitet:
- Ursprünglich wollte ich sie unter
waldkatze/tzv
weiterpflegen, dies lies sich aber leider nicht realisieren, weil ich einige Änderungen an den Datenbanktabellen vornehmen musste, um Inkonsistenzen beim Ändern von Daten und beim Anlegen und Editieren von Tourzielen zu vermeiden.
Langer Rede kurzer Sinn: Die Erweiterung wurde nachmot/tzv
transferiert. - In Konsequenz habe ich alle Template- und Sprachvariablen durch Voransetzen von
MOT_TZV_
bzw.ACP_MOT_TZV_
eindeutig gemacht, gleiches gilt für die verschiedenen Dateien der Erweiterung. - Das ACP-Modul ist jetzt ein Controller, was den Ersatz von globalen Variablen durch Service-Injection ermöglicht.
- Der gesamte PHP- und HTML-Code wurde komplett überarbeitet und ist jetzt auch PHP 8 konform und entspricht den Coding Guidelines von phpbb.com
- Die Minimum-Version von phpBB habe ich auf phpBB 3.2.3 reduziert (und getestet, funktioniert), Die Erweiterung ist also auch einsetzbar, wenn noch nicht auf phpBB 3.3 upgegradet wurde
- Die Benutzerberechtigungen waren bisher für die Gruppe der "Registrierten Benutzer" gesetzt, ich habe das auf die Benutzer-Rollen "Volle Funktionalität" und "Standardfunktionalität" abgeändert, um das Berechtigungssystem von phpBB besser nutzen zu können.
Selbstverständlich können die Rechte auch für andere Rollen eingestellt werden. - Die verschiedenen Anzeigen der Tourziele im Frontend habe ich harmonisiert und vereinheitlicht
- Im ACP habe ich die rote Hinweisbox zum Löschen vorhandener Einträge (Tabellen Länder, Regionen, Kategorien und WLAN) auf die Anzeige der Tabellen beschränkt
- In diesen eben genannten Tabellen wird beim Löschen von Einträgen ein Bestätigungsfenster angezeigt
- Damit der Admin die rote Hinweisbox zum Löschen vorhandener Einträge auch beachten kann, enthalten diese vier Tabellen eine zusätzliche Spalte, die anzeigt, in wie vielen Tourzielen der entsprechende Eintrag genutzt wird. (Und in dem Falle sollte er wirklich nicht gelöscht werden!)
- Um die Eingaben bei Erstellung und Änderung eines Tourzieles auf Richtigkeit und Vollständigkeit zu überprüfen, habe ich eine Javascript-Datei geschrieben, um den serverseitigen Aufwand zu reduzieren.
Dieses Skript wandelt bei der Eingabe von Koordinaten ein versehentlich verwendetes Komma auch gleich in den geforderten Punkt um. - Dass das erste Eingabefeld in dieser Maske beim Aufrufen der Eingabeseite gleich den Fokus erhält, ist jetzt auch eingebaut.
- Die Eingabe des Landes erfolgt jetzt ebenfalls bequem über ein Dropdown-Feld mit dem Namen des jeweiligen Landes und nicht mehr über den Zifferncode
- Bei der Eingabe eines neuen Tourzieles wird geprüft, ob bereits ein Tourziel mit demselben Namen vorhanden ist; in diesem Falle wird die Eingabe verworfen
- Die Anzahl der Zeilen pro Tabellenseite für die Paginierung kann durch den Administrator im ACP getrennt für ACP und Frontend eingestellt werden. (Im Frontend sind die Zeilen deutlich höher als im ACP, deshalb machen dort weniger Zeilen pro Seite als im ACP viel Sinn)
- In der Tabellen- und Detailansicht werden die GPS-Koordinaten nur dann angezeigt, wenn die Kartenanzeige eingeschaltet ist, in diesem Falle ist die Angabe von Koordinaten beim Erstellen/Ändern eines Tourzieles ebenfalls Pflicht und die Eingabe wird bei Fehlen der Koordinaten verweigert
- Um beim Update von
waldkatze/tzv 0.1.1
aufmot/tzv 0.2.0
nicht bereits eingegebene Tourziele und eventuelle Änderungen/Ergänzungen in den Tabellen für Länder, Regionen, Kategorien und WLAN zu verlieren, gibt es im Wurzelverzeichnis der Erweiterung eine Dateitransfer.php
, die die bisher verwendeten Tabellen in die neuen Tabellen umwandelt; den Aufruf dieser Funktion erkläre ich noch - Um den Vorschriften von phpbb.com zu entsprechen, gibt es auch ein englisches Sprachpaket (Englisch ist die Standard- und Rückfallsprache von phpBB, deshalb muss jede Erweiterung ein entsprechendes Sprachpaket enthalten). Aber bitte nicht enttäuscht sein, die tatsächliche Übersetzung habe ich in der Kürze der Zeit noch nicht geschafft, das kommt noch.
Ich bin mir ziemlich sicher, dass die Adressverwaltung Tourziele in der vorliegenden Version fehlerfrei ist, aber da man ja nie zu 100% sicher sein kann, bitte ich um entsprechende Nachricht im Support-Forum, wenn jemandem etwas auffällt; ihr dürft dort natürlich auch gerne Vorschläge machen, welche Features ihr zukünftig noch haben möchtet.
Installation:
Wer die Adressverwaltung zum ersten Mal installiert (also keine Version von waldkatze installiert hat), speichert die Unterverzeichnisse und Dateien einfach unter
/ext/mot/tzv
.Wer eine Version von waldkatze bereits installiert hat, geht bitte wie folgt vor:
- Die Erweiterung von waldkatze deaktivieren (KEINE Arbeitsdaten löschen!)
- Hochladen der Unterverzeichnisse und Dateien unter
/ext/mot/tzv
- Aktivieren der neuen Erweiterung, damit die Tabellen angelegt werden
- Um die bisherigen Daten zu transferieren, im Frontend in der Adresszeile des Browsers folgende Zeile eingeben (am Beispiel meiner Webseite):
https://www.mike-on-tour.com/ext/mot/tzv/transfer.php
Den Teilhttps://www.mike-on-tour.com
müsst ihr natürlich entsprechend eurer Webseite anpassen - Kurze Zeit nach Drücken der Enter-Taste meldet sich das Transfer-Skript mit einer Meldung, in der u.a. angezeigt wird, wieviele bestehende Tourziele gefunden wurden und wieviele davon erfolgreich transferiert wurden. Hier kann es zu Abweichungen kommen, wenn Benennungen geändert wurden, Grund dafür sind die bereits erwähnten Inkonsistenzen in den Tabellen.
Da die Namen der erfolgreich transferierten Tourziele ebenfalls mit ausgegeben werden, könnte man bei Abweichungen der Zahlen für die gefundenen und transferierten Tourziele also händisch noch etwas retten.
Dazu kann die Erweiterung von waldkatze auch wieder aktiviert werden, damit deren Listen- und Suchfunktionen verwendet werden können, beide Erweiterungen können parallel aktiviert sein, dann aber bitte nicht vom doppelten Link "Tourziele" in der Navigationszeile verwirren lassen. - Sind alle Tourziele erfolgreich transferiert worden und lassen sich auch in der Listen- und Detailanzeige der neuen Erweiterung problemlos aufrufen, können die Arbeitsdaten und anschließend die Dateien der ALTEN Erweiterung gelöscht werden.
Download: