Contao Community Documentation - Benutzerbeiträge [de]

OnePageWebsite

2014-03-13T15:13:27Z

Fall2out:

[[Category:Extensions]]

Modul zum Erstellen einer One-Page-Website

Verfasser: [[Benutzer:Simon Mertens|Simon Mertens (Fall2out)]] 21:35, 11. Mär. 2014

{{ExtInfo
| Dev=Tim Gatzky
| DevSite=http://www.tim-gatzky.de
| ExtVersion=2.0.0 stable
| Version=3.0.0 stable - 3.2.7 stable
| ERLink=https://contao.org/de/extension-list/view/OnePageWebsite.20000009.de.html
}}
[[Kategorie:Extensions]]
=Vorwort=
Vielen Dank an Tim Gatzky für die tolle Extension und Danke auch an ciaobello für seine Unterstützung!

=Forum=
Fragen zum OnePageWebsite Modul werden im Forum beantwortet: [https://community.contao.org/de/showthread.php?37832-OnePageWebsite-Eine-one-page-Website-Struktur-mit-der-Seitenstruktur-erstellen Forum - OnePageWebsite-Erweiterung]

=Installation=
Die Installation erfolgt normalweise über das Extension Repository im Backend der Contao Installation. 
Eine manuelle Installation ist möglich, dazu die ZIP-Datei [https://contao.org/de/extension-list/view/OnePageWebsite.20000009.de.html vom Extension Repository laden], entpacken und entsprechend übertragen. Sollten Probleme bei neueren Contao-Versionen auftreten, bitte die aktuellste Datei vom Github laden.

Bei der manuellen Installation wird ein Datenbank-Update via Contao-Installationstool (www.testseite.de/contao/install.php) benötigt.

=Einrichtung=
Die Extension funktioniert im Prinzip „nur“ wie eine normale Navigation, wie man sie in Contao kennt. Diese Navigation nutzt die Seitenstruktur quasi als Menüpunkte, welche dann untereinander angezeigt werden. Um die Extension zu benutzen, geht man nun wie folgt vor.

===Layouterstellung===
Man benötigt zunächst einmal ein ganz normales Layout. In diesem Fall heißt es „Standardlayout“ und hat drei eingebundene Module:
* '''Kopflayout - Kopfzeile'''
* '''Artikel - Hauptspalte'''
* '''Fußlayout - Fußzeile'''
Alle anderen Angaben kann man wie gewünscht anlegen. Dieses Layout ist für das komplette Aussehen der Website verantwortlich.

Danach benötigt man ein leeres Layout, welches hier als „One-Page-Seiten“ bezeichnet wird. Es hat nur ein eingebundenes Modul:
* '''Artikel - Hauptspalte'''
Dieses Layout ist für die Referenzseite und deren Unterseiten notwendig. Mehr dazu weiter unten.

===Seitenstruktur anlegen===
Als nächstes kommt die Seitenstruktur. Man legt die Seiten wie folgt an und weist die passenden Seitenlayouts zu:
*Contao Open Source CMS
** Startpunkt der Website ('''Standardlayout''')
*** Startseite ('''Standardlayout''')
*** One-Page-Website ('''One-Page-Seiten''') <- ''Das ist unsere Referenzseite!''
**** Home ('''One-Page-Seiten''')
**** Portfolio ('''One-Page-Seiten''')
**** Kunden ('''One-Page-Seiten''')
**** Kontakt ('''One-Page-Seiten''')
*** Impressum ('''Standardlayout''')

===Modulanpassungen===
Die One-Page-Website benötigt zwei grundsätzliche Module:
[[Datei:opw_module.png|Modulübersicht|frame|center]]

*Angezeigt wird nur, welche Einstellungen angepasst werden müssen.
[[Datei:opw_opw struktur.png|Normale Struktur|frame|center]]
[[Datei:opw_opw navi.png|Navigationsmenü|frame|center]]

Zuerst erstellt man das „One-Page-Website - Normale Struktur“-Modul. Dieses deklariert die o.g. Referenzseite (One-Page-Website). Das heißt im Klartext, alle Unterseiten der Referenzseite sind jetzt genau '''DIE''' Seiten, welche mit der Scrollanimation angefahren werden (sogenannte Ankerpunkte).

Das eigentliche Menü der Seite wird mit dem zweiten Modul erstellt. Dieses verweist einfach nur auf das zuvor erstellte „Normale Struktur“ Modul.

===Seitenstruktur anpassen===
So weit so gut. Die Seitenstruktur, insbesondere die Referenzseite, muss noch versteckt werden (siehe Bild).
[[Datei:opw_verstecken.png|Referenzseite verstecken|frame|center]]

Des Weiteren sollte man noch den automatisch angelegten Artikel der Referenzseite löschen, dies ist aber nicht zwingend notwendig. Die Seiten/Artikel Struktur sehen wie folgt aus:
[[Datei:opw_seitenstruktur.png|Seitenstruktur|frame|center]]

Nun wird noch das "Normale Struktur"-Modul in die „Startseite“ per Inhaltselement eingefügt. Dieses sorgt für die Zusammensetzung der One-Page-Website. Das Ganze sieht nun so aus:
[[Datei:opw_startseite.png|Startseite|frame|center]]

Dieses Modul verknüpft die Navigation und sämtliche Seite miteinander.

===Seitenlayout anpassen===
Jetzt wird die One-Page-Website-Navigation in das „Standardlayout“ eingebunden:
[[Datei:opw_moduleinbindung.png|Navigation|frame|center]]

Damit auch alles „Smooth“ läuft beim Scrollen, und die Navigation auch WIRKLICH läuft, muss MooTools geladen werden und folgende Templates aktivieren:
- moo_smoothScroll
- moo_onepagewebsitenavigation

Als Hilfe noch ein Bild:
[[Datei:opw_mootools.png|MooToolsaktivierung|frame|center]]

===Fast fertig===

Damit nun auch etwas zu sehen ist, sollten alle Unterseiten der Referenzseite mit Artikeln und Inhalten gefüllt werden.

=Optionale Anpassungen=
===One-Page-Seiten erweitern===
Benötigt man über oder unter jedem Artikel ein Modul oder Inhaltselement, so kann man das zuvor angelegte "leere Layout" mit weiteren Modulen und Artikeln befühlen. Hier eine kleine Grafik, um den Einsatz zu verdeutlichen.
[[Datei:opw_leereslayout.jpg|Schematische Darstellung|frame|center]]

===Normale Seiten hinzufügen===

Bis jetzt kann man innerhalb der One-Page-Struktur jede Seite ansteuern. In der aktuellen Konfiguration besteht das Problem, dass Seiten außerhalb der Referenzstruktur (z.B. Impressum) zwar erreichbar sind, von dieser aber nicht zurück zur One-Page-Stuktur leitet. Aus diesem Grund muss eine Weiterleitungsseite in dem Modul "Navigationsmenü" ausgewählt werden. In diesem Fall wird die "Startseite" ausgewählt.
[[Datei:opw_navimenue.png|Schematische Darstellung|frame|center]]

===Höhe der Kopfzeile ändern===

Wenn die Höhe der Kopfzeile verändert wird, muss auch der Offset-Wert der Scrollfunktion angepasst werden! Siehe hierzu moo_smoothScroll.html5 im /templates Ordner, Zeile 9 "var offsetY = 200;" wobei 200 der Höhe der Kopfzeile entspricht.

===URL an Seitenalias anpassen===

Wenn die URL und der Menüpunkt die selben Bezeichnungen haben soll, muss dies nach dieser Anleitung anpassen:
[https://community.contao.org/de/showthread.php?43606-OnePageWebsite-Kurzanleitung&p=281900&viewfull=1#post281900 URL/Alias Anpassung]

=Demo Zugang=
Hier verweise ich auf den Kommentar von ciaobello:

----

''Mein Workaround, den ich schnell getestet habe:''

* ''Tinoos Demo runterladen,''
* ''Contao 3.1.1 intallieren''
* ''OnePageWebsite Erweiterung installieren''
* ''BackupDB Installieren''
* ''Tinoos DB importieren (wenn die Erweiterungen installiert sind, geht der Import auch mit install.php)''
'''''Läuft.'''''

''Contao 3.2.7 ohne /files & /templates über das Contao 3.1.1 installieren. Nochmal Install.php aufrufen und zur Freude BackupDB aktualisieren (Github kennst ja jetzt auch, falls du OnePageWebsite noch aktualisieren willst).''
'''''Funktioniert.'''''

''Nun hast du eine lauffähige Demo, wo du nachgucken kannst!''

''Einloggen mit "webmaster" und "12345678" und herumprobieren und testen bis die Finger brennen.''

''Jetzt anhand der Demo herausfinden wie das Ganze funktioniert und ein '''tolles Wiki''' schreiben.''

2014-03-12T21:50:39Z

Fall2out:

[[Category:Extensions]]
{{stub}}
Modul zum Erstellen einer One-Page-Website

Verfasser: [[Benutzer:Simon Mertens|Simon Mertens (Fall2out)]] 21:35, 11. Mär. 2014

{{ExtInfo
| Dev=Tim Gatzky
| DevSite=http://www.tim-gatzky.de
| ExtVersion=2.0.0 stable
| Version=3.0.0 stable - 3.2.7 stable
| ERLink=https://contao.org/de/extension-list/view/OnePageWebsite.20000009.de.html
}}
[[Kategorie:Extensions]]
=Vorwort=
Vielen Dank an Tim Gatzky für die tolle Extension und Danke auch an ciaobello für seine Unterstützung!

=Forum=
Fragen zum OnePageWebsite Modul werden im Forum beantwortet: [https://community.contao.org/de/showthread.php?37832-OnePageWebsite-Eine-one-page-Website-Struktur-mit-der-Seitenstruktur-erstellen Forum - OnePageWebsite-Erweiterung]

=Installation=
Die Installation erfolgt normal über das Extension Repository im Backend der Contao Installation. 
Eine manuelle Installation ist möglich, dazu die ZIP Datei [https://contao.org/de/extension-list/view/OnePageWebsite.20000009.de.html vom Extension Repository laden], entpacken und entsprechend übertragen. Sollten Probleme bei neueren Contao-Versionen auftreten, bitte die aktuellste Datei vom Github laden.

Bei der manuellen Installation wird ein Datenbank-Update via Contao-Installationstool (www.testseite.de/contao/install.php) benötigt.

=Einrichtung=
Die Extension funktioniert im Prinzip „nur“ wie eine normale Navigation, wie man sie in Contao kennt. Diese Navigation nutzt die Seitenstruktur quasi als Menüpunkte, welche dann untereinander angezeigt werden. Um die Extension zu benutzen, geht man nun wie folgt vor.

===Layouterstellung===
Man benötigt zunächst einmal ein ganz normales Layout. In diesem Fall heißt es „Standardlayout“ und hat drei eingebundene Module:
'''Kopflayout - Kopfzeile
Artikel - Hauptspalte
Fußlayout - Fußzeile'''
Alle anderen Angaben kann man wie gewünscht anlegen. Dieses Layout fungiert natürlich für das komplette Aussehen der Website.

Danach benötigt man ein leeres Layout, welches hier „One-Page-Seiten“ benannt wird. Es hat nur ein eingebundenes Modul.
'''Artikel - Hauptspalte'''
Dieses Layout ist für die Referenzseite und deren Unterseiten. Mehr dazu weiter unten.

===Seitenstruktur anlegen===
Jetzt kommen die Seitenstruktur. Man legt die Seiten wie folgt an und weist die passenden Seitenlayouts zu:
*Contao Open Source CMS
** Startpunkt der Website ('''Standardlayout''')
*** Startseite ('''Standardlayout''')
*** One-Page-Website ('''One-Page-Seiten''') <- ''Das ist unsere Referenzseite!''
**** Home ('''One-Page-Seiten''')
**** Portfolio ('''One-Page-Seiten''')
**** Kunden ('''One-Page-Seiten''')
**** Kontakt ('''One-Page-Seiten''')
*** Impressum ('''Standardlayout''')

===Modulanpassungen===
Die OnePageWebsite benötigt zwei grundsätzliche Module:
[[Datei:opw_module.png|Modulübersicht|frame|center]]

*Angezeigt werden nur, welche Einstellungen angepasst werden müssen.
[[Datei:opw_opw struktur.png|Normale Struktur|frame|center]]
[[Datei:opw_opw navi.png|Navigationsmenü|frame|center]]

Zuerst erstellt man das „One-Page-Website - Normale Struktur“ Modul. Dieses deklariert die o.g. Referenzseite (One-Page-Website). Dies ist notwendig, damit die One-Page-Website seine Struktur kennt. Das heißt im Klartext, alle Unterseiten der Referenzseite sind jetzt genau '''DIE''' Seiten, welche mit der Scrollanimation angefahren werden (sogenannte Ankerpunkte).

Das eigentliche Menü der Seite, wird mit dem zweiten Modul erstellt. Das verweist einfach nur auf das zuvor erstellte „Normale Struktur“ Modul.

===Seitenstruktur anpassen===
So weit so gut. Die Seitenstruktur, insbesondere die Referenzseite, muss noch versteckt werden (siehe Bild).
[[Datei:opw_verstecken.png|Referenzseite verstecken|frame|center]]

Des weiteren sollte man noch den automatisch angelegten Artikel der Referenzseite löschen, dies ist zwar nicht zwingend notwendig, aber es ist eine saubere Lösung. Die Seiten/Artikel Struktur sehen wie folgt aus:
[[Datei:opw_seitenstruktur.png|Seitenstruktur|frame|center]]

Damit nun alles vernünftig in die Gänge gebracht wird, wird noch ein Modul in die „Startseite“ per Inhaltselement eingefügt. Das Ganze sieht nun so aus:
[[Datei:opw_startseite.png|Startseite|frame|center]]

Dieses Modul verknüpft die Navigation und sämtliche Seite miteinander.

===Seitenlayout anpassen===
Jetzt wird die One-Page-Website-Navigation in das „Standardlayout“ eingebunden:
[[Datei:opw_moduleinbindung.png|Navigation|frame|center]]

Damit auch alles „Smooth“ läuft beim Scrollen, und die Navigation auch WIRKLICH läuft, muss man MooTools laden und folgende Templates aktivieren:
- moo_smoothScroll
- moo_onepagewebsitenavigation

Als Hilfe noch ein Bild:
[[Datei:opw_mootools.png|MooToolsaktivierung|frame|center]]

===Fast fertig===

Damit nun auch etwas zu sehen ist, sollten alle Unterseiten der Referenzseite mit Artikeln und Inhalten gefüllt werden.

=Optionale Anpassungen=
===One-Page-Seiten erweitern===
Benötigt man über oder unter jedem Artikel ein Modul oder Inhaltselement, so kann man das zuvor angelegte "leere Layout" mit weiteren Modulen und Artikeln befühlen. Hier eine kleine Grafik, um den Einsatz zu verdeutlichen.
[[Datei:opw_leereslayout.jpg|Schematische Darstellung|frame|center]]

===Normale Seiten hinzufügen===

Bis jetzt kann man innerhalb der One-Page-Struktur jede Seite ansteuern, nur gibt es auch Seiten, welche nicht als Menüpunkt angezeigt werden sollen.

=Demo Zugang=
Hier verweise ich auf den Kommentar von ciaobello:

Mein Workaround den ich schnell getestet habe:

Tinoos Demo runterladen,

Contao 3.1.1 intallieren

OnePageWebsite Erweiterung installieren
BackupDB Installieren

Tinoos DB importieren (wenn die Erweiterungen installiert sind, geht der Import auch mit install.php)

Läuft.

Contao 3.2.7 ohne /files & /templates über das Contao 3.1.1 installieren. Noch mal Install.php aufrufen und zur Freude BackupDB aktualisieren (Github kennst ja jetzt auch falls OnePageWebsite noch aktualisieren willst).

Funktioniert.
Nun hast eine lauffähige Demo wo Du nachgucken kannst!

Einloggen mit webmaster 12345678 und rumprobieren und testen bis die Finger brennen.

Jetzt anhand der Demo herausfinden wie das ganze funktioniert und ein tolles Wiki schreiben.

=Anmerkung=

Der Wikieintrag ist noch nicht komplett fertig, also habt bitte Verständnis mit Rechtschreibfehlern und der Ausdrucksweise :-) Schließlich ist dies mein erster Wikieintrag. Jetzt wird noch alles getestet und korrekturgelesen.

2014-03-11T20:18:43Z

Fall2out: