Quelltext der Seite Sitemap erstellen

Diese Anleitung befasst sich mit der Erstellung einer Sitemap in einer Contao-Installation. Auf die Formatierung der erstellten Sitemap wird bewusst verzichtet. Voraussetzung für dise Anleitung ist eine vorhandene [[Seitenstruktur]], eine [[ModulNavigation|Navigation]] und dass mehrere Seiten existieren. Für diese Anleitung bedarf es Zugang als Administrator zu der entsprechenden Contao-Installation. Zur besseren Nachvollziehbarkeit wird in dieser Anleitung mit der Beispiel-Website ''MusicAcademy'' gearbeitet.

=Sitemap-Modul hinzufügen=
Als erster Schritt muss ein Modul ''Sitemap'' erstellt werden. Dazu geht man im Backend unter ''Layout'' auf ''Themes'' (siehe auch [[Aktionsbereiche]]) und wechselt im Theme ''MusicAcademy'' in den Module-Manager.

[[Datei:sitemap_modulemanager.png|Modulemanager]]

Ein Klick auf den Button ''Neues Modul'' öffnet den bekannten Bearbeitungsbereich mit seinen Eingabefeldern und Drop-down-Auswahlmenus.

[[Datei:sitemap_newmodule.png|Neues Modul anlegen]]

Unter ''Titel'' gibt man einen sprechenden Namen ein, z.B. ''Sitemap''. Aus dem Drop-down-Menu ''Modultyp'' wählt man als nächstes aus dem Bereich ''Navigation'' das Modul ''Sitemap''. Etwas Geduld und der Bearbeitungsbereich wird gemäß der Auswahl angepasst. Wenn man will, kann man im Eingabefeld ''Überschrift'' eine Überschrift eingeben, die dann in der Seite über der Sitemap angezeigt wird; diese Eingabe ist optional.

[[Datei:sitemap_modulesettings-1.png|Modul Einstellungen 1]]

Das Auswahlfeld ''Wurzelseite als Startseite'' wählt man aus, wenn die Sitemap für die gesamte Seite gelten soll. Diese Eingabe ist erforderlich, wenn man nicht eine andere Seite als Startpunkt für die Sitemap wünscht.

Referenzseite:
Sofern man nur für einen Teil der Website die Sitemap will, klickt man hier ''Auswahl ändern'' und wählt aus der sich öffnenden Liste mit der Seitenstruktur die Startseite der Sitemap als Referenzseite aus. Diese Eingaben sind nur erforderlich, wenn man anstelle der Wurzelseite eine andere Seite als Startpunkt für die Sitemap wünscht. Für diese Anleitung wird diese Möglichkeit gewählt.

[[Datei:sitemap_modulesettings-2.png|Modul Einstellungen 2]]

Die weiteren Auswahl- und Eingabefelder sind selbsterklärend. Für die erste Sitemap sind nun alle erforderlichen Eingaben gemacht. Man beendet die Eingaben nun durch einen Klick auf ''Speichern und schließen''. Die Liste der Module ist nun um einen Eintrag mit der ''Sitemap'' reicher.

=Seitenstruktur erweitern=
Als nächstes erweitert man die Struktur der Site. Man wählt dazu aus dem Layout-Bereich den Punkt ''Seitenstruktur'' und fügt dann über ''Neue Seite'' eine neue Seite in die Struktur der Website ein. In diesem Fall soll die neue Seite in der Hauptebene unterhalb der Seite ''Services'' angezeigt werden. 

[[Datei:sitemap_sitestructure.png|Seitenstruktur]]

Es öffnet sich der Bearbeitungsbereich zur Definition der neuen Seite. Folgende Eingaben sind zwingend/mindestens zu machen:

Eingabefeld ''Seitenname'': Hier definiert man, wie die Seite im Navigationsmenü erscheinen soll. Sinnigerweise benennt man die neue Seite ''Sitemap''.<br />
Eingabefeld ''Seitenalias'': Als eindeutige Referenz zur Umschreibung der ID in der URL zum Seitenaufruf definiert man hier z.B. ''sitemap''.<br />
Den Seitentyp belässt man bei ''Reguläre Seite''.

[[Datei:sitemap_sitesettings-1.png|Einstellungen der neuen Seite 1]]

Wichtig ist das Häkchen bei dem Auswahlfeld ''Veröffentlicht'', damit die Seite später auch angezeigt werden kann. Alle anderen Eingabefelder sind selbsterklärend und für die grundsätzliche Funktion nicht zwingend notwendig, weshalb sie hier nicht weiter besprochen werden sollen. Die Eingabe schließt man nun mit einem Klick auf "Speichern und schließen" ab.

[[Datei:sitemap_sitesettings-2.png|Einstellungen der neuen Seite 2]]

=Neuen Artikel erstellen=
Bisher hat man nur das Modul ''Sitemap'' in der Site verfügbar gemacht und der Struktur einen Navigationseintrag ''Sitemap'' zugefügt. Man hat aber noch keinen Inhalt definiert, der die Sitemap später anzeigt. Das macht man im folgenden Schritt!

Man wählt aus den Backend-Modulen im Inhaltsmodul den Eintrag ''Artikel''. Es öffnet sich die Liste der bereits erstellten Seiten und Artikel. Seit Contao 2.9 wird, sobald man eine neue Seite anlegt, ein dazu gehöriger Artikel angelegt. Dieser muss nun bearbeitet werden. Dazu klickt man mit der rechten Maustaste auf das Bearbeiten-Symbol (Bleistift) des entsprechenden Artikels und im sich öffnenden Popup wählt man ''Artikel-Einstellungen bearbeiten''.

[[Datei:sitemap_article.png|Artikel bearbeiten]]

Für den Artikel definiert man die folgenden Einträge in dem sich öffnenden Arbeitsbereich:

Eingabefeld ''Titel'': Man wählt z.B. ''Sitemap'' als Titel des Artikels.<br />
Eingabefeld ''Artikelalias'': Hier schreibt man z.B. 'sitemap'<br />
Außerdem muss man die Option ''Veröffentlicht'' wählen, damit die Sitemap später angezeigt werden kann. Auch diese Eingaben schließt man mit ''Speichern und schließen'' wie gewohnt ab.

[[Datei:sitemap_articlesetting.png|Artikel Einstellungen]]

=Sitemap einbinden=
Wenn man sich das bisher Erstellte in der Frontend-Vorschau anschaut, so gibt es einen Navigationsmenüeintrag und eine Seite mit der Sitemap. Leider noch ohne Sitemap! Als nächstes bindet man nun das Sitemap-Modul in die Seite ein, damit das Modul beim Seitenaufruf die gewünschten Inhalte generieren kann.

So wie vorhin klickt man mit der rechten Maustaste auf das Bearbeiten-Symbol; nur wählt man jetzt ''Artikel bearbeiten''. Es öffnet sich der Bearbeitungsbereich für den Artikel. Mit einen Klick auf ''Neues Element'' und anschließend das Pfeil-Symbol, um das neue Element zu positionieren, wird das Element am Seitenanfang des Artikels eingefügt.

[[Datei:sitemap_articleedit.png|Artikel Element einfügen]]

Es öffnet sich der Bearbeitungsbereich, in dem folgende Eingaben zu machen sind:

Dropdown-Auswahl ''Elementtyp'': Hierüber erstellt man jetzt die Verbindung zur Sitemap. Dazu wählt man am Ende der Liste aus den Include-Elementen den Eintrag ''Modul''. Der geänderte Bearbeitungsbereich zeigt nun eine Liste aller Module in der Webseite. Hier wählt man das Modul ''Sitemap''. Die Eingabe schließt man mit "Speichern und schließen" ab.

[[Datei:sitemap_cesetting.png|Content Element Einstellungen]]

Der Artikel ist nun um einen Moduleintrag erweitert, der als Inhalt eine Zeile mit dem Text: '### SITEMAP ###' enthält.

[[Datei:sitemap_articlecontent.png|Artikel Inhalt]]

=Die fertige Sitemap=
Die fertige Sitemap kann man nun in der Frontend-Vorschau betrachten.

[[Datei:sitemap_frontend.png|Fertige Sitemap im Frontend]]