Arbeiten mit TNG (12) Google Maps Erweiterung

Klick: zurück zu der Seite, von der Sie gekommen sind  zurück Klick: zurück zu Startseite Startseite  weiter Klick: zur nächsten Seite
ausdrucken : Strg-P
  English

Die gezeigten Screenshots basieren auf dem TNG-Template 1. Die anderen Templates zeigen ähnliche Darstellungen.
Die Bildschirmausgabe ist für den Browser Internet Explorer, Version 7, Textgröße "Mittel" sowie einen 19-Zoll-Bildschirm optimiert.

> >  Inhaltsverzeichnis

Sie sind hier:
zu Deutsch etwa: 		TNG - The Next Generation Of Genealogy Sitebuilding
Die nächste Generation der genealogischen Seitenerstellung

Es wird der Umgang mit Google Maps Erweiterung erläutert.
Zweckmäßigerweise druckt man sich die nachfolgende Anweisung aus und legt sie sich neben die Tastatur, um alles in Ruhe abzuarbeiten.


1. Lokaler Server    (auf dem Heimcomputer)
1.1 Allgemeines
Der Umgang mit Google Maps wurde bereits im Beitrag unter Menüpunkt Install 2, Unterpunkt 10, ausführlich beschrieben.

In diesem Beitrag hier wird beschrieben, wie man die Art der Darstellung von Google Maps in der Anwendung TNG durch Hinzufügen weiterer "Ortsebenen" erweitern/bereichern kann.
Dazu gehört, dass weitere Pins mit unterschiedlichen Farben hinzugefügt werden.
Wie sich die durchgeführten Änderungen dann in der Google Maps Darstellung auswirken, kann man nachfolgendem Bild entnehmen.



Wie diese Änderungen/Ergänzungen realisiert werden können, wird nachstehend beschrieben.

Hinweis: Es soll nicht verschwiegen werden, dass die beschriebenen Änderungen / Ergänzungen bei einem TNG-Update bzw. TNG-Upgrade möglicherweise wieder unwirksam werden können, weil die Dateien, in denen die Änderungen / Ergänzungen vorgenommen wurden, durch ein Update/Upgrade "überschrieben" werden.

Deshalb wird vorgeschlagen, diese Änderungen zum Teil in der Datei "cust_text.php" bzw. "customconfig.php" zu speichern, da diese Dateien bei einem TNG-Udate nicht "überschrieben" werden.
Näheres dazu folgt weiter unten bei den jeweiligen Themenpunkten.

1.2 Bisheriger Stand
In der TNG-Personenansicht erscheint eine Ereigniskarte, die von Google Maps generiert wird (allerdings nur, wenn man einen Google Maps API Key beantragt und eingefügt hat).
Diese Karte wird allerdings auch nur dann gezeigt, wenn die Ereignisorte (Geburt, Taufe, Trauung, Beerdigung) im Adminteil ==> Orte ==> Orte bearbeiten mit Längen- und Breitengrad gespeichert wurden.
Darüber hinaus muß man bei dem Eingabefeld "Ortsebene" eine Auswahl treffen. Anderenfalls (wenn man keine Auswahl trifft) wird ein rosafarbener Pin angezeigt.

Am unteren Rand dieser Ereigniskarte sind die Pin-Bedeutungen, farblich unterschieden, aufgelistet, und zwar :
1. Rot = Adresse
2. Braun = Ortsteil
3. Gelb = Ort
4. Grün = Region
5. Blau = (Bundes-)Staat/-Land
6. Lila = Land
7. Rosa = Nicht festgelegt

Die überwiegende Zahl der TNG-User aktiviert den Pin zu Ziffer 3 (Ort), so dass für alle Ereigniss-Orte (Geburtsort, Taufort, Heiratsort, Sterbeort, Begräbnisort usw.) gelbe Pins auf der GoogleMaps erscheinen.



Man kann diese Farbzuteilungen nun für die eigenen Zwecke abändern, und zwar z.B.
1. Rot = Geburtsort
2. Braun = Taufort
3. Gelb = Trauort (Kirche bzw. Standesamt)
4. Grün = Scheidungsort (Amtsgericht)
5. Blau = Sterbeort
6. Lila = Begräbnisort
7. Rosa = Nicht festgelegt (z.B. für alle anderen Ereignisorte wie z.B. Urlaubsort, Berufsort; Studienort, Wohnorte usw.)



Diese Änderungen nimmt man in der Datei "alltext.php" vor, die sich in jedem Sprachordner (German; English; French; Spanish usw) befindet.
Dazu öffnet man diese Datei mit einem Texteditor (z.B.notepad.exe), sucht den Bereich
//For Google maps use - admin and public pages
$admtext[placelevel] = "Ortsebene";
$admtext[level1] = "Adresse";
$admtext[level2] = "Ortsteil";
$admtext[level3] = "Ort";
$admtext[level4] = "Region";
$admtext[level5] = "(Bundes-)Staat/-Land";
$admtext[level6] = "Land";
$admtext[level0] = "Nicht festgelegt";

und ändert die jeweiligen Begriffe entsprechend.
Dann speichern.
Dann F5-Taste auf der PC-Tastatur drücken.
Fertig.

Statt der Änderungen in der Datei "alltext.php" sollte man den Code in die Datei "cust_text.php" eines jeden Sprachordners (z.B. English; French; German; Spanish usw.) kopieren, da diese Datei bei einem TNG-Update nicht "überschrieben" wird.

Hinweis:
Man muß das in allen Sprachordnern, die man für seine TNG-Anwendung vorgesehen hat, in der zugehörigen "alltext.php"-Datei ändern bzw. in die Datei "cust_text.php" kopieren, und zwar mit der für jeden Begriff entsprechenden Übersetzung. Wenn man das nicht macht, wird ein Ausländer, der die TNG-Anwendung aufruft und seine Sprache einstellt, die deutschen Begriffe lesen :-( - - peinlich.

1.3 Änderung der Pin-Farben
Man kann die Farben der Pins ändern.
Das bewerkstelligt man in der Datei mapconfig.php (im TNG-Rootverzeichnis).
Vorgegeben sind dort 7 Farben (die Zahlen entsprechen der Grafikbezeichnung - z.B. 155 = "155.png")

$pinplacelevel0 = "006";
$pinplacelevel1 = "009";
$pinplacelevel2 = "023";
$pinplacelevel3 = "038";
$pinplacelevel4 = "074";
$pinplacelevel5 = "122";
$pinplacelevel6 = "155";

Man kann diese Farben ändern.
Dazu lädt man sich aus dem Downloadverzeichnis von TNG.
aus dem Bereich "TNG Extras" / "Google Maps Colored Pin Images" 216 Pin-Grafiken herunter.
Hinweis: Man erreicht dieses Verzeichnis allerdings nur mit Userwort und Passwort.

Unter diesen Grafiken befindet sich ganz am Schluß eine Datei ContactSheet.png, auf der man alle 216 Pin-Farben am Bildschirm betrachten kann.
Hat man eine passende Grafik-Farbe ausgewählt, zählt man vom Anfang der Auflistung bis zum Ort der ausgewählten (z.B. 113).
Diese Zahl entspricht derjenigen der Grafik (z.B. 113.png).
Diese Grafik wird nun in das Verzeichnis "googlemaps" des TNG-Verzeichnisses der eigenen TNG-Homepage kopiert.
Vorgenannte Prozedur macht man für 6 weitere Farben - soweit erwünscht.
Man kann natürlich auch alle 216 Grafiken in den "googlemaps"-Ordner kopieren - was jedoch unsinnig wäre.

Um die neuen Pin-Farben auf der Google Maps sichtbar zu machen, trägt man sie statt der vorgegebenen ein (siehe oben) und speichert die "mapconfig.php" ab.

Beim Start der TNG-Homepage bzw. nach Aufruf einer Person, werden nun die neuen PIN-Farben auf der Google Maps angezeigt (siehe Bild oben).

1.4 Weitere Pins hinzufügen
Betroffene Dateien :
1. mapconfig.php;
2. personlib.php;
3. getperson.php;
4. German/alltext.php (sowie weitere Sprachenordner, wie English; French; Spanish usw);
5. admin/editplace.php;
6. admin/updatemapconfig.php;
7. admin/newplace.php .

Man kann für eine Google Maps weitere Pins (als die vorhandenen 7) einfügen, um weitere Ereignisse mit unterschiedlichen Farben darzustellen.

Nachfolgend wird aufgezeigt, wie man weitere 4 Pins einfügen und mit entsprechenden Farben belegen kann.

Als erstes wird die Datei "German/alltext.php" mit einem Texteditor (z.B.notepad.exe) oder einem HTML-Editor geöffnet.
Dort sucht man den Bereich
//For Google maps use - admin and public pages (in einem HTML-Editor ist das die Zeile 67).
Dort fügt man nach der Zeile $admtext[level6] = "Beerdigt"; weitere 4 solcher Zeilen durch kopieren ein und ändert jeweils die Ziffer in 7; 8; 9; 10, sowie die jeweilige Bedeutung (z.B. Wohnung; Arbeit/Beruf, Schule, Urlaub).
Vorgenannte Prozedur muß man dann auch in den anderen Sprachordnern (English; French; Spanish usw) durchführen. Die Texte müssen notwendigerweise in die jeweilige Sprache übersetzt werden.

Dann wird die Datei "mapconfig.php" (im TNG-Rootverzeichnis) mit einem Texteditor/HTML-Editor geöffnet und hinter dem Eintrag
$pinplacelevel6 = "211";
- weitere 4 Einträge dieser Bezeichnung hinein kopiert.
Die Ziffern dieser neuen Einträge werden geändert in 7; 8; 9 und 10.
Die Farbbezeichnung (hier "211") wird bei allen 4 Neueinträgen ebenfalls nach den eigenen Wünschen geändert (siehe Liste der Pins aus unter Punkt 1.3).

Nun wird die Datei "admin/editplace.php" mit einem Texteditor oder einem HTML-Editor geöffnet.
Dort sucht man den Eintrag
for($i = 1; $i < 7; $i++)
(steht im HTML-Editor bei Zeile 105) und ändert die Ziffer 7 in 11 ab und speichert die Datei.
Durch diese Änderung werden im Verwaltungsteil (Admin) bei "Orte bearbeiten ' Ortsebene:" die 4 neuen Einträge angezeigt.

Als Nächstes wird die Datei "getperson.php" mit einem Texteditor oder einem HTML-Editor geöffnet.
Dort sucht man ebenfalls den Eintrag
for($i = 1; $i < 7; $i++)
(steht im HTML-Editor bei Zeile 497) und ändert die Ziffer 7 in 11 ab und speichert die Datei.

Als Nächstes wird die Datei "admin/newplace.php" mit einem Texteditor oder einem HTML-Editor geöffnet.
Dort sucht man ebenfalls den Eintrag
for($i = 1; $i < 7; $i++)
(steht im HTML-Editor bei Zeile 107) und ändert die Ziffer 7 in 11 ab und speichert die Datei.

Nun muß noch in der Datei "admin/updatemapconfig.php" eine Änderung vorgenommen werden.
Man öffnet diese Datei mit einem Text- bzw. HTML-Editor und sucht die Stelle
fwrite( $fp, "\$pinplacelevel6 = \"$pinplacelevel6\";\n" );
bzw. im HTML-Editor die Zeile 44.

Hinter dieser Zeile werden 4 gleiche Zeilen mit vorgenanntem Code hinein kopiert und die Ziffern "6" dort in die Ziffern "7"; "8"; "9" oder "10" geändert.
Dann speichern.

Als Letztes müssen nun noch in der Datei "personlib.php" (im TNG-Rootverzeichnis) Ergänzungen durchgeführt werden.
Man öffnet diese Datei mit einem Texteditor oder HTML-Editor.
Dort sucht man die Stelle
if( $map[key] && $data[place] )
bzw. geht im HTML-Editor zur Zeile 338.
Dort fügt man durch kopieren hinter dem Eintrag
$pinplacelevel6;
vier weitere dieser Einträge ein und ändert bei ihnen die Ziffer "6" in die Ziffern "7"; "8"; "9" und "10".
Dann speichern.
Durch diese Ergänzung werden auf der Google Map und rechts daneben in der Auflistung der Ereignisse die richtigen Pins mit den entsprechenden Farben angezeigt.

Hinweis:
Möglicherweise muß von Fall zu Fall im Verwaltungsteil (Admin) unter "Orte ' Verwalten ' Ort bearbeiten ' Ortsebene" dem jeweiligen Ort eine andere Ebene zugewiesen werden, da andernfalls eine falsche Pinfarbe zu sehen sein wird.

Diese Änderungen wurden vom TNG-Entwickler, Darrin Lythgoe, mitgeteilt.

1.5 Übersetzungen in andere Sprachen
Betroffene Dateien :
- - English/alltext.php;
- - French/alltext.php;
- - Spanish/alltext.php;

Wenn man Änderungen an den Einstellungen von Google Maps sowie die Änderung der Anzahl der Pins vornimmt, muß man daran denken, auch die Bezeichnungen für die einzelnen Pins in den anderen Sprachordnern zu ändern sowie in die anderen Sprachen zu übersetzen.
Macht man das nicht, erscheinen bei den anderen Sprachen die bisherigen Ereignis-Begriffe (Ortsebenen) sowie bei den neu hinzugekommenen Pins keine Bezeichnungen.

Die Änderungen / Ergänzungen werden in folgenden Dateien wie folgt vorgenommen :
Man öffnet die Datei alltext.php eines jeden Sprachordners (English; French; Spanish) mit einem Texteditor oder einem HTML-Editor.
Im Texteditor sucht man die Stelle
//For Google maps use - admin and public pages;
im HTML-Editor ist das die Zeile Nr 67.
Dann fügt man dort jeweils statt des dort bestehenden Codes folgenden Code ein .

Englisch
English/alltext.php

$admtext[placelevel] = "Place Level";
$admtext[level1] = "Birth";
$admtext[level2] = "Baptism";
$admtext[level3] = "Marriage";
$admtext[level4] = "Divorce";
$admtext[level5] = "Died";
$admtext[level6] = "Burial";
$admtext[level7] = "Residence";
$admtext[level8] = "Profession";
$admtext[level9] = "School";
$admtext[level10] = "Holiday";
$admtext[level11] = "Not Set";

Französisch
French/alltext.php

$admtext[placelevel] = "La spécificité du lieu";
$admtext[level1] = "Naissance";
$admtext[level2] = "Baptême";
$admtext[level3] = "Mariage";
$admtext[level4] = "Divorce";
$admtext[level5] = "Décédé";
$admtext[level6] = "Enterrement";
$admtext[level7] = "Résidence";
$admtext[level8] = "Profession";
$admtext[level9] = "Ecole";
$admtext[level10] = "Vacances";
$admtext[level11] = "Est non réglé";

Spanisch
Spanish/alltext.php

$admtext[placelevel] = "Lugar Nivel";
$admtext[level1] = "Nacimiento";
$admtext[level2] = "Bautismo";
$admtext[level3] = "Matrimonios";
$admtext[level4] = "Divorcios";
$admtext[level5] = "Murió";
$admtext[level6] = "Entierro";
$admtext[level7] = "Residencia";
$admtext[level8] = "Profesión";
$admtext[level9] = "Escuela";
$admtext[level10] = "Permiso";
$admtext[level11] = "No configurado";

Für die weiteren 14 Sprachen, die für TNG zur Verfügung stehen, muß man es ebenso machen - wenn man sie denn in seiner TNG-Anwendung integrieren möchte.
Die Übersetzung der Begriffe muß man dann eben selbst organisieren.


2. Webserver    (beim Provider)
Auf dem Webserver kann man die in Ziffer 1. beschriebenen Prozeduren nicht direkt durchführen.

Die Änderungen / Ergänzungen werden mit Hilfe eines Texteditors an den jeweiligen Dateien auf dem heimischen PC durchgeführt.
Dann werden die so geänderten Dateien auf den Webhost "hochgeladen".
Auch hier wird dringend empfohlen, die betroffenen zu ändernden Dateien auf dem Webhost zuvor zu sichern oder wenigstens umzubenennen, damit dann, wenn etwas schieflaufen sollte, der vorherige Zustand wieder hergestellt werden kann.

Alle folgenden Schritte werden so durchgeführt, wie unter Ziffer 1. beschrieben.



Klick: zurück zu der Seite, von der Sie gekommen sind  zurück Klick: zurück zu Startseite Startseite  weiter Klick: zur nächsten Seite