Defaultwerte vorbelegen

2011-01-14T18:17:55Z

Russe: Weitere Beispiele für Events eingefügt.

[[Category:Dev_HOWTOS]]
Diese Anleitung beschreibt das Vorbelegen von Felder in Contao mit Defaultwerten. Zu Beginn sei erwähnt, dass Änderungen am Core vermieden werden sollte, da sonst das System nicht updatesicher bleibt. Deshalb:
*Änderungen an Sprachdateien erfolgen in der '''''system/config/langconfig.php'''''
*Änderungen an DCA-Einstellungen erfolgen in der '''''system/config/dcaconfig.php'''''
Warum das so außerhalb vom Core geht? Ganz einfach: Contao lädt einfach diese Dateien ganz am Schluss und dadurch ist es möglich, Daten zu überschreiben, bevor sie ausgegeben werden.

=Aufgabe 1=
Die Checkbox ''Artikel veröffentlichen'' beim Anlegen eines Artikels soll standardmäßig angehakt sein.

Zuerst muss man die Config-Datei suchen, in welcher diese Checkbox generiert wird. Das ist natürlich für Nicht-PHP-Kenner bei so vielen Dateien nicht einfach und man bedient sich eines Tricks. Zuerst benötigt man aber ein Programm, welches Dateien und Unterverzeichnisse nach Inhalt durchsuchen kann. Für diese Anleitung wird der Quellcode-Editor [http://www.pspad.com PSPad] verwendet. Vorbereitend wird eine Contao-Installation von der Projekt-Webseite geladen und in ein Verzeichnis nach Wahl entpackt.

Da man keine Ahnung hat, in welcher Datei die Konfiguration erfolgt, sucht man einfach mal nach der Bezeichnung des Feldes ''Artikel veröffentlichen'', denn auch das muss ja irgend woher kommen. Dazu öffnet man PSPad und klickt in der Menüleiste auf ''Suchen'' -> ''Suchen/Ersetzen in Dateien...''. Im sich öffnenden Dialogfenster sind nun folgende Parameter zu setzen:
*Gesuchter Text: Artikel veröffentlichen
*In diesem Ordner suchen => Verzeichnis, wo Contao entpackt wurde
*Einschließlich Unterordner: anhaken

[[Datei:fieldsdefault_pspadsearchform.png|PSPad Suchmaske Einstellungen]]

Mit einem Klick auf ''OK'' beginnt die Suche. 
Wie in dem Dateisuchergebnis sichtbar ist, wurde der Ausdruck an zwei Stellen in einer Datei '''system/modules/backend/languages/de/tl_article.php''' gefunden.

[[Datei:fieldsdefault_pspadsearchresult-1.png|800px|PSPad Suchergebnis]]

Das Dateisuchergebnis zeigt sogleich die Zeile an, an welcher Stelle der gesuchte Ausdruck gefunden wurde, nämlich in Zeile 46 und 86. Da ''veröffentlichen'' auf englisch ''published'' heißt, sollte klar sein, dass die Zeile 46 relevant ist. Wie man nun sieht, wird in dieser Datei das Feld, je nach Sprache benannt. Jetzt weiss man aber, in welchem Array diese Beschriftung gespeichert wird, nämlich in

<source lang="php">
$GLOBALS['TL_LANG']['tl_article']['published']
</source>

Also wiederholt man die Suche in allen Dateien und sucht dieses Array, was wieder ein Ergebnis liefert. Diesmal sind es 3 Ergebnisse. Logischerweise findet man das Array in allen Sprachdateien (standardmäßig de und en, deshalb zwei) und in der gesuchten Config-Datei. Es handelt sich hier um '''''system/modules/backend/dca/tl_article.php'''''.

[[Datei:fieldsdefault_pspadsearchresult-2.png|PSPad Suchergebnis]]

Diese Datei wird jetzt im Editor geöffnet. 
Jetzt wird es ein bisschen komplizierter, obwohl die Darstellung ja sehr ordentlich ist. Vor sich hat man jetzt eine Datei mit lauter mehrdimensionalen Arrays. Wer genau wissen möchte, um was es sich dabei handelt, kann sich [http://www.php.net/manual/de/language.types.array.php hier] weiterbilden. An und für sich muss man sich das einfach wie ein Geschenk vorstellen, das in n Packungen eingepackt ist (verschachtelt). Das

<source lang="php">
$GLOBALS['TL_LANG']['tl_article']['published']
</source>

findet man so vor:

<source lang="php">
'published' => array
(
'exclude' => true,
'label' => &$GLOBALS['TL_LANG']['tl_article']['published'],
'inputType' => 'checkbox',
'eval' => array('doNotCopy'=>true)
),
</source>

Jetzt verfolgt man die Verschachtelung zurück. Wenn man all das weg lässt, was nicht interessiert (= die Schachteln auf der gleichen Ebene), bleibt am Schluss das übrig:

<source lang="php">
$GLOBALS['TL_DCA']['tl_article'] = array
(
// Fields
'fields' => array
(
'published' => array
(
'exclude' => true,
'label' => &$GLOBALS['TL_LANG']['tl_article']['published'],
'inputType' => 'checkbox',
'eval' => array('doNotCopy'=>true)
),
)
);
</source>

Entweder man sieht das gleich, oder man löscht einfach alles, was nicht interessiert aus der Datei (Achtung, nicht speichern danach).

Nun kann man also alle Schachteln zusammenfassen:

<source lang="php">
$GLOBALS['TL_DCA']['tl_article']['fields']['published']
</source>

Genau hier wird dieses Feld generiert und man kann es jetzt in der '''''system/config/dcaconfig.php''''' vor belegen, indem man dort einfach folgenden Code eingibt:

<source lang="php">
$GLOBALS['TL_DCA']['tl_article']['fields']['published']['default'] = true;
</source>

Wie zu sehen ist, hängt man einfach dieser Verschachtelung noch ein 'default' an und setzt den Wert auf 'wahr', da eine Checkbox entweder angehakt ist (true) oder eben nicht (false).

Das war's. Von nun an ist die Checkbox standardmäßig angehakt. Es ist noch zu beachten, dass das natürlich keine Auswirkungen auf bereits erstellte Artikel hat, denn bei denen wurde der Status ja schon in die Datenbank eingetragen.

=Aufgabe 2=
Natürlich gibt es nicht nur Checkboxen. Man könnte z.B. auch die Bildergröße (150 x 100 Pixel) bei einem Bild vorbelegen. Das sähe dann so aus:

<source lang="php">
$GLOBALS['TL_DCA']['tl_content']['fields']['size']['default'] = array(150,100);
</source>

=Weitere Beispiele=
== Events ==
Hier sind ein paar Beispiele für Defaultwerte beim Anlegen eines Events.
<source lang="php">
$GLOBALS['TL_DCA']['tl_calendar_events']['fields']['details']['default'] = 'Event Text 
als Absatz und mit Zeilenumbruch.';

$GLOBALS['TL_DCA']['tl_calendar_events']['fields']['alt']['default'] = 'Alternativer Text'; # Alternativer Text bei Bildern
$GLOBALS['TL_DCA']['tl_calendar_events']['fields']['size']['default'] = array(150,); # Bildbreite von 150 px
$GLOBALS['TL_DCA']['tl_calendar_events']['fields']['fullsize']['default'] = true; # Großansicht/Neues Fenster
$GLOBALS['TL_DCA']['tl_calendar_events']['fields']['floating']['default'] = array('left'); # Bildausrichtung links
</source>

=Credits=
Orginalanleitung erstellt von [[Benutzer:Toflar|Toflar]]

Diskussion:Bildergalerie(n) - kreativ genutzt

2010-10-02T07:33:45Z

Russe: Die Seite wurde neu angelegt: „Dieses Vorgehen ist ein guter und schneller Weg eine Bildergalerie zu nutzen bei der man auf der Startseite nicht alle Bilder angezeigt bekommt. Leider gibt es hi…“

Dieses Vorgehen ist ein guter und schneller Weg eine Bildergalerie zu nutzen bei der man auf der Startseite nicht alle Bilder angezeigt bekommt. Leider gibt es hier auch einen gravierenden Nachteil, denn wenn der User einen Browser nutzt der CSS richtig interpretiert (was bei nahezu allen der Fall ist) aber bei dem JavaScript deaktiviert ist (was mittlerweile immer häufiger vorkommt), dann sieht der User zwar das Startbild der Galerie aber bei einem Mausklick darauf öffnet sich das Bild einzeln auf einer sonst leeren Seite. Der User sieht also gar nicht dass es da noch mehr Bilder gibt denn diese sind ja mit overflow:hidden versteckt.
Dieser Nachteil sollte in diesem Tutorial erwähnt werden denke ich.
Eine Lösung hier wäre die übrigen Bilder nicht direkt per CSS zu verstecken sondern über JavaScript die Eigenschaft overflow:hidden zuzuweisen. Ist JavaScript beim User aktiviert dann funktioniert alles wie es soll, die ganze Galerie geht in der Mediabox / Slimbox auf; ist JavaScript deaktiviert werden die Bilder nicht versteckt und sie können direkt angeklickt werden.

Contao Community Documentation - Benutzerbeiträge [de]

Defaultwerte vorbelegen

Diskussion:Bildergalerie(n) - kreativ genutzt