Typo3 GeocoderPlugin

Allgemein

Sie haben mit dem atlasFX Typo3 GeocodingPlugin die Möglichkeit, Ihren Nutzern die Berechnung der Koordinaten aus einer Adresse zur Verfügung zu stellen. Diese Funktionalität können Sie grafisch lückenlos in Ihre bestehende Typo3 Webseite integrieren.

Die Verwendung des atlasFX Typo3 GeocodingPlugins erfordert eine erweiterte Lizenzierung.
Bitte kontaktieren Sie uns unter sales@alta4.com oder telefonisch über +49(0)651.96626-29.
Wir beantworten gerne Ihre Fragen.

Konfigurationsanleitung

Einbettung und Konfiguration

Das Geocoding Plugin ist nicht in Kombination mit dem Proximity Plugin nutzbar (gemeinsam auf einer Typo3 Inhaltseite).

Einbettung

  1. Loggen Sie sich im Typo3 Backend ein.

  2. Im Bereich „Web“ wählen Sie den Punkt „Seite“ und navigieren Sie zur Position, wo Sie bereits ein atlasFX Kartenplugin und ein Eingabeformular eingebettet haben.

  3. Wählen Sie in der jeweiligen Spalte „Neuen Datensatz... hinzufügen“ (gekennzeichnet durch Plus Buttons)

  4. Hier wählen Sie bitte im Tab „Plug-Ins“ den Punkt „atlasFX Geocoder“.

  5. Speichern sie das Plugin einmal, damit alle Optionen sichtbar werden.

  6. Konfigurieren Sie das Plugin wie im anschließenden Abschnitt beschrieben.

  7. Schließen Sie den Vorgang ab, indem Sie auf Speichern klicken.

Konfiguration

  1. Sobald Sie das Plugin erstellt haben oder zum Bearbeiten geöffnet haben, erscheint ein Tab „Plug-In“ für die Konfiguration des Plugins.

  2. Hier können Sie diverse Einstellungen vornehmen, die in den nächsten Abschnitten beschrieben werden.

  3. Schließen Sie den Vorgang ab, indem Sie auf Speichern klicken.

Allgemeine Einstellungen

Name

Beschreibung

WKID des Koordinatensystems der gespeicherten Punkte

Hier können Sie das Koordinatensystem bestimmen, in dem Punkte gespeichert werden.

Modus wählen

  • Automatisch:
    Dies ist die schnellste Möglichkeit den Geocoder einzusetzen. Hier muss lediglich angegeben werden, welche Formularelemente genutzt werden sollen.

  • Manuell:
    Dies ermöglicht die Nutzung von Javascript, sollte der automatische Modus für den gewünschten Zweck nicht ausreichen. Hierfür sollte ein Webentwickler zu Rate gezogen werden.

Nach dem Ändern dieser Einstellung wird die Seite neu geladen und andere Optionen angezeigt.

Einstellungen für den automatischen Modus

Um Input-Felder eindeutig identifizieren zu können werden CSS3 Selektoren verwendet.
Siehe auch dojo/query (Version 1.9): http://dojotoolkit.org/reference-guide/1.9/dojo/query.html
Sollten Sie sich mit CSS Selektoren nicht auskennen, empfehlen wir einen Webentwickler zu Rate zu ziehen.

Name

Beschreibung

CSS Selektor des Quell Input-Feldes "..."

Mit diesen Feldern werden im genutzten Formular Eingabefelder identifiziert. Sie werden nur gelesen, niemals verändert.

CSS Selektor des Ziel Input-Feldes "..-Koordinate"

Mit diesen Feldern werden im genutzten Formular Eingabefelder für die Punktkoordinaten identifiziert. Diese werden beim Start des Plugins ausgelesen um die Startposition in der Karte zu markieren. Sind sie nicht gesetzt, so wird der Kartenausschnitt nicht verändert.

Diese Eingabefelder werden im genutzten Formular automatisch angepasst, sobald der User den Punkt manuell verschiebt oder über die Geocoding Funktionalität eine Adresse zu einem Punkt wandelt.

CSS Selektor des Buttons "Punkt aus Addresse bestimmen"

Dies Feld wird genutzt um im genutzten Formular einen vorhandenen Geocoder Button zu verwenden oder um einen neuen einzubetten, je nachdem was in der folgenden Einstellung gewählt wurde. Dabei muss dieser Selektor auf ein vorhandenes HTML Element zeigen.

Button automatisch einfügen (sofern kein Button vorhanden ist)

  • Deaktiviert:
    Es wird ein vorhandener Button verwendet (es kann sich auch um ein anderes klickbares HTML Element handeln)

  • Vor/Nach dem selektierten Element:
    Ein Button wird vor/nach dem gewählten Element eingefügt.

  • Anstelle des selektierten Elementes:
    Das gewählte Element wird durch einen Button ersetzt.

  • Am Anfang/Ende des selektierten Elementes:
    Ein Button wird als Kind des gewählten Elementes eingefügt. Jeweils an den Anfang oder das Ende der Kinderliste.

Einstellungen für den manuellen Modus

Der manuelle Modus hat lediglich zwei Eingabefelder für Javascript Code.

Punktkoordinaten werden in den Beispielen im konfigurierten Koordinatensystem behandelt (Methoden mit dem Wort „Foreign“). Man könnte aber auch die selben Methoden mit dem Wort „Local“ ersetzen und würde dann im Koordinatensystem der Karte arbeiten.

Name

Beispiel

Beschreibung

Startup Code

// Punkt aus vorhandenen Daten (z.B. beim Editieren):
var x = dojo.byId('x_coordinate').value;
var y = dojo.byId('y_coordinate').value;
if(x && x !== '' && y && y !== '') {
geocoder.setFromPointForeign(parseFloat(x), parseFloat(y));
}
 
// Geocoder Button initialisieren
var button = dojo.byId('geocode');
dojo.connect(button, 'click', function() {
var street = dojo.byId('street').value;
var houseNo = dojo.byId('houseNo').value;
var postcode = dojo.byId('postcode').value;
var city = dojo.byId('city').value;
geocoder.setFromAdress(button, street, houseNo, postcode, city);
});

Startup Code wird beim Start des Plugins zur Initialisierung einmalig ausgeführt.

Das Beispiel zeigt, wie x/y Koordinaten aus einem Formular ausgelesen werden können um den Startpunkt zu setzen, als auch wie ein Button mit dem Geocoder verbunden wird.

Update Code

var point = geocoder.getPointForeign();
dojo.byId('x_coordinate').value = point.x;
dojo.byId('y_coordinate').value = point.y;

Update Code wird aufgerufen, sobald sich der Punkt in der Karte ändert. Z.B. durch manuelles verschieben oder durch Punktfindung via Adresse. Das Beispiel zeigt, wie man die Punktkoordinate erhalten kann.

Das geocoder Objekt

Dies ist nur im Manuellen Modus zu beachten.

Folgende Methoden stellt das geocoder Objekt zur Verfügung:

Name

Parameter

Rückgabetyp

Beschreibung

setFromAdress

  • around: HTMLElement

  • street: string

  • houseNo: string

  • postcode: string

  • city: string

 

Das Element around wird benutzt um den Auswahldialog zu positionieren. Die folgenden Parameter sind selbsterklärend

setFromPointForeign

  • x: number

  • y: number

 

Setzt den Punkt an die übergebene Position, welche im konfiguriertem Koordinatensystem sein muss.

getPointForeign

 

Map ( {x: .., y: ...} )

Liefert ein Koordinatenobjekt im konfigurierten Koordinatensystem.

setFromPointLocal

  • x: number

  • y: number

 

Setzt den Punkt an die übergebene Position, welche im Koordinatensystem der Karte sein muss.

getPointLocal

 

Map ( {x: .., y: ...} )

Liefert ein Koordinatenobjekt im Koordinatensystem der Karte.

Changelog

Version 1.1.8 (06.Dez.2016)

  • Unterstützung von Typo 3 v7.x

  • Bugfixing zum manuellen Modus

  • Technologieupgrade

  • Einstellung des Supports für Typo3 v. 4.5

Version 1.1.7 (10. Feb. 2016)

  • Bugfix in der Buttonkonfiguration

Version 1.1.6 (13. Okt. 2015)

  • Weitere Anpassungen für HTTPS Webseiten

Version 1.1.5 (28. Sept. 2015)

  • Fix für HTTPS Webseiten

Version 1.1.4 (12. August 2015)

  • Plugin-Version wird nun beim Plugin-bearbeiten angezeigt.

  • Plugin-Name wurde in nicht-englischen Sprachen nicht angezeigt.