Contao Community Documentation - Benutzerbeiträge [de]

PHP Debugging

2011-03-07T08:41:09Z

Leo.unglaub: /* Alternative Installation */

[[Category:Dev_HOWTOS]]
[[Category:Development]]
[[Category:Extensions]]
[[Category:Fehlersuche]]
Manchmal ist es hilfreich die Inhalte von PHP Variablen zu kennen. Zum Beispiel während der Entwicklung eines Templates oder bei der Fehlersuche. Eine Variante ist über print_r die Variable in HTML auszugeben. Einen besseren Weg bietet FirePHP. Mit FirePHP wird das print_r quasi in die Firebug Console umgeleitet. Die hier beschriebene Art funktioniert also nur mit dem Browser Firefox.

Es gibt bereits ein contao Module, dass FirePHP in contao integriert. [http://developmentwithtypolight.wordpress.com/2010/02/22/tl_debug-an-useful-extension-for-debugging-typolight/ Zum Download des contao Debug Module und Anleitung]

===Alternative Installation===
FirePHP ist auch ohne Modul schnell einsatzbereit. Hier eine Einleitung für die manuelle Installation:

* [https://addons.mozilla.org/en-US/firefox/addon/6149/ FirePHP Extension für Firefox installieren]
* [http://www.firephp.org/HQ/Install.htm FirePHP Server Library herunterladen]
** FirePHP nach tl_root/plugins/FirePHPCore entpacken
** folgende Zeile in tl_root/system/config/initconfig.php einfügen<source lang="php">require_once(TL_ROOT.'/plugins/FirePHPCore/fb.php');</source>
Das wars bereits. FirePHP sollte nun installiert sein. Eine einfache Meldung kann nun mit ''FB::log($myVar);'' in die Firebug console ausgegeben werden.
{{Hinweis| Netzwerk Tab in Firebug muss aktiv sein damit es funktioniert.}}
Um alle ''FB::log'' aufrufe zu ignorieren und nicht an den Client zu senden einfach ''FB::setEnabled(false);'' aufrufen.

Weitere Infos unter http://www.firephp.org/HQ/Use.htm

Eigene insert tags erstellen

2010-07-07T22:23:07Z

Leo.unglaub: Die Seite wurde neu angelegt: „Category:Dev HOWTOS Category:Dev Snippets {{AppliesTo |TLVersion=ab 2.6 |Version=ab 2.9 }} Unter Insert-Tags versteht man in Contao spezielles Platzhalter…“

[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]
{{AppliesTo
|TLVersion=ab 2.6
|Version=ab 2.9
}}
Unter Insert-Tags versteht man in Contao spezielles Platzhalter die beim Laden der Webseite durch bestimmte Inhalte ersetzt werden. Dies können zum Beispiel der aktuelle Benutzername, ein Datum oder ein Link sein. Der Contao-Core bietet eine ganze Reihe verschiedener Insert-Tags welche auf der Projekthomepage Dokumentiert sind. siehe [http://www.contao.org/inserttags.html Contao Insert-Tags]

== Aufbau eines Insert-Tags ==
Insert-Tags werden generell in zwei geschwungende Klammern verpackt. <nowiki>{{var::value}}</nowiki> Des weiteren sind Insert-Tags meistens zweigeteilt. Die Wertepaare sind durch einen Doppelpunkt getrennt. Der erste Teil ist entweder die Kategoriezugehörigkeit des Insert-Tags oder der Name des Tags. Der zweite Teil ist meistens ein Parameter um die gewünschte Rückgabe noch zu verfeinern. Ein Beispiel verdeutlicht dies: <nowiki>{{link::*}}</nowiki> Dieser Insert Tag würde einen Link zur Seite * (muss durch die ID der Seite ersetzt werden) im richtigen URL Format generieren.

== Eigene Insert-Tags erstellen ==
Seit TYPOlight Version 2.6 kann man Contao durch eigene Insert-Tags erweitern. Dazu wurde der Hook replaceInsertTags zur VErfügung gestellt. Der Ablauf ist nun folgender.
# Contao parsed einen Seitenaufruf und stöst dabei auf ein Insert-Tag
# Contao probiert dieses Insert-Tag mit den Core-Möglichkeiten zu ersetzen
# Wenn Contao das Insert-Tag nicht kennt wird es an den Hook replaceInsertTags weitergereicht. Dieser Hook erhällt das unbekannte Insert-Tag als Parameter. Nun kann der Entwickler prüfen ob er das unbekannte Insert-Tag ersetzen möchte und wenn ja, gibt er einen beliebigen Content zurück.
# Wenn der Entwickler nichts mit dem unbekannten Insert-Tag anfangen kann, so muss false zurück gegeben werden.

== Codebeispiel ==
In diesem Code-Beispiel soll der Insert-Tag <nowiki>{{foo::bar}}</nowiki> ersetzt werden.
Als erstes muss der Hook registriert werden.
// config.php
// registrieren des Hooks replaceInsertTags
$GLOBALS['TL_HOOKS']['replaceInsertTags'][] = array('MyClass', 'myReplaceInsertTags');

Nach der Registrierung des Hooks muss eine Klasse erstellt werden welche eine Methode zur Ersetzung beinhaltet.
//MyClass.php
class MyClass extends Frontend
{
public function myReplaceInsertTags($strTag)
{
$arrSplit = explod('::', $strTag);

if ($arrSplit[0] == 'foo')
{
// replace your Insert Tag
return 'mein content;
}

return false;
}
}
In der Methode myReplaceInsertTags muss man zuerst prüfen ob man für den unbekannten Insert-Tag zuständig ist. Wenn man einen zweigeteilten Insert-Tag verwendet splittet man den Tag anhand des :: (explode) Die geschweiften Klammern werden bereits von Contao entfernt und müssen daher nicht mehr entfernt werden.
// der Schluss ist irgend wie noch nicht richtig Formuliert, ich kann leider nicht mehr, bin total übermüdet....

Arbeiten mit Bildern

2010-07-05T12:58:19Z

Leo.unglaub: /* Codebeispiele */

[[Category:Dev HOWTOS]]
[[Category:Dev Snippets]]
{{AppliesTo|TLVersion=ab 2.7|Version=ab 2.9}}

Das Contao-Framework stellt folgende Methoden für das Arbeiten mit Bildern zur Verfügung:
# generateImage()
# getImage()
Der generelle Ablaub beim Arbeiten mit Bildern ist folgender. Man hat die Original-Daten welche meistens unter dem Ordner '''tl_files''' abgelegt sind. Im nächsten Schritt werden die Originaldaten aufbereitet, dass heißt das Bild wird in der entsprechenden GRöße unter '''system/html''' abgelegt und von dort aus auf der Webseite ausgegeben.

== getImage() ==
Die Methode getImage() ist in der Controller.php angesiedelt und besitzt 5 Parameter wovon die ersten drei Parameter verpflichtend sind. Die Methode erstellt eine neue Version des Original-Bildes und legt dieses im Cache Verzeichnis /system/html ab. Es wird eine URL zum neuen Bild zurück gegeben. Dieser Rückgabewert wird dann mit der Methode generateImage weiter verarbeitet.
Aktuell unterstützt Contao die folgenden Bildformate: jpeg, jpg, png, gif

=== Parameter ===
# $image: Enthällt den Pfad zu dem Bild welches bearbeitet werden soll. (BSP: tl_root/images/foobar.jpg)
# $width: enthällt die gewünschte Breite des Bildes (BSP: 200)
# $height: enthällt die gewünschte Höhe des Bildes (BSP: 250)
# $mode: optionale Angabe der Skallierungsmethode
## proportional
## box
# $target: // fehlt

== generateImage() ==
Die Methode generateImage() ist ebenfalls in der Controller.php angesiedelt und erzeugt einen HTML <img> Tag welcher in einem Template ausgegeben werden kann. Diese Methode besitzt 3 Parameter wovon nur der Erste verpflichtend angegeben werden muss. Wird beim Parameter $src kein Pfad angegeben, sondern nur ein Bildname (Pdafe beginnen immer mir /, Bildnamen nicht) so sucht Contao das Bild im aktuellen Themes Verzeichnis. (BSP: system/themes/default/images/)

=== Parameter ===
# $src: Der Pfad zum Bild welches eingebunden werden soll. (BSP: hier kann der Rückgabewert der Methode getImage() verwendet werden)
# $alt: Angabe eines ALT-Wertes. Dieser ist laut W3C Pflicht und sollte immer angegeben werden.
# $attributes: Angabe aller weiteren zusätzlichen <img> Attribute. (BSP: inline CSS, ...)

== Codebeispiele ==
Mit folgendem Code können Sie eine neue verkleinerte Version eines Bildes im Cache ablegen und auf der Seite ausgeben lassen:
$strReturn = $this->generateImage($this->getImage('tl_files/images/foobar.jpg', 300, 250, 'proportional'), 'my first image');

Arbeiten mit Bildern

2010-07-05T12:58:11Z

Leo.unglaub: Die Seite wurde neu angelegt: „Category:Dev HOWTOS Category:Dev Snippets {{AppliesTo|TLVersion=ab 2.7|Version=ab 2.9}} Das Contao-Framework stellt folgende Methoden für das Arbeiten m…“