Contao Community Documentation - Benutzerbeiträge [de]

Ordner und Dateien in Contao 4

2017-10-19T17:56:40Z

Do while: /* web/app_dev.php Zugang einrichten */

{{AppliesTo
|Version=Contao 4 latest managed edition}}

{{stub}}

[[Category:Admin HOWTOS]]

Hier sollen die Ordner und Dateien von Contao 4 dokumentiert werden, welche zum Verständnis und zur Anpassung des Systems relevant sind.

In Contao 3 waren dies:
<pre>
.htaccess
files/
system/
config/
dcaconfig.php
initconfig.php
langconfig.php
localconfig.php
modules/
templates/
</pre>

'''Legende''':
<pre>
Anwendung: Contao (Contao ist eine Symfony Anwendung). Hiermit ist die komplette Installation gemeint.
BE: Backend
FE: Frontend
</pre>

==.htaccess==
Die Datei ist leer. Hier kann ein Passwortschutz aufgesetzt werden.

==composer.json==

==composer.lock==

==app/==

===app/config/===

====app/config/parameters.yml====

Konfigurationsparameter der Anwendung, dies sind u.a. Datenbank-Zugangsdaten usw.

====app/config/config.yml====

Gemeinsame Konfigurationsdatei der Website, hier werden alle "services" konfiguriert.

Die Parameter aus "parameters.yml" werden hier oftmals verwendet (z.B. in `secret: "%secret%"`, welches den Parameter "secret" aus "parameters.yml" hier einträgt).

====app/config/config_dev.yml====

Konfigurationsdatei für das Entwicklungs-Environment (siehe auch [[Ordner und Dateien in Contao 4#web.2Fapp_dev.php|web/app_dev.php]])

====app/config/config_prod.yml====

Konfigurationsdatei für das Produktiv-Environment (siehe auch [[Ordner und Dateien in Contao 4#web.2Fapp.php|web/app.php]])

===app/Resources/===

Alle Anwendungsressourcen werden hier abgelegt, dies sind u.a. twig Templates.

====app/Resources/contao/====

=====app/Resources/contao/config/=====

Alle Contao relevanten Konfigurationen landen hier, dies sind lokale Anpassungen.

=====app/Resources/contao/dca/=====

Hier abgelegte Dinge ersetzen die aus Contao 3.5 bekannten dca-Dateien einer "z_custom" extension und system/config/dcaconfig.php

=====app/Resources/contao/languages/=====

Hier abgelegte Dinge ersetzen die aus Contao 3.5 bekannten languages einer "z_custom" extension und system/config/langconfig.php

==contao-manager/==

Konfigurations-Verzeichnis des Contao Managers.

===contao-manager/cache/===

Cache-Verzeichnis des Contao Managers.

===contao-manager/logs/===

Log-Verzeichnis des Contao Managers.

==system/==

DEPRECATED - hier sollte man nichts rein tun.

Der Contao-Manager legt hier Legacy-Erweiterungen ab, damit diese im Contao 3.5 Modus in Contao 4 lauffähig gemacht werden.
Diese Verzeichnisse werden außerdem nach web/system symlinked, damit die assets derselbigen Module lauffähig sind.

===system/config/===

====system/config/initconfig.php====

DEPRECATED - wie in Contao 3.5 kommt hier Initialisierungscode rein, welchen Contao beim "Start" ausführen soll.

Sollte man nicht mehr verwenden, lieber ein app-bundle bauen und saubere services.

====system/config/localconfig.php====

Konfigurationsdatei für Einstellungen, welche noch nicht im Manager bzw. parameters.yml sind.

Entspricht der Konfigurationsmaske im Backend (System/Einstellungen).

AN ENTWICKLER: Bitte nichts mehr in dca/tl_settings.php und localconfig.php hinzufügen. Eigene Dinge mittelfristig hieraus auch wieder entfernen. Verwendet stattdessen bundle-Konfigurationsparameter.

==files/==
Dateien, welche auf der Website veröffentlicht werden. jpg, png, pdf, mp3, mp4, css, js usw.

Unterordner müssen über die Dateiverwaltung explizit freigegeben werden.

==templates/==
Eigene Templates für die FE-Ausgabe.

==var/==
Ablageverzeichnis der Anwendung für u.a. cache, logs etc.

===var/cache/===

====var/cache/prod/====
Dies ist der Ordner, den man löschen soll, wenn man aufgefordert wird, manuell den Cache zu löschen. Anschließend soll man das Installtool aufrufen.

==vendor/==

Composer Bibliotheksverzeichnis - hier wird der Code von Erweiterungen und Bundles abgelegt.

==web/==
Auf diesen Ordner muss die Domain geroutet werden.

===web/.htaccess===

Apache Konfiguration um u.a. auf app.php zu redirecten.

===web/app.php===

Produktiver entrypoint der Anwendung aus dem Web. Entspricht in etwa "index.php" in Contao 3.5.

===web/app_dev.php===

Entwicklungs entrypoint der Anwendung aus dem Web. Entspricht in etwa "index.php" mit aktiviertem Debug Modus in Contao 3.5. 
Um über app_dev aufrufen zu können muss die Zugangskontrolle eingerichtet werden (nicht bei localhost): 
siehe https://contao.ninja/contao-4-login-fuer-app_dev-php-setzen.html

===web/bundles/===

Hier werden alle assets von Bundles hineingelinkt um diese via web erreichbar zu machen.

===web/system/===

Siehe "system", hier werden assets von legacy Erweiterungen hin-gelinkt.

--[[Benutzer:Andreas|Andreas Burg]] ([[Benutzer Diskussion:Andreas|Diskussion]]) 18:19, 18. Okt. 2017 (CEST)

--[[Benutzer:Xtra|Xtra]] ([[Benutzer Diskussion:Xtra|Diskussion]]) 20:08, 18. Okt. 2017 (CEST)

Benutzer:Do while

2014-08-30T13:46:11Z

Do while:

'''Nick:'''
* do_while (auch im Contao Forum)

'''Real Name:'''
* Hagen Klemp

'''Arbeit''':
# Angestellter bei DRAGO Automation GmbH, Berlin
# Inhaber der Webagentur Softleister

'''Webseite:'''
* [http://www.softleister.de www.softleister.de]

Diskussion:Ce be remarks

2014-03-12T22:17:14Z

Do while: Recherche nach dem Iconset

Der Link zu dem Icon-Set ist nicht mehr erreichbar. Scheint so, als wäre dieses Icon-Set nicht mehr erhältlich. Kannst du das bitte prüfen? Danke.

http://wefunction.com/2008/07/function-free-icon-set/

--[[Benutzer:Andreas|Andreas Burg]] 11:57, 12. Mär. 2014 (CET)

Die Zielseite führt schon noch zum Autor der Icons (Liam McKay, siehe auch im Footer der neuen Seite), nur ist dieser Iconset nicht mehr dort Online. Bedingung für diesen Fuction-Free-Icon-Set ist die Angabe des oben genannten Links.

--[[Benutzer:do_while|Hagen Klemp]] 23:16, 12. Mär. 2014 (CET)

BackupDB

2012-08-04T18:20:15Z

Do while: Experteneinstellungen entfallen, da alle Parameter jetzt direkt zugänglich sind

Modul zur Sicherung der MySQL-Datenbank und zur Erstellung eines Website-Templates.
{{ExtInfo
| Dev=Hagen Klemp ([[User:do_while|do_while]])
| DevSite=http://www.softleister.de
| ExtVersion=1.6.0 stable
| Version=2.9.x - 2.11.5
| TLVersion=2.6.0 - 2.8.x
| ERLink=http://www.contao.org/erweiterungsliste/view/BackupDB.de.html
}}
[[Kategorie:Extensions]]

=Forum=
Fragen zum BackupDB-Modul werden im Forum beantwortet: [http://www.contao-community.de/forumdisplay.php?25-backupDB Forum - BackupDB-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 [http://www.contao.org/erweiterungsliste/view/BackupDB.html vom Extension Repository laden], entpacken und entsprechend übertragen. Bitte auch auf die richtige Übertragung der .htaccess-Dateien achten. Die .htaccess-Dateien in den einzelnen Verzeichnissen, werden zur Absicherung gegen direkten Zugriff aus dem Internet benötigt.

Das Installtool von Contao braucht nicht aufgerufen zu werden, da das Modul keine Datenbankveränderungen vornimmt oder eigene Tabellen anlegt.

=Backend-Modul "Backup Datenbank"=
Eine Datensicherung der MySQL-Datenbank ist wichtig, wenn ein Störfall aufgetreten ist. Mit der Datensicherung läßt sich die Datenbank komplett wieder neu erstellen. Eine '''Datei'''sicherung wird von BackupDB nicht ausgeführt, diese sollte man zusätzlich sichern, um für den Ernstfall gerüstet zu sein.

Es gibt ein paar Punkte, die beachtet werden müssen:
* BackupDB kann nicht Datenbanken jeder Größe sichern! Erfahrungswerte liegen bei max. 10-12 MByte, das ist aber stark von dem Aufbau der Website, der Serverperformance und der Datenbankanbindung abhängig. Wenn das Backup komplett fertig geworden ist, steht in der letzten Zeile der SQL-Datei "# --- End of Backup ---".
* Eine Datensicherung kann '''nicht''' für den Datentransport in ein anderes Contao- oder TYPOlight-Release (z.B. Update) verwendet werden!
* Ein Website-Template kann nur in einem gleichen System verwendet werden, d.h. gleiche Contao-Version und gleiche Erweiterungen mit gleichen Versionen. Grund ist, dass die Datenbankstruktur nicht im Website-Template gespeichert ist und so beim Import 100% übereinstimmen muss.

===Datenbank sichern===
[[Datei:BackupDB_Backup_starten.jpg|Backup starten]]

Um die komplette Datenbank zu sichern, klickt man im Backend einfach auf den Button "SQL-Backup starten". Daraufhin öffnet sich ein Downloadfenster, wo man das Zielverzeichnis auf dem lokalen System angibt.

===Website-Template erstellen===
[[Datei:BackupDB_Template_erstellen.jpg|Template erstellen]]

Das Website-Template kann genutzt werden, um über das Installtool eine fertige Umgebung einzurichten. Wichtig ist dabei, dass sowohl Contao, als auch die verwendeten Erweiterungen in den Versionen vorhanden sind, die beim Speichern des Website-Templates vorlagen.

Es werden dabei zwei Dateien erstellt:
# die Datenbankdatei *.sql
# eine Textdatei, in der die erwarteten Erweiterungen und Versionen stehen

Die Dateien werden normalerweise im /templates-Verzeichnis erstellt. Weiter [[#Anderen_Speicherort_für_Website-Templates_festlegen|unten]] ist erklärt, wie man auch ein anderes Zielverzeichnis einstellen kann.

===Parameter in den Systemeinstellungen===

Es gibt einige Einstellungen, die sich im Backend im Systemmenü unter Einstellungen befinden.
[[Datei:Backupdb160.jpg|BackupDB Einstellungen]]

'''Blacklist für Backups''' 
Oft ist das Backup für den Notfall gedacht, um die Installation wieder herstellen zu können. Gerade, wenn die Suchfunktion verwendet wird, gibt es oft sehr große Tabellen, die das Backup unnötig groß werden lassen. Mit der Blacklist, kann man das Speichern dieser Daten im Backup gezielt verhindern. Die Tabellen ''tl_lock, tl_log, tl_search, tl_search_index, tl_session, tl_undo, tl_version'' enthalten Informationen aus der Historie oder sind wieder herstellbar.

'''Datentabellen im Website-Template''' 
In BackupDB wurden bis Version 1.3.0 im Export nur Contao-Tabellen berücksichtigt, die mit tl_ beginnen. Jetzt besteht die Möglichkeit, im Einstellungen-Menü eine Liste an Datentabellen anzugeben. Es können einzelne Tabellen hinzugefügt werden oder auch nur die Prefixe, wie z.B. cat_ für Catalog-Tabellen. 
In diesem Fall gibt man ''tl_,cat_'' an.

'''Alternativer Pfad für Website-Template''' 
Das Website-Template wird normalerweise im Verzeichnis templates gespeichert, ab Version 1.3.0 kann der Speicherort auch verändert werden, z.B. ''tl_files/templatefile''

'''Backup komprimieren''' 
Ab Version 1.6.0 kann das Automatische Backup die SQL-Datei in ein ZIP-Archiv verpacken. Zusammen mit der neuen Mail-Funktion ist es sinnvoll, die Datenmenge zu minimieren.

'''Anzahl der Backups bei AutoBackupDB''' 
Das Autobackup per cron-Erweiterung verwendet normalerweise 3 Backupdateien, die sich in dem Verzeichnis ''tl_files/AutoBackupDB'' befinden. Das neueste Backup ist immer in ''AutoBackupDB-1.sql'' gespeichert und in -2 und -3 sind die älteren Backups vorhanden. Wenn einem die letzten 3 Backups nicht ausreichen, läßt sich durch einen Eintrag die Anzahl erhöhen.

'''E-Mail-Benachrichtigung nach AutoBackup''' 
Bei einem automatisch gesteuerten Backup durch die Cron-Erweiterung oder direkt von einem echten Cron gestartet (ab Version 1.6.0) hat man keine Übersicht, ob das Backup zuverlässig läuft. Eine Nachricht im Fehlerfalle ist oft nicht möglich, da das Script vom Server abgebrochen wird, bevor die Mail gesendet werden kann. Es bleibt aber die Möglichkeit, bei Erfolg eine Mail zu schicken. Mit der Benachrichtigungsmail haben Sie diese Möglichkeit.

'''AutoBackup-Datei anhängen''' 
Für den Fall, dass man die Benachrichtigungsmail eingeschaltet hat, ist es möglich, in der Mail gleich die aktuelle Datensicherung als Attachment mitzusenden.

===Automatisches Backup===
Für ein automatisch ausgeführtes Backup wird zusätzlich die Erweiterung [http://www.contao.org/erweiterungsliste/view/cron.de.html cron] benötigt. Wenn die Erweiterung installiert ist, bietet BackupDB an, dort einen cronjob anzulegen.
[[Datei:BackupDB_Cron_eintragen.jpg|Cron eintragen]]

Nach einem Klick auf diesen Link ist der Cronjob vorgemerkt, aber noch inaktiv, um dem Anwender die Möglichkeit zu geben, die Einstellungen und Zyklen nach Bedarf einzustellen:
[[Datei:BackupDB_Cron_inaktiv.jpg|Cron inaktiv]]

Im Menü des Schedulers (cron) kann das AutoBackup aktiviert werden, indem man einfach auf den rote-LED-Icon klickt (wird dann grün)
[[Datei:BackupDB_Cron_menu.jpg|Cron Menü]]

Im BackupDB-Menü sieht man dann die Anmerkung, dass der Cronjob aktiv ist.

[[Datei:BackupDB_Cron_aktiv.jpg|Cron aktiv]]

'''Anmerkung:'''

Der Cron der cron-Erweiterung ist nicht automatisch ein echter Cron. Er wird nur über Aufrufe im Backend gesteuert. Wenn nur selten jemand im Backend arbeitet, kann es sein, dass der Cron auch lange nicht ausgeführt wird. Abhilfe:
* man kann ein kleines Script in das Seitenlayout einbauen, um auch Trigger aus Frontendaufrufen zu erhalten
* man kann den CronController mittels echtem Cronjob vom Server aufrufen lassen.
Weitere Infos dazu unter [http://contifex.com/wiki/extensions/cron www.contifex.com]

2012-06-14T20:13:48Z

Do while: Anlegen der Struktur

Html validator

2012-06-14T20:07:05Z

Do while: Neuerstellung Erweiterung html_validator

Modul zur Sicherung der MySQL-Datenbank und zur Erstellung eines Website-Templates.
{{ExtInfo
| Dev=Hagen Klemp ([[User:do_while|do_while]])
| DevSite=http://www.softleister.de
| ExtVersion=0.0.1 beta1
| Version=2.11.x
| ERLink=http://www.contao.org/de/extension-list/view/html_validator.html
}}
[[Kategorie:Extensions]]

----
--[[Benutzer:do_while|do_while]] 14. Juni 2012

Kommentare nummerieren

2012-01-10T19:37:15Z

Do while: Verbesserung Kommentare nummerieren

[[Category:Admin HOWTOS]]

Im Forum wurde die Frage diskutiert, wie man Kommentare durchnummerieren kann. Wenn man alle Bedingungen abprüfen will, die die Ausgabe beeinflussen können, ist es nicht ganz so trivial.

Die Kommentare werden über das Template '''ce_comments.html5''' (bzw. .xhtml, .tpl) ausgegeben. Um die Ausgabe zu verändern, erstellt man über das Template-Menü eine Kopie im templates-Ordner.

Der Anfang des Templates ist dann wie folgt anzupassen:
<source lng="html">
<?php
$this->import('Database');
$objComments = $this->Database->prepare("SELECT COUNT(*) AS anzahl FROM tl_comments WHERE published=1 AND parent=?")->execute($this->id);
$ofs = $this->com_perPage * (is_numeric($this->Input->get('page')) ? $this->Input->get('page')-1 : 0);
?>

<div class="<?php echo $this->class; ?> block"<?php echo $this->cssID; ?><?php if ($this->style): ?> style="<?php echo $this->style; ?>"<?php endif; ?>>
<?php if ($this->headline): ?>

<<?php echo $this->hl; ?>><?php echo $this->headline; ?></<?php echo $this->hl; ?>>
<?php endif; ?>
<?php
$cnt = $this->com_order == ascending ? 1+$ofs : $objComments->anzahl - $ofs;
foreach ($this->comments as $comment) {
echo 'Kommentar ' . $cnt . ' von ' . $objComments->anzahl . ' ';
echo $comment;
$cnt += $this->com_order == ascending ? 1 : -1;
}
?>
<?php echo $this->pagination; ?>
<?php if (!$this->requireLogin): ?>
.
.
.
</source>

Der Rest des Templates bleibt Original.

==Verbesserung==
Der aufgelistete Vorschlag zeigt erstmal nur das Prinzip einer solchen Nummerierung. Die Nummerierung steht aber außerhalb des Kommentar-Divs und hat damit keinen Zusammenhang mit dem eigentlichen Kommentar.

Es gibt jetzt (mindestens) zwei Möglichkeiten zur Verbesserung:

1.
Um die Ausgabe in das Kommentar-Div hinein zu bekommen, muss ein weiteres Template angepasst werden: com_default.html5 (oder .tpl, .xhtml). Außerdem müssen die Informationen vom einen in das andere Template übergeben werden. Die Übergabe könnte beispielsweise über eine $GLOBALS[..][..]-Variable geschehen. 
Diese Lösung gefällt mir nicht so gut, da dann zwei Templates manuell gepflegt werden müssen.

2.
Eine etwas andere Lösung ist das Verpacken in einem zusätzlichen div-Container. Dieses Div fasst die Zählerzeile und den Kommentar zusammen. 
Hier ein Beispiel: die foreach-Anweisung im Template ce_comments.html5 wird etwas verändert:
<source lng="php">
foreach ($this->comments as $comment) {
echo '<div class="com_entry">Kommentar ' . $cnt . ' von ' . $objComments->anzahl . '';
echo $comment;
echo '</div>';
$cnt += $this->com_order == ascending ? 1 : -1;
}
</source>
Über die Klasse .com_entry kann jetzt die Zusammenfassung per CSS angesprochen und formatiert werden:
<source lng="css">
.com_entry
{
margin-bottom:10px;
border:1px solid #ff0000;
}
.com_entry span
{
padding:1px 10px;
background-color:#ff0000;
color:#ffffff;
}
.com_entry .comment_default
{
margin:2px 10px;
}
</source>

... nicht schön, erklärt aber die Idee dabei; über das Design kann jeder selbst bestimmen.

----
Erstellt von: [[Benutzer:do_while|do_while]]

[[Category:Dev HOWTOS]]

2011-05-26T21:43:00Z

Do while: /* Wartungs-Modus aktivieren */

{{stub}}
[[Category:Extensions]]
Mit der Maintenance-Erweiterung kann man eine Website unter Wartung stellen. Der Aufruf der Seiten führt dann nur noch auf eine Wartungsseite. Mitglieder der Wartungsgruppe (Mitgliedergruppe) dürfen die Seiten auch unter Wartung sehen und bedienen. Anwendungsbeispiele:
* Vorübergehende Wartung
* Entwicklung unter Wartungsschutz, der Kunde bekommt Wartungs-Account
* Einzelne Startpunkte noch unter Wartung
* Einzelne Sprachen noch unter Wartung
{{ExtInfo
| Dev=Lutz Schoening (sawyer)
| ExtVersion=0.4.1 rc2
| Version=ab 2.7.0 stable
| TLVersion=2.7.0 - 2.7.2 stable (Lauffähig auch in Contao 2.9.5)
| ERLink=http://www.contao.org/erweiterungsliste/view/maintenance.html
}}
=Installation=
==Aus der Erweiterungsverwaltung==
Da die Erweiterung nicht für das aktuelle Contao freigegeben ist, wird sie standardmäßig im Erweiterungskatalog nicht angezeigt. Durch direkte Angabe von "maintenance" kann man das Modul trotzdem leicht installieren. Bis Contao Version 2.9.5 ist es mehrfach ausprobiert und funktioniert einwandfrei.
[[Datei:maint_installation.jpg]]

==Manuelle Installation==
1) Download des Erweiterungs-ZIP: Aus der Erweiterungsliste der Contao-Webseite lädt man sich die Modul-ZIP-Datei herunter
[[Datei:man_install1.jpg]]

2) Entpacken: Mit einem Entzip-Programm packt man die Archivdatei aus, die enthaltene Struktur sieht dann so aus. 
[[Datei:man_install2.jpg]]

3) per FTP in das Contao laden: Man kopiert per FTP das Verzeichnis "maintenance" in das Contao unter system/modules/

4) Datenbank aktualisieren: In der Erweiterungsverwaltung ruft man eine Datenbak-Aktualisierung auf. Alternativ kann man auch den Installtool von Contao aufrufen und dort die Datenbank aktualisieren. 
[[Datei:man_install3.jpg]]

=Vorbereitungen=
Das Beispiel zeigt den Vorgang in einer "frischen" Music Academy. Mit Deutsch und Englisch geht es daher etwas durcheinander.

==Seiten anlegen==
In der Seitenstruktur legst Du eine Seite "Wartung aktiv" an. Die Seite sollte im Menü versteckt und veröffentlicht sein. 
[[Datei:maint_seitew.jpg]]

==Module Anlegen==
In den Modulen ein Modul vom Typ "Wartungsmodus Modul" anlegen 
Als Wartungsseite wählst Du die neue Seite "Wartung aktiv" 
Als Startseite wählst Du Deine Home- oder Startseite aus 
[[Datei:maint_modulw.jpg]]

Du legst ein weiteres Modul vom Typ "Login-Formular" an, als Weiterleitungsseite gibst Du die Home- oder Startseite an
[[Datei:maint_modulwl.jpg]]

=Einbindung=
==Seitenlayouts==
In Deinen Seitenlayouts fügst Du das Wartungsmodul in die "Hauptspalte" ein 
[[Datei:maint_layout1.jpg]]

Die Wartungsseite bekommt ein eigenes Seitenlayout ohne das Wartungsmodul, nur Artikel in der Hauptspalte! 
[[Datei:maint_layout2.jpg]]

'''Die Seitenlayouts werden entsprechend den Seiten zugeordnet'''
* In Startpunkt der Webseite ist das "Default layout" allen Seiten zugewiesen
* Die Wartungsseite bekommt das "Wartungs-Layout"
[[Datei:maint_layout3.jpg]]

==Aufbau der Wartungsseite==
Dieses Wartungs-Login-Modul fügst Du in der Wartungsseite ein. Hier können auch noch weitere Informationen über den Grund der Wartung mitgeteilt werden 
[[Datei:maint_login.jpg]]

==Mitglieder zulassen==
Jetzt noch eine Mitgliedergruppe "Wartung" anlegen. Man kann auch geeignete bestehende Gruppen für die Freigabe der Seiten verwenden. 
[[Datei:maint_wartg.jpg]]

Bei allen Mitgliedern, die in Wartung in die Seiten hineinkommen sollen, gibst Du die Wartungsgruppe mit an. 
[[Datei:maint_wartg1.jpg]]

==Wartungs-Modus aktivieren==
In den '''System-Einstellungen''' wählst Du die Wartungsgruppe als zulässig im Wartungsmodus aus und wählst die Startpunkte aus, die unter Wartung stehen sollen 
[[Datei:maint_einst.jpg]]

Es ist so möglich den Wartungsmodus für jeden Seitenbaum einzeln zu aktivieren (dabei ist es egal ob es eine MultiDomain ist oder "nur" verschiede Sprachen sind).

=Weitere Gestaltung=
==CSS für Wartungsmeldung==
* Der Hinweis soll das Erscheinungsbild nicht stören, auch den Bildausschnitt nicht kleiner machen
* Hover-Effekt um den Hinweis zeitweise verschwinden zu lassen

----
--[[Benutzer:do_while|do_while]] 25. Mai 2011

Datei:Maint einst.jpg

2011-05-26T21:41:46Z

Do while:

Maintenance

2011-05-26T21:39:20Z

Do while: /* Mitglieder zulassen */

{{stub}}
[[Category:Extensions]]
Mit der Maintenance-Erweiterung kann man eine Website unter Wartung stellen. Der Aufruf der Seiten führt dann nur noch auf eine Wartungsseite. Mitglieder der Wartungsgruppe (Mitgliedergruppe) dürfen die Seiten auch unter Wartung sehen und bedienen. Anwendungsbeispiele:
* Vorübergehende Wartung
* Entwicklung unter Wartungsschutz, der Kunde bekommt Wartungs-Account
* Einzelne Startpunkte noch unter Wartung
* Einzelne Sprachen noch unter Wartung
{{ExtInfo
| Dev=Lutz Schoening (sawyer)
| ExtVersion=0.4.1 rc2
| Version=ab 2.7.0 stable
| TLVersion=2.7.0 - 2.7.2 stable (Lauffähig auch in Contao 2.9.5)
| ERLink=http://www.contao.org/erweiterungsliste/view/maintenance.html
}}
=Installation=
==Aus der Erweiterungsverwaltung==
Da die Erweiterung nicht für das aktuelle Contao freigegeben ist, wird sie standardmäßig im Erweiterungskatalog nicht angezeigt. Durch direkte Angabe von "maintenance" kann man das Modul trotzdem leicht installieren. Bis Contao Version 2.9.5 ist es mehrfach ausprobiert und funktioniert einwandfrei.
[[Datei:maint_installation.jpg]]

==Manuelle Installation==
1) Download des Erweiterungs-ZIP: Aus der Erweiterungsliste der Contao-Webseite lädt man sich die Modul-ZIP-Datei herunter
[[Datei:man_install1.jpg]]

2) Entpacken: Mit einem Entzip-Programm packt man die Archivdatei aus, die enthaltene Struktur sieht dann so aus. 
[[Datei:man_install2.jpg]]

3) per FTP in das Contao laden: Man kopiert per FTP das Verzeichnis "maintenance" in das Contao unter system/modules/

4) Datenbank aktualisieren: In der Erweiterungsverwaltung ruft man eine Datenbak-Aktualisierung auf. Alternativ kann man auch den Installtool von Contao aufrufen und dort die Datenbank aktualisieren. 
[[Datei:man_install3.jpg]]

=Vorbereitungen=
Das Beispiel zeigt den Vorgang in einer "frischen" Music Academy. Mit Deutsch und Englisch geht es daher etwas durcheinander.

==Seiten anlegen==
In der Seitenstruktur legst Du eine Seite "Wartung aktiv" an. Die Seite sollte im Menü versteckt und veröffentlicht sein. 
[[Datei:maint_seitew.jpg]]

==Module Anlegen==
In den Modulen ein Modul vom Typ "Wartungsmodus Modul" anlegen 
Als Wartungsseite wählst Du die neue Seite "Wartung aktiv" 
Als Startseite wählst Du Deine Home- oder Startseite aus 
[[Datei:maint_modulw.jpg]]

Du legst ein weiteres Modul vom Typ "Login-Formular" an, als Weiterleitungsseite gibst Du die Home- oder Startseite an
[[Datei:maint_modulwl.jpg]]

=Einbindung=
==Seitenlayouts==
In Deinen Seitenlayouts fügst Du das Wartungsmodul in die "Hauptspalte" ein 
[[Datei:maint_layout1.jpg]]

Die Wartungsseite bekommt ein eigenes Seitenlayout ohne das Wartungsmodul, nur Artikel in der Hauptspalte! 
[[Datei:maint_layout2.jpg]]

'''Die Seitenlayouts werden entsprechend den Seiten zugeordnet'''
* In Startpunkt der Webseite ist das "Default layout" allen Seiten zugewiesen
* Die Wartungsseite bekommt das "Wartungs-Layout"
[[Datei:maint_layout3.jpg]]

==Aufbau der Wartungsseite==
Dieses Wartungs-Login-Modul fügst Du in der Wartungsseite ein. Hier können auch noch weitere Informationen über den Grund der Wartung mitgeteilt werden 
[[Datei:maint_login.jpg]]

==Mitglieder zulassen==
Jetzt noch eine Mitgliedergruppe "Wartung" anlegen. Man kann auch geeignete bestehende Gruppen für die Freigabe der Seiten verwenden. 
[[Datei:maint_wartg.jpg]]

Bei allen Mitgliedern, die in Wartung in die Seiten hineinkommen sollen, gibst Du die Wartungsgruppe mit an. 
[[Datei:maint_wartg1.jpg]]

==Wartungs-Modus aktivieren==
* In den System-Einstellungen wählst Du die Wartungsgruppe als zulässig im Wartungsmodus aus
* und wählst die Startpunkte aus, die unter Wartung stehen sollen
* Es ist möglich den Wartungsmodus für jeden Seitenbaum einzeln aktivieren (dabei ist es egal ob es MultiDomain oder "nur" verschieden Sprachen sind)
=Weitere Gestaltung=
==CSS für Wartungsmeldung==
* Der Hinweis soll das Erscheinungsbild nicht stören, auch den Bildausschnitt nicht kleiner machen
* Hover-Effekt um den Hinweis zeitweise verschwinden zu lassen

----
--[[Benutzer:do_while|do_while]] 25. Mai 2011

Datei:Maint wartg1.jpg

2011-05-26T21:38:36Z

Do while:

Datei:Maint wartg.jpg

2011-05-26T21:35:36Z

Do while:

Maintenance

2011-05-26T21:33:02Z

Do while: /* Aufbau der Wartungsseite */

{{stub}}
[[Category:Extensions]]
Mit der Maintenance-Erweiterung kann man eine Website unter Wartung stellen. Der Aufruf der Seiten führt dann nur noch auf eine Wartungsseite. Mitglieder der Wartungsgruppe (Mitgliedergruppe) dürfen die Seiten auch unter Wartung sehen und bedienen. Anwendungsbeispiele:
* Vorübergehende Wartung
* Entwicklung unter Wartungsschutz, der Kunde bekommt Wartungs-Account
* Einzelne Startpunkte noch unter Wartung
* Einzelne Sprachen noch unter Wartung
{{ExtInfo
| Dev=Lutz Schoening (sawyer)
| ExtVersion=0.4.1 rc2
| Version=ab 2.7.0 stable
| TLVersion=2.7.0 - 2.7.2 stable (Lauffähig auch in Contao 2.9.5)
| ERLink=http://www.contao.org/erweiterungsliste/view/maintenance.html
}}
=Installation=
==Aus der Erweiterungsverwaltung==
Da die Erweiterung nicht für das aktuelle Contao freigegeben ist, wird sie standardmäßig im Erweiterungskatalog nicht angezeigt. Durch direkte Angabe von "maintenance" kann man das Modul trotzdem leicht installieren. Bis Contao Version 2.9.5 ist es mehrfach ausprobiert und funktioniert einwandfrei.
[[Datei:maint_installation.jpg]]

==Manuelle Installation==
1) Download des Erweiterungs-ZIP: Aus der Erweiterungsliste der Contao-Webseite lädt man sich die Modul-ZIP-Datei herunter
[[Datei:man_install1.jpg]]

2) Entpacken: Mit einem Entzip-Programm packt man die Archivdatei aus, die enthaltene Struktur sieht dann so aus. 
[[Datei:man_install2.jpg]]

3) per FTP in das Contao laden: Man kopiert per FTP das Verzeichnis "maintenance" in das Contao unter system/modules/

4) Datenbank aktualisieren: In der Erweiterungsverwaltung ruft man eine Datenbak-Aktualisierung auf. Alternativ kann man auch den Installtool von Contao aufrufen und dort die Datenbank aktualisieren. 
[[Datei:man_install3.jpg]]

=Vorbereitungen=
Das Beispiel zeigt den Vorgang in einer "frischen" Music Academy. Mit Deutsch und Englisch geht es daher etwas durcheinander.

==Seiten anlegen==
In der Seitenstruktur legst Du eine Seite "Wartung aktiv" an. Die Seite sollte im Menü versteckt und veröffentlicht sein. 
[[Datei:maint_seitew.jpg]]

==Module Anlegen==
In den Modulen ein Modul vom Typ "Wartungsmodus Modul" anlegen 
Als Wartungsseite wählst Du die neue Seite "Wartung aktiv" 
Als Startseite wählst Du Deine Home- oder Startseite aus 
[[Datei:maint_modulw.jpg]]

Du legst ein weiteres Modul vom Typ "Login-Formular" an, als Weiterleitungsseite gibst Du die Home- oder Startseite an
[[Datei:maint_modulwl.jpg]]

=Einbindung=
==Seitenlayouts==
In Deinen Seitenlayouts fügst Du das Wartungsmodul in die "Hauptspalte" ein 
[[Datei:maint_layout1.jpg]]

Die Wartungsseite bekommt ein eigenes Seitenlayout ohne das Wartungsmodul, nur Artikel in der Hauptspalte! 
[[Datei:maint_layout2.jpg]]

'''Die Seitenlayouts werden entsprechend den Seiten zugeordnet'''
* In Startpunkt der Webseite ist das "Default layout" allen Seiten zugewiesen
* Die Wartungsseite bekommt das "Wartungs-Layout"
[[Datei:maint_layout3.jpg]]

==Aufbau der Wartungsseite==
Dieses Wartungs-Login-Modul fügst Du in der Wartungsseite ein. Hier können auch noch weitere Informationen über den Grund der Wartung mitgeteilt werden 
[[Datei:maint_login.jpg]]

==Mitglieder zulassen==
* Jetzt noch eine Mitgliedergruppe "Wartung" anlegen
* Bei allen Mitgliedern, die in Wartung in die Seiten hineinkommen sollen, gibst Du die Wartungsgruppe mit an.
* Man kann eine oder mehrer Gruppen bestimmen welche die Seite auch im Wartungsmodus normal betrachten können. (Und der Admin per Preview)
==Wartungs-Modus aktivieren==
* In den System-Einstellungen wählst Du die Wartungsgruppe als zulässig im Wartungsmodus aus
* und wählst die Startpunkte aus, die unter Wartung stehen sollen
* Es ist möglich den Wartungsmodus für jeden Seitenbaum einzeln aktivieren (dabei ist es egal ob es MultiDomain oder "nur" verschieden Sprachen sind)
=Weitere Gestaltung=
==CSS für Wartungsmeldung==
* Der Hinweis soll das Erscheinungsbild nicht stören, auch den Bildausschnitt nicht kleiner machen
* Hover-Effekt um den Hinweis zeitweise verschwinden zu lassen

----
--[[Benutzer:do_while|do_while]] 25. Mai 2011