Erste Schritte

Nach der erfolgreichen Installation von Leaflet für Contao erscheint im Contao Backend in der linken Navigationssidebar ein zusätzlicher Bereich Leaflet.

Um die erste Karte zu konfigurieren sind folgende Schritte zu empfehlen:

1. Kachel-Layer definieren

Bevor die erste Karte definiert wird, ist es empfehlenswert die Layer zu definieren, da Layer separat von den Karten angelegt und in der Karte nur referenziert werden.

Die Kachel-Layer generieren die Karte selbst. Wie Leaflet ist der Anwender hier vollkommen frei eigene Kartenanbieter zu integrieren. Um nicht für jeden Anbieter eine manuelle Konfiguration vorzunehmen, unterstützt die Erweiterung mit dem Layertyp Vorkonfigurierte Karte alle Karten die von dem Plugin `Leaflet Providers`_ angeboten werden.

Als Karten-Layer legen wir daher nun ein Layer vom Typ Vorkonfigurierte Karte aus und wählen als Kartenanbieter OpenStreetMap aus und aktivieren das Layer.

2. Marker-Layer definieren

Alle Daten werden bei Leaflet für Contao unter Layern verwaltet. Bevor die Marker selbst angelegt werden können, muss deshalb ein Layer vom Typ Marker angelegt werden. Neben der Angabe des Titels ist es erfoderlich den Layer unter Aktivierung zu aktivieren.

Schließt man nun die Bearbeitungsmaske erscheint in der Layeransicht ein Bleistift. In der von Contao gewohnen Struktur (z.B. Inhaltselemente von Artikeln) können nun die Marker angelegt werden. Einzugeben sind die Werte für Title und Koordinaten. Wie bereits bei den Layern ist außerdem das Aktivieren erforderlich.

Statt der manuellen Eingabe der Koordinaten (Kommasepararierte Werte für latitute,longitude[,altidute]), kann auf das Karten-Widget zur Geokodierung einer eingebenen Adresse verwendet werden.

3. Karte anlegen

Nun ist alles vorbereitet um die erste Karte zu erstellen. Im Modul Leaflet-Karten kann nun eine neue Karte angelegt werden. [TODO]