Wikizone - Benutzerbeiträge [de]

Xampp

2014-12-10T08:33:10Z

109.193.152.215: /* Mailkonfiguration für XAMPP */

== Mailkonfiguration für XAMPP ==
Standardmäßig speichert XAMPP Mails die z.B. über PHP generiert werden im '''Verzeichnis: mailoutput'''. Dort kann man sie als txt Dateien lesen.

Man kann XAMPP aber auch so konfigurieren, dass er über einen Mail Account Mails versenden kann. Damit kann man z.B. php Mailskripte testen, und bekommt auch die entsprechende Rückmeldung bzw. Spamassasin etc.
In Mac kann man das eingebaute Postfix nutzen (siehe Postfix auf Mac OS) in Windows nutzt man die XAMPP Konfiguration.

Beispiel Konfiguration für Gmail
Dateien:
C:\xampp\php\php.ini
C:\xampp\sendmail\sendmail.ini
php.ini [mail function]
<pre>
SMTP=smtp.gmail.com
smtp_port=587
sendmail_from = my-gmail-id@gmail.com
sendmail_path = "\"C:\xampp\sendmail\sendmail.exe\" -t"
</pre>
sendmail.ini. Replace all the existing code in sendmail.ini with following code
<pre>
[sendmail]

smtp_server=smtp.gmail.com
smtp_port=587
error_logfile=error.log
debug_logfile=debug.log
auth_username=my-gmail-id@gmail.com
auth_password=my-gmail-password
force_sender=my-gmail-id@gmail.com
</pre>
replace my-gmail-id and my-gmail-password restart the server using the XAMMP control panel so the changes take effect.

== XAMPP Probleme lösen ==
Zuweilen hat xampp veraltete libs an Bord. Auch wenn auf dem Rechner die neueren Libs sind benutzt xampp die eigenen alten.
=== ImageMagick und GraphicsMagick funktionieren nicht ===
Fehlermeldung im error_log
<pre>
dyld: Library not loaded: /usr/local/lib/libfreetype.6.dylib
Referenced from: /usr/local/bin/gm
Reason: Incompatible library version: gm requires version 18.0.0 or later, but libfreetype.6.dylib provides version 15.0.0
</pre>
GraphicsMagick wurde über Homebrew installiert.

Die Pfadangabe für libfreetype.6.dylib stimmt nicht. Eigentlich nutzt XAMPP die in seinem eigenen lib Verzeichnis. Man kann diese jedoch einfach mit der aus der /usr/local/lib/ ersetzen, dann funktioniert es wieder.

== xampp update ==
Quelle: http://www.jurkos.com/?p=854 11/2014
<pre>
1. Stop services or process under XAMPP control panel and EXIT
2. Rename installation folder C:\XAMPP\… with C:\XAMPP_old\
3. Create new folder with the same name C:\XAMPP\…
4. Install there new version of XAMPP (in security options you have to write the same passwords and usernames you had before)
5. Ctrl+c or ctrl+x just website folders under C:\XAMPP\htdocs\*… (don’t copy xampp folder and others who came with installation)
6. Create databases (with same name as before), this will create just new folder under C:\XAMPP\mysql\data\* with file inside db.opt + copy ibdata1 file under folder C:\XAMPP\mysql\
7. Copy content of older C:\XAMPP_old\mysql\data\*\ to C:\XAMPP\mysql\data\*\ and skip the file db.opt
8. If you did changes in previous xampp of file httpd-vhosts.conf under C:\XAMPP\apache\conf\extra\ don’t forget to copy it right and create folder C:\XAMPP\log
9. Start XAMPP control panel, start apache and mysql
10. DONE

</pre>
=== Bessere installation auf Mac ===
in XAMPP > xamppfiles > htdocs Symlink auf allgemeinen www Ordner setzen (z.B. unterste Ebene Festplatte oder in Benutzerordner.

Xampp

2014-12-10T08:17:32Z

109.193.152.215:

== Mailkonfiguration für XAMPP ==
Man kann XAMPP so konfigurieren, dass er über einen Mail Account Mails versenden kann. Damit kann man z.B. php Mailskripte testen.
In Mac kann man das eingebaute Postfix nutzen (siehe Postfix auf Mac OS) in Windows nutzt man die XAMPP Konfiguration.

Beispiel Konfiguration für Gmail
Dateien:
C:\xampp\php\php.ini
C:\xampp\sendmail\sendmail.ini
php.ini [mail function]
<pre>
SMTP=smtp.gmail.com
smtp_port=587
sendmail_from = my-gmail-id@gmail.com
sendmail_path = "\"C:\xampp\sendmail\sendmail.exe\" -t"
</pre>
sendmail.ini. Replace all the existing code in sendmail.ini with following code
<pre>
[sendmail]

smtp_server=smtp.gmail.com
smtp_port=587
error_logfile=error.log
debug_logfile=debug.log
auth_username=my-gmail-id@gmail.com
auth_password=my-gmail-password
force_sender=my-gmail-id@gmail.com
</pre>
replace my-gmail-id and my-gmail-password restart the server using the XAMMP control panel so the changes take effect.
== XAMPP Probleme lösen ==
Zuweilen hat xampp veraltete libs an Bord. Auch wenn auf dem Rechner die neueren Libs sind benutzt xampp die eigenen alten.
=== ImageMagick und GraphicsMagick funktionieren nicht ===
Fehlermeldung im error_log
<pre>
dyld: Library not loaded: /usr/local/lib/libfreetype.6.dylib
Referenced from: /usr/local/bin/gm
Reason: Incompatible library version: gm requires version 18.0.0 or later, but libfreetype.6.dylib provides version 15.0.0
</pre>
GraphicsMagick wurde über Homebrew installiert.

Die Pfadangabe für libfreetype.6.dylib stimmt nicht. Eigentlich nutzt XAMPP die in seinem eigenen lib Verzeichnis. Man kann diese jedoch einfach mit der aus der /usr/local/lib/ ersetzen, dann funktioniert es wieder.

== xampp update ==
Quelle: http://www.jurkos.com/?p=854 11/2014
<pre>
1. Stop services or process under XAMPP control panel and EXIT
2. Rename installation folder C:\XAMPP\… with C:\XAMPP_old\
3. Create new folder with the same name C:\XAMPP\…
4. Install there new version of XAMPP (in security options you have to write the same passwords and usernames you had before)
5. Ctrl+c or ctrl+x just website folders under C:\XAMPP\htdocs\*… (don’t copy xampp folder and others who came with installation)
6. Create databases (with same name as before), this will create just new folder under C:\XAMPP\mysql\data\* with file inside db.opt + copy ibdata1 file under folder C:\XAMPP\mysql\
7. Copy content of older C:\XAMPP_old\mysql\data\*\ to C:\XAMPP\mysql\data\*\ and skip the file db.opt
8. If you did changes in previous xampp of file httpd-vhosts.conf under C:\XAMPP\apache\conf\extra\ don’t forget to copy it right and create folder C:\XAMPP\log
9. Start XAMPP control panel, start apache and mysql
10. DONE

</pre>
=== Bessere installation auf Mac ===
in XAMPP > xamppfiles > htdocs Symlink auf allgemeinen www Ordner setzen (z.B. unterste Ebene Festplatte oder in Benutzerordner.

PHP - E-Mail versenden

2014-10-23T14:24:14Z

109.193.152.215: /* Links */

== Links ==

http://www.a2hosting.com/kb/developer-corner/php/using-php-to-send-e-mail-messages#Method-1.3A-Using-the-mail-function
http://www.phpbuddy.eu/emails-mit-php-versenden.html?start=4
http://de.wikipedia.org/wiki/Header_(E-Mail)#Beispielmail
http://www.schlayer.org/Spamassasin-Hits-deutsche-Uebersetzung.html

=== Probleme mit Spamfiltern vermeiden ===
Oft ist es notwendig den -f Parameter zu verwenden um Spamfiltern zu vermitteln, daß es sich nicht um einen Spamversand handelt.

<pre>
$addParams = '-fnoreply@'.$_SERVER['SERVER_NAME'];
$success = mail($to, $subject, $body, $headers,$addParams);
</pre>

==== Richtige Header ====
Bei Problemen mit der Spamerkennung. Hinweise bieten die Codes von Spamassasin

Link: http://www.schlayer.org/Spamassasin-Hits-deutsche-Uebersetzung.html

MESSAGE BEDEUTUNG
FH_FROMEML_NOTLD From Adresse hat keine gültige Top Level Domain (oder fehlt)
INVALID_MSGID Aufbau: <random characters@fqdn-of-sending-host> z.B.
RP_MATCHES_RCVD
URI_HEX

==== Funktionierendes Beispiel====
<pre>
$fqdn_hostname = $_SERVER['SERVER_NAME'];
$mid = "<" . sha1(microtime()) . "@" . $fqdn_hostname . ">";
$from = '"Narda Safety Test Solutions" <noreply@'.$_SERVER['SERVER_NAME'].'>';
$admin_mail = '<schlegel@geo-bit.de>';
$replyto_mail = 'service.narda-de@l-3com.com';
$to = $_POST[e_brief];
$subject="NARDA-STS / Request for RMA-Number";
$headers .= 'Reply-To: '.$replyto_mail."\r\n";
//$headers .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
//$headers .= "Return-Path: " .$replyto_mail. "\r\n";
$headers .= 'X-Mailer: PHP/'.phpversion()."\r\n";
$headers .= 'From: '.$from.'\r\n';
//$headers .= 'Cc:'.$narda_mail."\n";
$headers .= 'Bcc:'.$admin_mail."\n";
$headers .= "MIME-Version: 1.0\r\n";
$headers .= "Content-type: text/plain; charset=iso-8859-1\r\n";
$headers .= "Content-Transfer-Encoding: 7bit\r\n";
$headers .= "Message-ID: " .$mid. "\r\n\r\n";
$addParams = '-fnoreply@'.$_SERVER['SERVER_NAME'];
$body = "Dear Mrs./Mr. $_POST[first_name] $_POST[last_name],\r\n";
$body .= "your email-adress has been successfully confirmed. \r\n";
$body .= "You will find the form for filling in the data of your device here:\r\n\r\n";
$body .= $secure_root_url."/$ziel_ordner/RMA/rma_reCall.php?req_num=$req_number";
$state=mail($to, $subject, $body, $headers, $addParams);
</pre>

=== Gmx Header ===
Bei GMX können Kleinigkeiten dazu führen daß die Mail als Spam eingestuft wird. Wichtig beim Absender z.B. das folgende Format:
From: "Geocaching" <noreply@geocaching.com>
PHP-Beispiel:
$headers .='From: "Narda" <'.$from.">\r\n";

=== Testmail ===
<pre>
$template = "Dies ist ein Test";
$empfaenger = "schlegel@geo-bit.de";
// Trenner für den Anhang
$trenner = md5( time() );

// Mail Header erstellen
$mailheader = '';
$mailheader .= "Reply-To: Schlegel<schlegel@geo-bit.de>\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n";
$mailheader .= "From: Keine Antwort<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: multipart/mixed;\r\n";
$mailheader .= " boundary = " .$trenner;
$mailheader .= "\r\n\r\n";

// Mailbody vorbereiten
$mailbody = "This is a multi-part message in MIME format\r\n";
$mailbody .= "--" .$trenner. "\r\n";
$mailbody .= "Content-Type: text/html; charset=UTF-8\r\n";
$mailbody .= "Content-Transfer-Encoding: 8bit\r\n\r\n";
$mailbody .= $template. "\r\n\r\n";
echo($mailheader);
echo($mailbody);
// Email versenden
if (mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}else{
echo 'Fehler beim Versand';
}
</pre>
=== Einfache Text E-Mail mit Template ===
Einfache Text Email

Zuerst das Listing unserer Template Datei mailbody.txt
<pre>

Soeben ist eine Nachricht von ###NAME### eingetroffen.
Als Antwortadresse wurde ###EMAIL### angegeben.
Die Nachricht die gesendet wurde:
###NACHRICHT###
</pre>

Wie man unschwer erkennt, ist das ganz normaler und schlichter Text. Lediglich die Platzhalter darin fallen auf. Diese Platzhalter korrespondieren in unserem Script mit den Benutzereingaben und werden in unserem Script durch diese ersetzt.
Dadurch das wir den Text, der später per Email an uns geschickt wird, in einer eigenen Datei ablegen, können wir den Text schnell und flexibel beliebig verändern und erweitern. Da es sich hierbei um einen Mailer handelt der nur reinen Text verschickt, müssen wir auf jegliche Art von Formatierungen verzichten.

Bisher haben wir das HTML-Formular, die Funktionen und das Mail Template kennengelernt, fehlt nur noch das Hauptscript, dass wir uns gleich mal vorknöpfen.

Listing der Datei mail.php
<pre>
<?php

header( 'Content-Type: text/html; charset=utf-8' );

// Empfänger Email
$empfaenger = 'max.mustermann@domain.tld';

// Prüfen ob das Formular abgeschickt wurde
if (isset($_POST['senden']))
{
// Funktionen einbinden
include( 'funktionen.inc.php' );

// Benutzereingaben bereinigen und auf Injection prüfen
cleanInput();

// Name prüfen
$name = checkName( $_POST['name'] );
// Email prüfen
$email = checkEmail( $_POST['email'] );
// Betreff und Nachricht prüfen
if ((strlen( $_POST['betreff'] ) < 5) || (strlen( $_POST['nachricht'] ) < 5))
{
die( 'Bitte füllen Sie alle Felder aus!' );
}
else
{
$betreff = $_POST['betreff'];
$nachricht = $_POST['nachricht'];
}

// --------------------------------------------------------------------------------
// Wurde das Script bisher nicht abgebrochen, wurde das Formular korrekt ausgefüllt
// --------------------------------------------------------------------------------

// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );

// Mail Header erstellen
$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

// Email versenden
if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}
}

?>
</pre>
Das sieht im ersten Moment mehr und wilde
r aus, als es das eigentlich ist. Der obere Teil ist schnell erklärt. Zunächst setzen wir die Email des Empfängers, der idR wir selbst sind. Dann wird geprüft ob das Formular überhaupt abgeschickt wurde und wenn dem so ist, binden wir die benötigten Funktionen ein und überprüfen die Benutzereingaben.

Mit den Zeilen ...
<pre>
// Template mit dem Mailbody laden und für den Versand vorbereiten
$mailbody = file_get_contents( 'mailbody.txt' );
// Platzhalter mit den Benutzereingaben ersetzen
$mailbody = str_replace( '###NAME###', htmlspecialchars( $name ), $mailbody );
$mailbody = str_replace( '###EMAIL###', $email, $mailbody );
$mailbody = str_replace( '###NACHRICHT###', htmlspecialchars( $nachricht ), $mailbody );
</pre>
... laden wir das Mail Template (file_get_contents) und ersetzen mit einfachen str_replace Funktionen die Platzhalter. Auch wenn wir bereits auf mögliche Injections geprüft haben, entschärfen wir dennoch die Eingaben mit htmlspecialchars, damit uns niemand etwas unterschiebt. Bei der Email ist das nicht nötig, da diese sonst nicht durch den Filter gekommen wäre.

Jetzt kommen wir zu dem wichtigsten Teil, der ein erfolgreiches Versenden überhaupt erst möglich macht: dem Mail Header.

Der Mail Header ist der Kopf der Email, der alle relevanten und wichtigen Informationen über unsere Email enthält. Sehr sehr häufig sieht man in Scripts und Tutorials, dass hier lediglich das "From:" angegeben ist. Wenn nur diese Information angegeben ist, bleibt die Mail sehr häufig in einem Spamfilter hängen. Kein Mensch würde auf die Idee kommen einen echten Brief zu verschicken und als Beschreibung auf dem Brief nur einen Name angeben, ohne komplette Anschrift und Absenderadresse. Wieso dann bei einer Email?!

Schauen wir uns also an wie ein Header aussieht, der die wichtigsten Angaben enthält:
<pre>
$mailheader = "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";
</pre>

Die Steuerungzeichen "\r\n" entsprechen einen Wagenrücklauf und Zeilenvorschub oder anders ausgedrückt, ein Zeilenumbruch. Diese Steuerungzeichen sind betriebssystemabhängig und müssen ggfs. angepasst werden. Auf Linux würde man z.B. nur "\n" verwenden. Schauen wir uns nun die anderen angaben an:

'''From''' - Das ist die Absendeadresse und der dazugehörige Name. Es ist üblich diesen in der Form Name anzugeben. Das ist die absolute Minimumangabe für inen Mailheader. Fehlt das From, wird der Versand der Mail fehlschlagen.

'''Reply-To''' - Das Format kann entweder nur eine Email Adresse sein, oder man wählt das Format wir bei From. Dieses Feld ist die Antwortadresse an die die Mail geschickt wird, wenn wir im Mail Client auf antworten klicken.

'''Return-Path''' - Konnte die Mail nicht zugestellt werden, wird dies an diese Adresse gemeldet.

'''MIME-Version''' - Entspricht dem MIME Typ der Mail.

'''Content-Type''' - Das ist die Information die dem Mail Client mitteilt, um welche Art Mail es sich handelt und welcher Zeichensatz zur Darstellung benutzt werden soll.

'''Content-Transfer-Encoding''' - Dies beschreibt die Art der Übertragung und wie sowohl Mailserver, als auch Email Clients diese Mail interpretieren. 7bit ist die kleinste Form, die maximal mögliche Kompatibilität ermöglicht. Beim 7bit ASCII Zeichensatz können die ersten 128 zeichen der ASCII Tabelle dargestellt werden. Zeichen wie deutsche Umlaute sind darin nicht vorgesehen. Bei der 8bit Übertragung können bis zu 256 zeichen dargestellt werden. Ältere Mailerver, so liest man, verstehen nur 7bit und verwerfen Anfragen die mit 8bit übertragen werden sollen. Anders ausgedrückt, es kann passieren das die Mail nicht ankommt. Ich persönlich hatte damit allerdings noch nie Probleme und die 7bit "Zwangsangabe" scheint veraltet zu sein.

'''Message-ID''' - Die Message ID ist einmalig, bzw. sollte es sein, wodurch die Mail eindeutig zugeordnet werden kann.

'''X-Mailer''' - Beschreibt den Client der die Mail versendet hat. In unserem Fall geben wir die PHP Version an, damit Mailserver auf der Route wissen, dass diese Mail mit PHP verschickt wurde.

Es gibt noch weitere Felder und Varianten, die uns aber im moment nicht kümmern. Im Abschnitt Mail mit Anhang werden wir noch einen etwas anderen Header kennen lernen.
Speziell die letzten beiden Angaben (Message ID und X_Mailer) im Header oben sind sehr wichtige Informationen. Fehlen diese Angaben, ist die Wahrscheinlichkeit sehr hoch, dass die Mail niemals beim Empfänger ankommen wird, weil die Mail irgendwo unterwegs in einem Spamfilter hängen bleibt und nicht weitergeleitet wird!

Falls also eine Mail nicht ankommt, liegt das in den aller meisten Fällen entweder am Transfer-Encoding (7bit oder 8bit) oder an fehlenden Absendeangaben!

Der Rest des Scripts ist sehr einfach, weil hier einfach nur noch die Mail verschickt wird.

if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}

Die mail-Funktion kennt noch einen 5. Parameter auf den ich jetzt nicht eingehen werde, weil dieser nur in den seltensten Fällen unterstützt wird. Wer mehr darüber erfahren möchte kann sich darüber in der Online-Doku informieren. Die mail-Funktion selbst liefert entweder TRUE oder FALSE zurück. Bei einem FALSE konnte die Mail nicht für den Versand übergeben werden und wir können entsprechend darauf reagieren. Im Falle von TRUE heisst das zwar das die Mail für den Versand angenommen wurde, aber es ist nicht prüfbar ob die Mail auch tatsächlich beim Empfänger ankam! Einige Gründe dafür stehen weiter oben. Wurde die Mail für den Versand akzeptiert, können wir darauf angemessen reagieren, indem wir den Besucher zu einer Danke-Seite weiterleiten oder, was weiter unter gezeigt wird, dem Benutzer eine Empfangsbestätigung, respektive Kopie der Mail an seine Adresse schicken.

Soweit so gut. Dieser Abschnitt fiel etwas länger aus, weil ich die prinzipielle Funktionsweise und den Header beschrieben habe. Die nachfolgenden Beispiele sind über große Strecken identisch, deswegen spare ich mir dort die Erklärungen und gehe nur auf die abweichenden Passagen ein.

=== E-Mail mit CSS Formatierung ===

Eine Email im HTML Format zu senden ist im Grunde genommen nichts anderes, als eine einzelne Webseite per Email zu verschicken. Wir haben also mehr oder weniger freie Hand was die Gestaltung angeht, solange wir uns an die HTML und CSS Richtlinien halten. Das wird sofort ersichtlicht, wenn man das Template für die Email sieht.

Listing der Datei mailbody.txt
<pre>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="de" lang="de">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Email als HTML</title>
<style type="text/css">
body { font: normal 12px Verdana, Arial, Helvetica, sans-serif; }
a { color: blue; text-decoration: none; }
h2 { font-size: 16px; font-weight: bold; }
.gruen { color: green; }
</style>
</head>

<body>
<h2>Soeben ist eine Nachricht von <span class="gruen">###NAME###</span> eingetroffen.</h2>
<p>Als Antwortadresse wurde <a href="mailto:###EMAIL###">###EMAIL###</a> angegeben.</p>
<p>Die Nachricht die gesendet wurde lautet:<br />
###NACHRICHT###</p>
</body>
</html>
</pre>

Das Template besteht aus einer normalen HTML Datei mit etwas CSS. Auch hier treffen wir wieder unsere Platzhalter, die durch die Benutzereingaben ersetzt werden.

Die Datei funktionen.inc.php ist identisch mit wie beim vorherigen Beispiel. Auch die mail.php weicht nur minimal vom letzten Beispiel ab - das aber mit großer Wirkung!
Die erste Abweichung findet in der Zeile zum ersetzen des Platzhalters für die Nachricht statt.

$mailbody = str_replace( '###NACHRICHT###', nl2br( htmlspecialchars( $nachricht ) ), $mailbody );

Ergänzt wurde hier die Funktion nl2br. Diese Funktion bewirkt, dass das Steuerungzeichen für einen Zeilenumbruch (\n) in ein HTML-konformes Break (<br />) umgewandelt wird. Ohne diese Funktion hätten wir bei der Ausgabe nur eine laaaange Zeile Text ohne neue Absätze und Umbrüche.

Die nächsten beiden Veränderungen finden im Mail Header statt. Da wird nun ja keinen reinen Text, sondern HTML verschicken, muß natürlich der Content-Type angepasst werden. Ebenso ändern wir das Transfer-Encoding auf 8bit. Hier die beiden geänderten Zeilen:

$mailheader .= "Content-Type: text/html; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 8bit\r\n";

That's it!
Diese kleinen Veränderungen haben eine solch große Auswirkung auf die Art der Darstellung!

Das Ergebnis im Mail Client:

(Deutlich zu sehen das die H2-Überschrift sich absetzt und auch der Name durch das CSS farblich hervorgehoben wird)

Vermutlich stand jeder angehende Programmierer schon mal an dieser Stelle. Voller Stolz blickt man in sein Postfach, wo die erste Mail vom eigenen Formmailer eingetroffen ist. Dann denkt man sich: "Das war ja einfach, mit nur so wenigen Zeilen Code so ein Ergebnis zu erzielen. Wie schwer kann es da schon sein auch eine Datei mitzuschicken?!".
Angesichts der oben gezeigten Beispiele, und wie minimal der Unterschied zwischen Text Mail und HTML Mail ist, neigt man dazu zu denken, dass dies mit einem Dateianhang ebenso einfach ist.

Tja, leider ist dem nicht so. Das senden von Dateianhänge ist erheblich aufwändiger als das senden einer Text/HTML Mail. Das Formular ist abweichend, der Mail Header ist abweichend, der Mail Body muß in einzelne Teilbereiche getrennt werden, Dateianhänge müssen Richtlinien beachten, was die Zeilenlänge und die Art der Zeichen innerhalb der Mail angeht.
Glücklicherweise hilft uns PHP bei den meisten Sachen und deshalb werden wir auch dieses Problem meistern. :)

=== E-Mail mit CSS und Anhang ===
Todo Quelle siehe oben (2012-03)

HTML Email mit CSS Formatierung und Dateianhang

Da wir eine Datei mit der Mail verschicken möchten, muß das Formular natürlich dahingehend erweitert werden, dass ein Upload auch möglich ist. In unserem Beispiel möchten wir eine JPG datei anhängen und erlauben auch nur das hochladen dieses Bildtyps.
Die Template Datei ist identisch zum vorherigen HTML Beispiel. In der Datei funktionen.inc.php fügen wir aber eine weitere Funktion hinzu, die für uns prüft, ob eine Datei hochgeladen wurde und ob es sich dabei um eine JPG Datei handelt.

<pre>
function checkFile()
{
if ($_FILES['datei']['error'] == 0 &&
$_FILES['datei']['type'] == 'image/jpeg')
{
return $_FILES['datei']['name'];
}
else
{
die( 'Bitte eine gültige JPG Datei anhängen!' );
}
}
</pre>

In der Datei mail.php wird sich nun einiges ändern. Zunächst erweitern wir die einleitende Abfrage dahingehend, dass wir feststellen ob auch eine Datei angehängt wurde ...

if (isset($_POST['senden']) && $_FILES['datei']['size'] > 0)

... und fügen ebenso den Aufruf für die neue Funktion hinzu, die prüft ob ein JPG hochgeladen wurde:

$uploadname = checkFile();

Das weitere Listing der Datei mail.php sieht wie folgt aus:
<pre>
// Template mit dem Mailbody laden
$template = file_get_contents( 'mailbody.txt' );
// Trenner für den Anhang
$trenner = md5( time() );

// Platzhalter mit den Benutzereingaben ersetzen
$template = str_replace( '###NAME###', htmlspecialchars( $name ), $template );
$template = str_replace( '###EMAIL###', $email, $template );
$template = str_replace( '###NACHRICHT###', nl2br( htmlspecialchars( $nachricht ) ), $template );

// Mail Header erstellen
$mailheader .= "Reply-To: " .$name. "<" .$email. ">\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n";
$mailheader .= "From: PHP Email Tutorial<noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: multipart/mixed;\r\n";
$mailheader .= " boundary = " .$trenner;
$mailheader .= "\r\n\r\n";

// Mailbody vorbereiten
$mailbody = "This is a multi-part message in MIME format\r\n";
$mailbody .= "--" .$trenner. "\r\n";
$mailbody .= "Content-Type: text/html; charset=UTF-8\r\n";
$mailbody .= "Content-Transfer-Encoding: 8bit\r\n\r\n";
$mailbody .= $template. "\r\n\r\n";

// Anhang anfügen
$mailbody .= "--" .$trenner. "\r\n";
$mailbody .= "Content-Type: image/jpeg; name=\"" .$uploadname. "\"\r\n";
$mailbody .= "Content-Transfer-Encoding: base64\r\n";
$mailbody .= "Content-Disposition: attachment; filename=\"" .$uploadname. "\"\r\n\r\n";
$mailbody .= chunk_split( base64_encode( file_get_contents( $_FILES['datei']['tmp_name'] ) ) );
$mailbody .= "\n";

// Email versenden
if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
echo 'Danke, die Email wurde verschickt!';
}

</pre>

Wir sehen auf den ersten Blick, dass dieser Code ganz anders aussieht als das vorherige Beispiel. Gehen wir den Code mal der Reihe nach durch, um etwas Licht in's Dunkel zu bringen.

Im oberen Bereich erzeugen wir einen eindeutigen String, den wir zum trennen der verschiedenen Teilbereiche der Mail verwenden werden:

$trenner = md5( time() );

Der erste Teil des Mail Header ist uns bereits bekannt, aber beim Content-Type benötigen wir nun eine andere Angabe.

$mailheader .= "Content-Type: multipart/mixed;\r\n";

Dieser Content-Type ähnelt der Angabe "multipart/form-data" in einem HTML Formular, wenn wir dort ebenfalls gemischte Inhalte haben, nämlich Text und Dateien. Damit der Mail Client nun weiß an welchen Stellen im gesendeten Quellcode er Inhalte trennen muß, teilen wir im Header den boundary-String mit.

An dieser Stelle möchte ich noch auf 2 wichtige Dinge hinweisen. Das Leerzeichen vor dem "boundary" im Header ist kein Versehen! Es kann tatsächlich dazu führen das eine Mail nicht korrekt dargestellt wird, wenn dieses Leerzeichen fehlt. Ebenso ist es wichtig, dass die "From"-Angabe unmittelbar vor der "MIME-Version" und dem "Content-Type" steht. Vertauscht man die Reihenfolge der Header Angabe, führt das z.B. bei mir dazu, dass ich im Thunderbird nur eine leere Seite als Mail angezeigt bekomme, obwohl der komplette Mail Inhalt im Quelltext einsehbar ist.

Die nächste Zeile ...

$mailbody = "This is a multi-part message in MIME format\r\n";

... steht vor der Nachricht im Head Bereich in der Email. Sie scheint nicht zwingend erforderlich zu sein, aber Mail Clients fügen diese ebenfalls hinzu, wenn man mit z.B. Thunderbird eine Email verschickt. Ich vermute, dass dies aus Gründen der Kompatibilität zu einigen Mail Server geschieht.

Nun folgt der erste Teil unserer Email, der Text.
<pre>
$mailbody .= "--" .$trenner. "\r\n";
$mailbody .= "Content-Type: text/html; charset=UTF-8\r\n";
$mailbody .= "Content-Transfer-Encoding: 8bit\r\n\r\n";
$mailbody .= $template. "\r\n\r\n";
</pre>
Durch den Trenner teilen wir dem Mail Client mit, dass zwischen diesem Trenner und dem nächsten Trenner, bzw. dem Ende der Mail, ein Teilabschnitt dieser Email steht. Damit der Client weiß um was es sich bei diesem Abschnitt handelt, teilen wir ihm das mithilfe des "Content-Type" und dem "Transfer-Encoding" mit. Durch die Angabe "text/html" weiß nun der Client, dass alles bis zum nächsten Trennen als HTML dargestellt werden soll.

Der nächste Teilabschnitt der Mail ist unser Bild:
<pre>
// Anhang anfügen
$mailbody .= "--" .$trenner. "\r\n";
$mailbody .= "Content-Type: image/jpeg; name=\"" .$uploadname. "\"\r\n";
$mailbody .= "Content-Transfer-Encoding: base64\r\n";
$mailbody .= "Content-Disposition: attachment; filename=\"" .$uploadname. "\"\r\n\r\n";
$mailbody .= chunk_split( base64_encode( file_get_contents( $_FILES['datei']['tmp_name'] ) ) );
$mailbody .= "\n";
</pre>
Wieder folgt zunächst der Trenner. Der Client stoppt seine HTML Ausgabe an dieser Position und wird ab diesem Punkt ausgeben, was ihm durch den "Content-Type" und das "Transfer-Encoding" aufgetragen wird. Wir sehen nun, dass wir als Content-Type eine JPG Datei ausgeben möchten. Der Name ergibt sich aus dem Rückgabewert der Funktion, die den Upload zuvor überprüft hat. Als Transfer-Encoding wird "base64" angegeben. Diese Angabe ist überaus wichtig um eine korrekte Übertragung der Daten zu gewährleisten. Mit der Angabe "Content-Disposition: attachment;" legen wir fest, dass der Anhang wirklich an die Mail angehängt wird. Eine andere Möglichkeit wäre hier das Einbetten in den Mailtext, indem man als Content-Disposition ein "inline" angibt. Die nächste Zeile ist ziemlich tricky:

$mailbody .= chunk_split( base64_encode( file_get_contents( $_FILES['datei']['tmp_name'] ) ) );

Arbeiten wir uns mal von Innen nach Außen durch, weil hier mehrere Funktionen verschachtelt sind. Mit file_get_contents wird eine Datei als String eingelesen. Dies ist hier möglich, weil diese Funktion seit PHP 4.3 binary safe ist. Als einzulesender Dateiname nehmen wir hier den Name der temporären datei, die durch den Upload auf dem Server gelandet ist. Diese Datei steht nur zu genau diesem Zeitpunkt zur Verfügung. Sobald das Script beendet wird oder eine andere Seite geladen wird, existiert diese Datei nicht mehr. Möchte man diese Datei erst zu einem späteren Zeitpunkt verarbeiten, muß man diese zunächst mit move_uploaded_file an eine andere Position kopieren.
Da wir nun die Bilddatei als String eingelesen haben, wird er mit base64_encode umgewandelt, damit die Datei beschädigt wird, falls es nicht möglich ist die Mail als 8bit zu übertragen. Es wird also aus Gründen der Kompatibilität gemacht. Anschließend wird der String mit chunk_split so aufbereitet, dass die Zeilenlänge 76 Zeichen nicht übersteigt.

Das war's! Die Daten können nun wieder mit der mail-Funktion versendet werden. Sollte man mehr als eine Datei anhängen wollen, kann man den letzten Schritt beliebig oft wiederholen. Erst Trenner setzen, dann Art der Daten und Übertragungsmodus angeben, die Datei anhängen, fertig.

==== Beispiel Funktion (SPAM Proofed)====
(Aus Narda Accredited Calibration)
<pre>

function send_acc_mail($rma_num,$arrForm,$arrPartner){
global $user_db;
global $dbase;
global $pass_db;
global $database;
global $pdf_template;
global $mail_template;// not used
global $mail_template_txt;// only use this for plaintext message (more secure)
global $pdf_css;
global $narda_mail;
global $admin_mail;
global $replyto_mail;
$partner_mail = $arrPartner[email];

$arrMarkers = array_merge($arrForm,$arrPartner,array("rma_num"=>$rma_num));

// PDF-TEMPLATE
$pdf_template = file_get_contents( $pdf_template );
$pdf_template = replace_markers($pdf_template,$arrMarkers);
// Mail Template
$mail_template_txt = file_get_contents( $mail_template_txt );
$mail_template_txt = replace_markers($mail_template_txt,$arrMarkers);

//MAIL
// Trenner für multipart mail
$mid = md5( time() );
$filename = "acc-".$rma_num;

// Anhang generieren
include("lib/mpdf56/mpdf.php");
$mpdf=new mPDF('c');
$mpdf->SetDisplayMode('fullpage');
$stylesheet = file_get_contents($pdf_css);
$mpdf->WriteHTML($stylesheet,1); // 1 -> css/style only and no body/html/text
$mpdf->WriteHTML($pdf_template);
$pdf_attachment = chunk_split(base64_encode($mpdf->Output('','S')));

// Mailheader
//$to=$partner_mail;
$to="schlegel@geo-bit.de";
$subject = "Accredited Calibration Request";
$headers .= 'Reply-To: '.$replyto_mail."\r\n";
$headers .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$headers .= 'X-Mailer: PHP/'.phpversion()."\r\n";
$headers .='From: NARDA-STS GmbH <'.$narda_mail.'>'."\r\n";
$headers .= 'Cc:'.$narda_mail."\n";
$headers .= 'Bcc:'.$admin_mail."\n";

$headers .= "MIME-Version: 1.0\r\n";
$headers .= "Content-Type: multipart/mixed; boundary=\"".$mid."\"\r\n\r\n";
$headers .= "This is a multi-part message in MIME format.\r\n";
$headers .= "--".$mid."\r\n";

// Textpart
$headers .= "Content-type:text/plain; charset=iso-8859-1\r\n";
$headers .= "Content-Transfer-Encoding: 7bit\r\n\r\n";
//$headers .= "Content-Type: text/html; charset=UTF-8\r\n";
//$headers .= "Content-Transfer-Encoding: 8bit\r\n\r\n";
$headers .= $mail_template_txt."\r\n\r\n";
$headers .= "--".$mid."\r\n";

//pdf-att
$headers .= "Content-Type: application/pdf; name=\"".$filename."\"\r\n";
$headers .= "Content-Transfer-Encoding: base64\r\n";
$headers .= "Content-Disposition: attachment; filename=\"".$filename."\"\r\n\r\n";
$headers .= $pdf_attachment."\r\n\r\n";
$headers .= "--".$mid."--";

$addParams = '-fnoreply@'.$_SERVER['SERVER_NAME'];
$success = mail($to, $subject, $body, $headers,$addParams);
return $success;
//echo($headers);
}
</pre>

=== E-Mail mit Empfangsbestätigung ===

Eine Empfangsbestätigung verschicken

Das ist genauso einfach wie das verschicken einer ganz einfachen Textmail. Wie wir ja bereits gehört haben, gibt die mail-Funktion bei Erfolg ein TRUE zurück. Damit können wir also feststellen, ob die Nachricht des Benutzers an uns übermittelt wurde und falls ja, schicken wir ihm eine Mail als Bestätigung. Das sieht in etwa so aus:
<pre>
if (@mail( $empfaenger, htmlspecialchars( $betreff ), $mailbody, $mailheader ))
{
// Bei erfolgreichem Versand Danke-Seite anzeigen
$mailheader = "From: Firma Max Mustermann<mustermann@domain.tld>\r\n";
$mailheader .= "Reply-To: Firma Max Mustermann<mustermann@domain.tld>\r\n";
$mailheader .= "Return-Path: noreply@" .$_SERVER['SERVER_NAME']. "\r\n";
$mailheader .= "MIME-Version: 1.0\r\n";
$mailheader .= "Content-Type: text/plain; charset=UTF-8\r\n";
$mailheader .= "Content-Transfer-Encoding: 7bit\r\n";
$mailheader .= "Message-ID: <" .time(). " noreply@" .$_SERVER['SERVER_NAME']. ">\r\n";
$mailheader .= "X-Mailer: PHP v" .phpversion(). "\r\n\r\n";

// Inhalt der Bestätigung
$mailbody = 'Vielen Dank für Ihre Email. Wir werden uns in Kürze bei Ihnen melden.';

// Bestätigung verschicken
if (@mail( $email, "Die Firma Max Mustermann bedankt sich", $mailbody, $mailheader ))
{
// Bestätigung wurde verschickt
}
}
</pre>
Das ist im Prinzip der selbe Code wie zuvor in der Text Mail. Es werden lediglich einige Kleinigkeiten im Mail Header angepasst, damit der Benutzer auch weiß, wer ihm schreibt und wohin er antworten kann.

Damit sollten die meisten Fragen zum Thema "Wie versendet man eine Email mit PHP" geklärt sein. Wer Fragen oder Anregungen hat, kann sie gerne in diesem Thread stellen.

TYPO3 - Extensions mit Extbase programmieren

2014-09-30T11:31:44Z

109.193.152.215: /* Quickstart */

== Links ==
http://docs.typo3.org/typo3cms/extensions/extension_builder/

http://docs.typo3.org/typo3cms/ExtbaseGuide/Extbase/FirstExtbaseExtension.html

== Quickstart ==
=== Extension Builder Installieren ===
=== Domain Modelling ===
* New Model auf Arbeitsfläche ziehen (z.B. Product)
** Object Setting Aggregate Root für das Hauptobjekt
** Default Actions z.B. list und show
** Properties z.b. title, price...
** Relations z.b. categories 1:n ...

* New Model (z.b. Category)
** Diesmal KEIN Aggregate Root

* Verbindungen von den Relations der Haupt Domain auf die Unterdomains ziehen.
* Speichern

=== Extension aktivieren ===
Extension Manager

=== Datensätze anlegen ===
Wie üblich.

TYPO3 - Extensions mit Extbase programmieren

2014-09-30T11:24:23Z

109.193.152.215: /* Domain Modelling */

TYPO3 - Extensions mit Extbase programmieren

2014-09-30T10:26:44Z

109.193.152.215: /* Links */

TYPO3 - Extensions mit Extbase programmieren

2014-09-30T10:25:55Z

109.193.152.215:

== Links ==
http://docs.typo3.org/typo3cms/extensions/extension_builder/

== Quickstart ==
=== Extension Builder Installieren ===
=== Domain Modelling ===

TYPO3 - Extensions mit Extbase programmieren

2014-09-30T09:54:22Z

109.193.152.215: Die Seite wurde neu angelegt: „ == Quickstart == === Extension Builder Installieren === === Domain Modelling ===“

== Quickstart ==
=== Extension Builder Installieren ===
=== Domain Modelling ===

Typo3 - Extensions programmieren

2014-09-30T09:53:01Z

109.193.152.215:

Ab V6 sollte man für Extensions Extbase und das MVC Schema nutzen. Deshalb gibts eine neue Seite:

[[TYPO3 - Extensions mit Extbase programmieren]]

Weiterführende Links:

http://wiki.typo3.org/Extension_Developers_Guide

[[Typo3 - Backend Module programmieren (Extensions)]]

http://typo3.org/documentation/api/

http://wiki.typo3.org/De:Create_your_own_extension

http://typo3.org/documentation/document-library/core-documentation/doc_core_api/4.2.0/view/3/2/#id4144512

(High Priority Functions)

== Templates ==
[[Typo3 Extension Developer Templates]]
== Wie fange ich an ? ==
Was möchtest du tun?
'''Ein vorhandenes Inhaltselement verändern, z.B. Felder hinzufügen oder ein neues Erstellen.'''

[[Typo3 Extensions - Inhaltstypen anlegen und bearbeiten]]

Ein Beispiel dafür ist die Extension metatags die den Inhaltselementen Text mit Bild und Bild zusätzliche Felder für Alt und Title Tag hinzufügt.

== Extensions Programmieren in der Praxis ==
=== TYPO3 Extensions - Links richtig anlegen ===
[[TYPO3 Extensions programmieren - Links]]
=== Typo3 Extensions - Sicherheit ===
[[Typo3 Extensions programmieren - Security Tipps]]
=== JavaScript in Typo3 Extensions ===
[[Typo3 - JavaScript einbinden]]

=== Typo3 und AJAX ===
[[AJAX in TYPO3 Extensions]]

=== TypoScript in Extensions ===
[[TypoScript Einstellungen in Extensions auslagern]]

=== Frontend Plugin ===
[[Typo3 Extensions - ein Frontend Plugin Programmieren]]
=== IRRE ===
[[Typo3 Extensions mit IRRE]]

Das IRRE Konzept hilft beim erstellen von Extensions mit "echten" relationalen Datenbankabfragen
=== FlexForms ===
[[Typo3 Extensions mit FlexForms]]

=== Backendformulare ===
[[Typo3 Extensions - Backend Formulare und TCA Konfiguration]]

siehe auch

http://wiki.zone30.info/wikizone/index.php/Typo3_-_Extensions_programmieren#Formulare_im_Backend

=== Erweitern von Funktionalitäten mit Hooks ===

Ein Beispiel findet sich hier unter Funktionen vor oder nach der Backendeingabe ausführen:

[[Typo3 Extensions - Backend Formulare und TCA Konfiguration]]

Eine schöne Einführung von Typo3 Blogger:
[[Typo3 - Alles über Hooks]]

=== Arbeiten mit Templates ===
[[Typo3 Extensions - Arbeiten mit Templates]]

=== Typo3 Extensions programmieren - Snippets ===
[[Typo3 Extensions programmieren - Snippets]]

=== Typo3 Extensions programmieren - Rich Text Editor (RTE) ===
[[Typo3 Extensions programmieren - RTE]]

=== Typo3 Extensions programmieren - Session Verwaltung ===
Siehe auch Sessions in Typo3

Standardmäßig gibt es Sessions für eingeloggte Frontend User Session und Browser Sessions

Browser Session Variable setzen
$GLOBALS["TSFE"]->fe_user->setKey("ses","zaehler", $wert);
und auslesen:
$GLOBALS["TSFE"]->fe_user->getKey("ses","zaehler");

Bei der User Session wird statt 'ses' 'user' als 1. Parameter verwendet
Beispiele User Session:
<pre>
$this->lastSelection['filters']['sem'] = 0;
//User SEssion Data lesen
$this->lastSelection = $GLOBALS["TSFE"]->fe_user->getKey("user","lastSelection");
// User Session Data schreiben
$GLOBALS["TSFE"]->fe_user->setKey("user","lastSelection",$this->lastSelection);
</pre>

'''Ein weiterer netter Artikel von Tim Lochmüller aus typo3weblog.de'''

Diesmal geht es um die Benutzung der Session in TYPO3. In der Regel genügt nur eine Zeile Code um einen Wert in die Session zu schreiben oder wieder heraus zu holen. Schauen wir uns erstmal an, wie man etwas in die Session schreibt:

$GLOBALS["TSFE"]->fe_user->setKey("ses", "tx_myext", $data);

Die Funktion setKey() erwartet drei Parameter:

# Type: Dieser kann "ses" oder "user" sein.
# Key: Eindeutiger Ident für eine Session Variable
# Data: Die Daten die gespeichert werden sollen.

Die beiden Typen "ses" und "user" unterscheiden sich wesentlich. Während der Typ "ses" nur temporär die Daten speichert, also genau so lange, wie die Session besteht (Session-Cookie), ist es mit dem Key "user" möglich, die Daten auch über mehrere Sessions hinweg zu speichern, wobei diese an den FE-User gekoppelt werden.

Der Key sollte so gewählt werden, dass man nicht in Konflikt mit anderen Extensions kommt. Am besten benutzt man seinen Extension-Key dafür.

Die Daten die man speichern will kann jede beliebige PHP Variable sein, sogar komplette Objekte kann man ablegen.

So, nun wollen wir uns den Wert mal wieder raus holen, auch dies geht sehr schnell und einfach:

$data = $GLOBALS["TSFE"]->fe_user->getKey("ses", "tx_myext");

Die Methode getKey erwartet nur zwei Parameter, die Bedeutung ist die gleiche wie bei setKey().

Das Leben kann so einfach sein, wenn es nicht ab und an diese kleinen fiesen Sonderfälle gibt ;)

Nehmen wir mal an, man erzeugt ein PDF oder eine AJAX-Antwort, dann gibt man das PDF aus und steigt mit einem exit() oder die() aus. In diesen Fällen, reicht ein einfacher Aufruf von setKey() nicht aus. Denn TYPO3 kann dann die Daten nicht automatisch speichern. Aber hier schafft der folgende Code Abhilfe:

$GLOBALS["TSFE"]->fe_user->setKey("ses", "tx_myext", $data);
$GLOBALS["TSFE"]->fe_user->storeSessionData();

Mit storeSessionData() sorgen wir dafür, dass TYPO3 umgehend die Werte speichert. Sehr häufig wird gerade auf die letzte Zeile verzichtet, was in der Regel auch funktioniert, jedoch nur so lange, wie kein Fehler auftritt oder das Script vorzeitig beendet wird.

Fröhliches Session-Handling Euch allen :)

=== Caching in Typo3 Extensions - Cache Mechanismen ===
[[Typo3 - Caching in Extensions]]

=== Typo3 Extensions programmieren - Nützliche Funktionen ===
Aus Adventskalender 2008 typo3blog

Interessante Funktionen aus der Klasse t3lib_div vor.

1. t3lib_div::array2json($data)
Mit dieser Funktion kann man sehr einfach seine Daten in ein JSON Objekt konvertieren. Die Funktion erwartet ein Array mit den Daten, dieses kann beliebig verschachtelt sein. Natürlich gibt es auch noch die PHP native Funktion json_encode, jedoch muss dies von der installierten PHP Installation unterstüzt werden.

2. t3lib_div::convUmlauts($str)
Eine sehr nützliche Funktion ist convUmlauts, welche die deutschen Umlaute konvertiert, dabei wird aus einem Ä eine Ae oder aus einem ü ein ue. Groß und Klein-Schreibung wird also berücksichtigt.

3. t3lib_div::rmFromList($element, $list)
Auch diese Funktion ist sehr nützlich. Möchte man aus einer kommaseparierten Liste ein Element entfernen, ist dies mit einem Funktionsaufruf getan. Gerade bei TYPO3 ist diese Funktion sehr hilfreich, wenn man z.B. eine Benutzergruppe eines FE-Users entfernen möchte.

=== Typo3 Extensions programmieren - Sprachlabels ===
==== Probleme mit Umlauten ====
Bei den Sprachdateien locallang.xml etc. kann es Probleme mit Umlauten geben, wenn die Codierung der Datei nicht mit der der Typo3 Installation zusammen passt. Es funktioniert aber automatisch, wenn man die Codierung der xml Datei im Header angibt angibt. Also oben z.B. reinschreiben:
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
=== Typo3 Extension - Sicherheit ===
[[Typo3 Extensions programmieren - Sicherheit]]

=== Typo3 Extensions - JavaScript Frameworks nutzen ===
Nutzen von jquery, extJS und Konsorten in Typo3
[[Typo3 Extensions - JavaScript Frameworks nutzen]]

== Wichtige Variablen ==
$_EXTKEY
bzw. im Array...
Enthält den Extension Key. Immer die Variable benutzen, dann kann man den Code leichte wieder verwenden.
$TYPO3_CONF_VARS

== Wie arbeitet eine Extension ==
'''Laden:''' Extension Manager (EM) ruft ''ext_emconf.php'' (enthält nur das Array: $EM_CONF[$_EXTKEY]) bei allen Extensions auf die in der localconf.php aufgeführt sind.

'''Aufruf von Backend oder Frontend:''' ''ext_localconf.php'' wird ausgeführt (oder eine gecachete Kopie) In dieser wird die /typo3conf/localconf.php erweitert.
Funktion: weitere Klassen includieren (require_once())

=== Wichtige Dateien einer Extension ===

====ext_emconf.php====
'''Metadaten''' wie Name, Kategorie, Status einer Extension - muß vorhanden sein sonst wird die Extension nicht geladen. Die Informationen landen in $EM_CONF[$_EXTKEY] = ARRAY

==== ext_localconf.php ====
'''TCA Konfiguration für das Backend'''. (Werte für das Array $TYPO3_CONF_VARS). Z.B. Namen der zu ladenden Klassen, statische TSFiles etc.

Wird immer geladen wenn ein Aufruf in Frontend oder Backend erfolgt. Kann deshalb dazu benutzt werden wichtige Klassendaten zu laden oder Skripte zu inkludieren.

Optional - wird genutzt wenn Sie gefunden wird.

==== ext_tables.php ====
Erweiterungen für $'''TCA'''(Table Configuration Array). Beschreibungen von Tabellen und Formularen.

Wird außerdem genutzt um den '''Code von Frontend-Plugins, Modulen oder statischem TypoScript zu laden'''

Optional - wird genutzt wenn Sie gefunden wird.

==== Weitere häufige Dateien ====
ext_tables.sql - SQL Statements für die '''Datenbank-Tabellen''' beim Installieren der Extension.

ext_tables_static+adt.sql - SQL Insert Statements für '''statische Werte in Tabellen''' (z.B. PLZ Liste).

ext_conf_template.txt

tca.php - Anpassungen für '''$TCA,''' Informationen für die Behandlung von Datenbanktabellen

locallang[...].xml und locallang[...].php - '''Sprachdateien''' (Begriffe).

====Typische Unterordner (optional)====
pi1, pi2 - Enthalten Frontend Plugins

mod1, mod2 - Backend Module

sv1, sv2 - Services

=== Wichtige Globale Variablen ===
$_EXTKEY - der Extension Key

=== Formulare im Backend ===
Das '''$TCA''' (Table Configuration Array) bestimmt welche Formularfelder verwendet werden.
Das Array ist in ext_tables.php(Bereiche: ctrl und feinterface s.u.) und tca.php gespeichert

* Jeder Eintrag im $TCA ist an eine Datenbanktabelle geknüpft
* Der erste Index ist der Tabellenname.
* Im zweiten Index gibt es 6 Bereiche:
<pre>
ctrl -> Informationen zur Tabelle
interface -> Konfiguration für die Auflistung und Darstellung im Backend
feInterface -> Eigenschaften für das Frontend Editing
columns -> Informationen zu den Feldtypen der Tabelle und der Verarbeitung der Daten (zweiter Index ist hier der Spaltenname)
types -> legt fest welche der in columns definierten Spalten dargestellt werden und in welcher Reihenfolge,
außerdem Zusatzinfo wie alternative Feldbezeichnung, Palettennummer, style codes...
palettes -> Zum Zusammenfassen von mehreren Eingabefeldern, Zusammenstellungen wiederverwenden, Hilfsfelder definieren
</pre>

=== Daten bearbeiten mit TCE und TCEforms ===
Die im $TCA definierten Daten müssen in irgend einer Form bearbeitet werden. Ein umfangreiches Modul dazu befindet sich in der Extension CMS (typo3/sysext/cms/layout/db_layout.php. DDas Modul greift auf die '''Typo3 Core Engine (TCE)''' zurück, die zum Verarbeiten und Speichern von Daten dient. Die '''Formulare werden mit der Klasse TCEforms''' erzeugt. Bearbeitet wird hierbei im Backend.

Immer dann, wenn man die '''im $TCA eingetragenen Tabellen über Eingabemasken manipulieren''' will ist des sinnvoll die TCE zu nutzen.

t3lib_TCEmain -> t3lib/class.t3lib_tce-main.php
t3lib_TCEforms -> TCEforms

==== Einsatz in Extensions ====
Instanz von t3lib_TCEmain erzeugen:
require_once(PATH_t3lib."class.t3lib_tcemain.php");
$tce=t3lib_div::makeInstance('t3lib_TCEmain');
Arrays für Daten und Kommandos erzeugen:
$data[tabelle][uid][feld] = wert
um neue Daten zu schreiben bevor man eine uid hat belegt man uid mit NEW und einem Zufallsstring z.B. NEWo1amh
$cmd[tabelle][uid][befehl] = wert
dabei stehen verschiedene Befehle zur Verfügung:
copy, move, delete, localize, version, new
Die beiden Arrays werden dann mittels
$tce->start($data,$cmd)
an die TCE übergeben und von
$tce->process_cmdmap()
abgearbeitet.

== Wo finde ich welche Funktionen - Bibliotheken von TYPO3 einbinden und nutzen ==
Oft sucht man nach benötigten Funktionen. Z.B. wenn man im Backend oder über das alternative Rendering (eid) Core Funktionen braucht.
Hier mal ein paar Ansätze zum gucken. Dies ist kein zusammenhängender Code nur ein paar Schnipsel um die Hirnwindungen anzuregen

ToDo
<pre>
require_once(PATH_t3lib.'class.t3lib_page.php');
require_once(PATH_tslib."class.tslib_content.php");
require_once(PATH_t3lib."class.t3lib_stdgraphic.php");
require_once(PATH_tslib."class.tslib_gifbuilder.php");
require_once (PATH_t3lib . 'class.t3lib_htmlmail.php');

$pid = intval(t3lib_div::_GET('pid'));

// create object instances:

//$temp_TSFEclassName = t3lib_div::makeInstanceClassName('tslib_fe');

$TSFE = new $temp_TSFEclassName($TYPO3_CONF_VARS, $page, 0, true);
$TSFE->sys_page = t3lib_div::makeInstance('t3lib_pageSelect');
$TSFE->tmpl = t3lib_div::makeInstance('t3lib_tstemplate');
$TSFE->tmpl->init();

// fetch rootline and extract ts setup:
$TSFE->rootLine = $TSFE->sys_page->getRootLine(intval($pid));
$TSFE->getConfigArray();

// return ts setup array:
$setup = $TSFE->tmpl->setup;
$conf = $setup['plugin.']['tx_rgcarousel_pi1.'];

$myCObj = new tslib_cObj();

</pre>

== Funktionen in Klassendateien auslagern ==
Oft ist es übersichtlicher Funktionen in eigene Dateien auszulagern. Im tt_news Frontend-Plugin wird das z.B. so gemacht.

<pre>
require_once (t3lib_extMgm::extPath('tt_news') . 'lib/class.tx_ttnews_catmenu.php');
require_once (t3lib_extMgm::extPath('tt_news') . 'lib/class.tx_ttnews_helpers.php');
require_once (t3lib_extMgm::extPath('tt_news') . 'lib/class.tx_ttnews_cache.php');
</pre>
Die Klassendateien liegen also im Ordner lib.

Die Dateien enthalten gleichnamige Klassen. Das Objekt dazu wird dann z.B. so erzeugt:
$catTreeObj = t3lib_div::makeInstance('tx_ttnews_catmenu');
Typo3 hat also eine eigene Funktion um die Instanz zu erzeugen. Man muß also nicht mit new arbeiten. Der Vorteil ist mir noch nicht klar. Evtl. wird hier noch etwas anderes ausgeführt etwa um die Klasse zu registrieren o.ä.

Drauf zugegriffen wird dann ganz normal z.B.:
$catTreeObj->init($this);

== Wie kann ich eine eigene Extension debuggen? ==
=== Hilfreiche Extensions zur Entwicklung von Extensions ===
'''devlog''' -> schreibt log Einträge in eine Datenbanktabelle. Dazu ruft man an in seiner Extension die Funktion TODO auf und übergibt die Werte die man loggen will.

''' Extension Development Evaluator (extdeveval) ''' -> Referenzen aufrufen, Autmatisch Funktionsinfos schreiben u.v.m.

=== permalink ===
Wenn man eine eigene Extension schreibt benutzt man zum größten Teil Array, und um den Überblick zu behalten was nach den ganzen schritten in einem Array noch so drin steht hat man die möglichkeit mit einer Funktion das Array schön und sauber in einer tabelle anzeigen zu lassen.

Beispiel:

PHP-Code:
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
t3lib_div::debug($data);
</pre>

Ergebnis:

je nach devIPMask Einstellungen ist auch nur

PHP-Code:

debug();

nützlich, vor allem wenn ein Kundenprojekt Online ist einfach im Installtool und devIpMask deine IP eingeben und dann mit debug(); arbeiten, so kannst nur du den debug sehen und nicht irgendwelche User die grade auf der Site sind.

Kleiner Zusatz Tip:

Ihr lasst euch gleichzeitig mehrere Debugs ausgeben und verliert den überblick welcher debug welcher ist... Beispiel Ihr lasst euch ein Array vor einer funktion debugen und anschliessend...

da habt ihr dann die möglichkeit euerem Debug einen Namen zu geben..

Beispiel:
PHP-Code:
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22);
t3lib_div::debug(,'Array vorher');

$data['Name'] = 'T.uX';
$data['Alter'] = 32;

t3lib_div::debug(,'Array nachher');

Auch bei der Verwendung der integrierten DB-Abstraktionsschicht können eine Reihe von Fehlern auftreten, die teilweise nur sehr magere Fehlermeldungen produzieren. Um eine etwas explizitere Fehlerausgabe zu erzwingen sollte man folgende Zeile in seine Extension integrieren*:

PHP-Code:
$GLOBALS['TYPO3_DB']->debugOutput = true;
So wird z.B. das SQL-Stement Ausgegeben, das zu einem Fehler geführt hat.

== Datenbankabfrage in Extensions ==
[[TYPO3 - Datenbankabfragen in Extensions]]

== Struktur einer Extension ==
===ext_emconf.php===

Informationen und Metadaten zur Extension. Etwa die Infos die im Kickstarter unter General Info stehen.

* Root-Verzeichnis
**'''ext_localconf.php''' Enthält '''Konfigurationsdaten''' ($TYPO3_CONF_VARS) für das Backend und Frontend. Hier kann über die Extension API auch '''TypoScript''' eingebunden werden. Hier können auch Klassendateien aufgerufen werden (require_once() ) die bei jedem Aufruf zur Verfügung stehen sollen.
**'''ext_tables.php''' Konfiguration von '''Datenbanktabellen'''. Plugins und Module über die Extension API einbinden. (Alles über Kickstarter)
**'''ext_tables.sql''' '''SQL-Daten''' für die Tabellendefinition. Die Auswertung erfolgt über den Extension Manager und das Install-Tool.
**'''ext_tables_static+adt.sql''' '''SQL-Tabellendefinition''' inkl. Daten. Z.B. für statische Daten (Länderinfos etc.)Die Tabellen müssen zusätzlich in ext_tables.sql definiert sein.
**'''ext_typoscript_*.txt''' '''Globaler TypoScript-Code'''. Steht nicht üver Template-Datensätze zur Auswahl (siehe /static)
**'''ext_conf_template.txt''' Hier werden '''Optionen zur Konfiguration''' angelegt, die der Benutzer im Extensionmanager einstellen kann.
**'''*icon*.gif''' '''Symbol-Dateien''' für Extension,DB-Tabellen,Plugins, Module...
**'''locallang*.php''' Texte für die '''Lokalisierung''' in verschiedenen Sprachen
**'''class.ext_update.php''' Funktionen für ein '''Update der Extension''' (Beispiel siehe newloginbox).

*'''pi1/''' Verzeichnis für '''Skripte und Daten''' des Plugin
**'''class*.php''' '''PHP-Klassen''' z.B. für Plugins oder Submodule

*'''cm1/''' Verzeichnis für Dateien die das '''Kontext-Menü''' betreffen

*'''mod1/''' Verzeichnis für ein Modul.
**'''conf.php''' Konfigurationsdatei für ein '''Modul''' zum einbinden ins Backend.
**'''index.php''' '''Hauptscript eines Moduls'''.

*'''modfunc1/''' Skripte und Daten für '''Submodul-Funktionen'''

*'''static/''' '''TypoScript-Template'''-Dateien. Diese werden über die Extension-API eingebunden und stehen dann in Template-Datensätzen, ähnlich den Standard Templates zur Auswahl.

*'''sv1/''' Verzeichnis für '''Services'''

*'''res/''' Verzeichnis für beliebige 'recourcen'.

*'''doc/''' Verzeichnis der '''Dokumentation'''.

== Wo werden Extensions installiert ? ==
===typo3/sysext/ (System)===
System Extensions wie cms und lang. Hier können keine Extensions mit dem Extension Manager installiert werden.
===typo3/ext/ - globale Extensions (Global) ===
Z.B. diese die von Typo3 mitgeliefert werden. Mit der Option allowGlobalInstall kann man die Installation in dieses Verzeichnis erlauben. Das ist dann nicht sinnvoll wenn sich mehrere Typo3 WEbsites eine Installation teilen, weil es hier zu Versionskonflikten kommen kann.
===typo3conf/ext - lokale Extensions (Local)===
Hier werden normalerweise alle Extensions installiert. Die Lokale Installation hat immer Vorang vor einer globalen.

== Typolinks richtig in Extensions einsetzen ==

In diesem kurzem Tutorial möchte ich zeigen, wie man Typolinks in eigenen Erweiterungen erstellt, die das
Feature 'Simulate Static Documents' unterstützen und eine Ausgabe erstellen, die von Typo3 gecached wird
und so auch mit der Indexed search verwendet werden können. Diese Informationen wurden aus anderen
Erweiterungen zusammengetragen, speziell aus der Erweiterung tt_board.
Typoscript
Zuerst erstelle in der Datei 'ext_typoscript_setup.txt' eine Eigenschaft, die deiner Erweiterung mitteilt, ob
caching genutzt werden soll oder nicht:

<pre>
plugin.tx_myextension_pi1 {
allowCaching = 1
}
</pre>

Wenn das später auf 0 gesetzt wird, werden diese Seiten nicht mehr gecached.

'''Vorbereitung'''

Bereite in der main() Funktion den Typolink vor und konfiguriere das caching:

<pre>
class tx_myextension_pi1 extends tslib_pibase {
...
var $allowCaching = "";
function main($content,$conf) {
$this->conf=$conf;
...
// Preconfigure the typolink
$this->local_cObj = t3lib_div::makeInstance("tslib_cObj");
$this->local_cObj->setCurrentVal($GLOBALS["TSFE"]->id);
$this->typolink_conf = $this->conf["typolink."];
$this->typolink_conf["parameter."]["current"] = 1;
$this->typolink_conf["additionalParams"] =
$this->cObj->stdWrap($this->typolink_conf["additionalParams"],
$this->typolink_conf["additionalParams."]);
unset($this->typolink_conf["additionalParams."]);
// Configure caching
$this->allowCaching = $this->conf["allowCaching"]?1:0;
if (!$this->allowCaching) {
$GLOBALS["TSFE"]->set_no_cache();
}
...
}
}
Links erstellen
Um nun Links in der Erweiterung zu erstellen, benutze das folgende Code Fragment:
$temp_conf = $this->typolink_conf;
$temp_conf["additionalParams"] .= "&tx_myextension_pi1[key]=value";
$temp_conf["useCacheHash"] = $this->allowCaching;
$temp_conf["no_cache"] = !$this->allowCaching;
$the_link = $this->local_cObj->typolink("Linktext", $temp_conf);
</pre>

Danach kann man '$the_link' zu der Ausgabe hinzufügen. Das '$temp_conf' Array kann man mit allen
Eigenschaften des typolink Objektes erweitern.

Tutorial by typo3.hachmeister.org
Von:fruit-lab.de

== Datei Uploads in Backend Extensions ==
Feld im Kickstarter anlegen. in der tca.php kannst du den uploadfolder festlegen.

Komplizierter wirds in folgendem Fall (aus typo3.net 12-2007)

stimmt schon, dass man da den ordner ändern kann, aber was wenn ich nicht alle dateien in einen ordner speichern will?
ich brauche 2 ordner. einen für normale downloads und in den anderen würden die dateien reinkommen, die kostenpflichtig downzuloaden sind. diesen ordner muss ich also per htaccess schützen. darum wärs nötig, dass der upload-ordner für den späteren redakteur frei wählbar, oder zumindest 2 ordner auswählbar sind.

irgendwelche ideen?

alles kein Problem.

Man kann in der ext_emconf.php unter createDirs die benötigten Verzeichnisse angeben.
Für Fileupload gibts auch einige Typofunktionen die man nutzen kann, so helfen einem folgende Klassen weiter:
t3lib_basicFileFunctions
t3lib_extFileFunctions

== Debug Methode ==
Typo3 | Debug Methode :: Hilfe bei der Programmierung

Wenn man eine eigene Extension schreibt benutzt man zum größten Teil Array, und um den Überblick zu
behalten was nach den ganzen schritten in einem Array noch so drin steht hat man die möglichkeit mit einer Funktion das Array schön und sauber in einer tabelle anzeigen zu lassen.

'''Beispiel:'''
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
echo t3lib_div::debug($data);
</pre>

Ergebnis:

[[Bild:TS_debug01.gif]]

je nach devIPMask Einstellungen ist auch nur
debug($sonstwas);
nützlich, vor allem wenn ein Kundenprojekt Online isteinfach im Installtool und devIpMask deine IP eingeben und dann mit debug($sonstwas); arbeiten, so kannst nur du den debug sehen und nicht irgendwelche User die grade auf der Site sind.

Kleiner Zusatz Tip:

Ihr lasst euch gleichzeitig mehrere Debugs ausgeben und verliert den überblick welcher debug welcher ist...

'''Beispiel'''

Ihr lasst euch ein Array vor einer funktion debugen und anschliessend...
da habt ihr dann die möglichkeit euerem Debug einen Namen zu geben..

'''Beispiel:'''
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
echo t3lib_div::debug($data,'Array vorher');
$data['Name'] = 'T.uX';
$data['Alter'] = 32;
echo t3lib_div::debug($data,'Array nachher');
</pre>

Ergebnis:

[[Bild:TS_debug02.gif]]

Hinweis:
läst du dir eine Variable im debug ausgeben erscheint [b]|debug|[/b]. das funzt nur mit Arrays ;-)
Auch bei der Verwendung der integrierten DB-Abstrktionsschicht können eine Reihe von Fehlern auftreten,
die teilweise nur sehr magere Fehlermeldungen produzieren. Um eine etwas explizitere Fehlerausgabe zu
erzwingen sollte man folgende Zeile in seine Extension integrieren*:
$GLOBALS['TYPO3_DB']->debugOutput = true;

So wird z.B. das SQL-Stement Ausgegeben, das zu einem Fehler geführt hat.
Tutorial by typo3.kj187.de

== PHP-Skripte einbinden ==

=== mit PHP_SCRIPT ===

Im Typo Script:
<pre>
##############################
### temporäres Test Script ###
##############################

temp.phpScript = PHP_SCRIPT
temp.phpScript {
file = demo/test.inc.php
myVerySpecialOwnParameter = Hallo Welt
myParamArray {
a = 2
b = 5
}
}
</pre>
Im Skript text.inc.php
<pre>
<?php
// Use the debug-function to view the config
// array $conf given by TypoScript:
debug( $conf );

$contentArr[] = "Test";
$contentArr[] = $conf['file'];
$contentArr[] = $conf['myVerySpecialOwnParameter'];
$contentArr[] = implode( $conf['myParamArray.'], ', ' );

// Put all your output to $content,
// that TYPO3 will display for you:
$content = implode( $contentArr, '< br />' );
?>
</pre>

=== mit PHP_SCRIPT_EXT ===
Typo3 | Externe PHP Scripte einbinden

Haben Sie ihr Projekt auf Typo3 umgestellt und wollen dennoch ihre eigenen PHP-Scripte verwenden? Dann machen Sie folgendes.

Schreiben Sie in das SETUP Feld des Templates:

<pre>
tt_content.script = CASE
tt_content.script {
key.field = select_key
test = PHP_SCRIPT_EXT
test.file = fileadmin/dein_script.php
}
</pre>

Um das Script jetzt als Contentelement in die Seite einzubinden, legen Sie einen neuen Seiteninhalt an. Wechseln Sie von Typ = Text auf Typ = Skript. In das CODE Feld müssen Sie jetzt nur noch test eintragen und sie sind fertig.

Dies ist die einfachste Methode. Die Ausgabe des Scripts wird aber nicht in den Cache aufgenommen! Diese Funktion wird leider nicht unterstützt.

Tutorial by typo3.kj187.de

Anmerkung Steff: Für die Cache Funktion kann man z.B. eine Einfache Extension basteln.

== Beispiele ==
===Einträge aus Bildausrichtungen im Backend entfernen===
aus cron_cssstyledimgtext
<pre>
<?php
if (!defined ('TYPO3_MODE')) die ('Access denied.');

t3lib_extMgm::addPItoST43($_EXTKEY,'pi1/class.tx_croncssstyledimgtext_pi1.php','_pi1','',1);

$_EXTCONF = unserialize($_EXTCONF);
if ($_EXTCONF['addPageTS']) {
t3lib_extMgm::addPageTSConfig('
TCEFORM.tt_content.imageorient.types.image.removeItems = 8,9,10,17,18,25,26
');
}

$TYPO3_CONF_VARS['FE']['XCLASS']['tslib/class.tslib_content.php']=t3lib_extMgm::extPath($_EXTKEY).'class.ux_tslib_content.php';
?>

</pre>

=== Bilder in eigener Extension rendern ===

In diesem Beispiel benutzte Variablen:
$BildAdresse
$ParameterFuerImgTag
$Alttext

In PHP-Datei der Extension:

$this->conf["imageBeispiel."]["file"]="uploads/pics/".$BildAdresse;
$this->conf["imageBeispiel."]["params"]=$ParameterFuerImgTag;
$this->conf["imageBeispiel."]["altText"]=$Alttext;
$Bild=$this->cObj->IMAGE($this->conf["imageBeispiel."]);
$Content.=$Bild;

In Typoscript Setup

plugin.tx_hoTest_pi1 { //hier Plugin-Name
imageArtikel{
file.maxW = {$ho_Test.BildWidthNews}
imageLinkWrap = 1
imageLinkWrap {
enable = 1
bodyTag = <BODY bgColor=white>
wrap = |
width = 400m
height = 400
JSwindow = 1
JSwindow.newWindow = 1
JSwindow.expand = 17,20
}
}
}

Der Wert {$ho_Test.BildWidthNews} kann aus Constants übernommen werden.

Siehe dazu auch
Konstanten von Constants im Setup verwenden
und
Konstanten für Constant-Editor bereitstellen

(aus www.easy-office4you.de/ 10.1.2006)

=== Spalten der Seiten umbenennen ===

Um die Spalten der Seite im Backend beliebig umzubenennen und/oder zusätzliche eigene Spalten zu verwenden, muß die Extension zed_more_columns installiert werden und dann in der Datei ext_tables.php die Spalten-Namen eingeben werden.

Beispiel:

$TCA["tt_content"]["columns"]["colPos"]["config"]["items"] = array (
"0" => array ("Mitte||Mitte||||||||","0"),
"1" => array ("Links||Links||||||||","1"),
"2" => array ("Rechts||Rechts||||||||","2"),
"3" => array ("Teaser||Teaser||||||||","3"),
"4" => array ("Fusszeile||Fusszeile||||||||","4")
);

== Bei Extension dafür sorgen, daß im Backend kein Sortierungs-Button entsteht ==

In der Datei ext_tables.php der Extension folgende Zeile ändern

"sortby" => "name",

ändern in

"default_sortby" => "ORDER BY name",

Anstatt "name" kann natürlich auch ein anderes Suchkriterium verwendet werden.

== Ausgaben im HTML-Header in Extensions programmieren ==
Manchmal möchte man bestimmte Angaben in den Header schreiben, um zum Beispiel ein JavaScript einzubinden o.ä.

Man könnte im statischen TypoScript für das Objekt page etwas hernehmen. Das funktioniert aber nur wenn das PAGE Objekt auch wirklich page heißt.

Also besser mit einer Typo3 Eigenen Funktion.

'''Beispiel - JavaScript einbinden'''
<pre>
function includeJavaScript() {
$js .= '<script src="'.t3lib_extMgm::siteRelPath($this->extKey).dirname($this->scriptRelPath).'/JS-Verzeichnis/js-file.js" type="text/javascript"></script>';
$GLOBALS['TSFE']->additionalHeaderData[$this->extKey] = $js;
}

//Aufruf der Funktion:
$content=$this->includeJavaScript();
</pre>

Die Variable $this->extKey wird normalerweise immer in der Klassendefinition der Extensiongesetzt und enthält den Namen der Extension (z.B. meineextension)

Für $this->scriptRelPath gilt das gleiche. Hier steht der Pfad ab dem Extension Ordner (z.B. pi1/class.tx_meineExtension_pi1.php)

== Mehrsprachige Extensions ==
Seit der Version 4 hat sich die Vorgehensweise bei der Lokalisierung geändert. Um zu verstehen wie die Lokalisierung von Backend, Frontend etc. funktioniert gibt es hier eine kleine Übersicht:
[[Sprachverwaltung und Lokalisierung in Typo3]]

== $GLOBALS['TSFE'] ==

TSFE ist ein Abbild der Klasse tslib_fe, die kannst Du auch untersuchen.

Typo3 - Extensions programmieren

2014-09-30T09:52:32Z

109.193.152.215:

Ab V6 sollte man für Extensions Extbase und das MVC Schema nutzen. Deshalb gibts eine neue Seite:

TYPO3 - Extensions mit Extbase

Weiterführende Links:

http://wiki.typo3.org/Extension_Developers_Guide

[[Typo3 - Backend Module programmieren (Extensions)]]

http://typo3.org/documentation/api/

http://wiki.typo3.org/De:Create_your_own_extension

http://typo3.org/documentation/document-library/core-documentation/doc_core_api/4.2.0/view/3/2/#id4144512

(High Priority Functions)

== Templates ==
[[Typo3 Extension Developer Templates]]
== Wie fange ich an ? ==
Was möchtest du tun?
'''Ein vorhandenes Inhaltselement verändern, z.B. Felder hinzufügen oder ein neues Erstellen.'''

[[Typo3 Extensions - Inhaltstypen anlegen und bearbeiten]]

Ein Beispiel dafür ist die Extension metatags die den Inhaltselementen Text mit Bild und Bild zusätzliche Felder für Alt und Title Tag hinzufügt.

== Extensions Programmieren in der Praxis ==
=== TYPO3 Extensions - Links richtig anlegen ===
[[TYPO3 Extensions programmieren - Links]]
=== Typo3 Extensions - Sicherheit ===
[[Typo3 Extensions programmieren - Security Tipps]]
=== JavaScript in Typo3 Extensions ===
[[Typo3 - JavaScript einbinden]]

=== Typo3 und AJAX ===
[[AJAX in TYPO3 Extensions]]

=== TypoScript in Extensions ===
[[TypoScript Einstellungen in Extensions auslagern]]

=== Frontend Plugin ===
[[Typo3 Extensions - ein Frontend Plugin Programmieren]]
=== IRRE ===
[[Typo3 Extensions mit IRRE]]

Das IRRE Konzept hilft beim erstellen von Extensions mit "echten" relationalen Datenbankabfragen
=== FlexForms ===
[[Typo3 Extensions mit FlexForms]]

=== Backendformulare ===
[[Typo3 Extensions - Backend Formulare und TCA Konfiguration]]

siehe auch

http://wiki.zone30.info/wikizone/index.php/Typo3_-_Extensions_programmieren#Formulare_im_Backend

=== Erweitern von Funktionalitäten mit Hooks ===

Ein Beispiel findet sich hier unter Funktionen vor oder nach der Backendeingabe ausführen:

[[Typo3 Extensions - Backend Formulare und TCA Konfiguration]]

Eine schöne Einführung von Typo3 Blogger:
[[Typo3 - Alles über Hooks]]

=== Arbeiten mit Templates ===
[[Typo3 Extensions - Arbeiten mit Templates]]

=== Typo3 Extensions programmieren - Snippets ===
[[Typo3 Extensions programmieren - Snippets]]

=== Typo3 Extensions programmieren - Rich Text Editor (RTE) ===
[[Typo3 Extensions programmieren - RTE]]

=== Typo3 Extensions programmieren - Session Verwaltung ===
Siehe auch Sessions in Typo3

Standardmäßig gibt es Sessions für eingeloggte Frontend User Session und Browser Sessions

Browser Session Variable setzen
$GLOBALS["TSFE"]->fe_user->setKey("ses","zaehler", $wert);
und auslesen:
$GLOBALS["TSFE"]->fe_user->getKey("ses","zaehler");

Bei der User Session wird statt 'ses' 'user' als 1. Parameter verwendet
Beispiele User Session:
<pre>
$this->lastSelection['filters']['sem'] = 0;
//User SEssion Data lesen
$this->lastSelection = $GLOBALS["TSFE"]->fe_user->getKey("user","lastSelection");
// User Session Data schreiben
$GLOBALS["TSFE"]->fe_user->setKey("user","lastSelection",$this->lastSelection);
</pre>

'''Ein weiterer netter Artikel von Tim Lochmüller aus typo3weblog.de'''

Diesmal geht es um die Benutzung der Session in TYPO3. In der Regel genügt nur eine Zeile Code um einen Wert in die Session zu schreiben oder wieder heraus zu holen. Schauen wir uns erstmal an, wie man etwas in die Session schreibt:

$GLOBALS["TSFE"]->fe_user->setKey("ses", "tx_myext", $data);

Die Funktion setKey() erwartet drei Parameter:

# Type: Dieser kann "ses" oder "user" sein.
# Key: Eindeutiger Ident für eine Session Variable
# Data: Die Daten die gespeichert werden sollen.

Die beiden Typen "ses" und "user" unterscheiden sich wesentlich. Während der Typ "ses" nur temporär die Daten speichert, also genau so lange, wie die Session besteht (Session-Cookie), ist es mit dem Key "user" möglich, die Daten auch über mehrere Sessions hinweg zu speichern, wobei diese an den FE-User gekoppelt werden.

Der Key sollte so gewählt werden, dass man nicht in Konflikt mit anderen Extensions kommt. Am besten benutzt man seinen Extension-Key dafür.

Die Daten die man speichern will kann jede beliebige PHP Variable sein, sogar komplette Objekte kann man ablegen.

So, nun wollen wir uns den Wert mal wieder raus holen, auch dies geht sehr schnell und einfach:

$data = $GLOBALS["TSFE"]->fe_user->getKey("ses", "tx_myext");

Die Methode getKey erwartet nur zwei Parameter, die Bedeutung ist die gleiche wie bei setKey().

Das Leben kann so einfach sein, wenn es nicht ab und an diese kleinen fiesen Sonderfälle gibt ;)

Nehmen wir mal an, man erzeugt ein PDF oder eine AJAX-Antwort, dann gibt man das PDF aus und steigt mit einem exit() oder die() aus. In diesen Fällen, reicht ein einfacher Aufruf von setKey() nicht aus. Denn TYPO3 kann dann die Daten nicht automatisch speichern. Aber hier schafft der folgende Code Abhilfe:

$GLOBALS["TSFE"]->fe_user->setKey("ses", "tx_myext", $data);
$GLOBALS["TSFE"]->fe_user->storeSessionData();

Mit storeSessionData() sorgen wir dafür, dass TYPO3 umgehend die Werte speichert. Sehr häufig wird gerade auf die letzte Zeile verzichtet, was in der Regel auch funktioniert, jedoch nur so lange, wie kein Fehler auftritt oder das Script vorzeitig beendet wird.

Fröhliches Session-Handling Euch allen :)

=== Caching in Typo3 Extensions - Cache Mechanismen ===
[[Typo3 - Caching in Extensions]]

=== Typo3 Extensions programmieren - Nützliche Funktionen ===
Aus Adventskalender 2008 typo3blog

Interessante Funktionen aus der Klasse t3lib_div vor.

1. t3lib_div::array2json($data)
Mit dieser Funktion kann man sehr einfach seine Daten in ein JSON Objekt konvertieren. Die Funktion erwartet ein Array mit den Daten, dieses kann beliebig verschachtelt sein. Natürlich gibt es auch noch die PHP native Funktion json_encode, jedoch muss dies von der installierten PHP Installation unterstüzt werden.

2. t3lib_div::convUmlauts($str)
Eine sehr nützliche Funktion ist convUmlauts, welche die deutschen Umlaute konvertiert, dabei wird aus einem Ä eine Ae oder aus einem ü ein ue. Groß und Klein-Schreibung wird also berücksichtigt.

3. t3lib_div::rmFromList($element, $list)
Auch diese Funktion ist sehr nützlich. Möchte man aus einer kommaseparierten Liste ein Element entfernen, ist dies mit einem Funktionsaufruf getan. Gerade bei TYPO3 ist diese Funktion sehr hilfreich, wenn man z.B. eine Benutzergruppe eines FE-Users entfernen möchte.

=== Typo3 Extensions programmieren - Sprachlabels ===
==== Probleme mit Umlauten ====
Bei den Sprachdateien locallang.xml etc. kann es Probleme mit Umlauten geben, wenn die Codierung der Datei nicht mit der der Typo3 Installation zusammen passt. Es funktioniert aber automatisch, wenn man die Codierung der xml Datei im Header angibt angibt. Also oben z.B. reinschreiben:
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
=== Typo3 Extension - Sicherheit ===
[[Typo3 Extensions programmieren - Sicherheit]]

=== Typo3 Extensions - JavaScript Frameworks nutzen ===
Nutzen von jquery, extJS und Konsorten in Typo3
[[Typo3 Extensions - JavaScript Frameworks nutzen]]

== Wichtige Variablen ==
$_EXTKEY
bzw. im Array...
Enthält den Extension Key. Immer die Variable benutzen, dann kann man den Code leichte wieder verwenden.
$TYPO3_CONF_VARS

== Wie arbeitet eine Extension ==
'''Laden:''' Extension Manager (EM) ruft ''ext_emconf.php'' (enthält nur das Array: $EM_CONF[$_EXTKEY]) bei allen Extensions auf die in der localconf.php aufgeführt sind.

'''Aufruf von Backend oder Frontend:''' ''ext_localconf.php'' wird ausgeführt (oder eine gecachete Kopie) In dieser wird die /typo3conf/localconf.php erweitert.
Funktion: weitere Klassen includieren (require_once())

=== Wichtige Dateien einer Extension ===

====ext_emconf.php====
'''Metadaten''' wie Name, Kategorie, Status einer Extension - muß vorhanden sein sonst wird die Extension nicht geladen. Die Informationen landen in $EM_CONF[$_EXTKEY] = ARRAY

==== ext_localconf.php ====
'''TCA Konfiguration für das Backend'''. (Werte für das Array $TYPO3_CONF_VARS). Z.B. Namen der zu ladenden Klassen, statische TSFiles etc.

Wird immer geladen wenn ein Aufruf in Frontend oder Backend erfolgt. Kann deshalb dazu benutzt werden wichtige Klassendaten zu laden oder Skripte zu inkludieren.

Optional - wird genutzt wenn Sie gefunden wird.

==== ext_tables.php ====
Erweiterungen für $'''TCA'''(Table Configuration Array). Beschreibungen von Tabellen und Formularen.

Wird außerdem genutzt um den '''Code von Frontend-Plugins, Modulen oder statischem TypoScript zu laden'''

Optional - wird genutzt wenn Sie gefunden wird.

==== Weitere häufige Dateien ====
ext_tables.sql - SQL Statements für die '''Datenbank-Tabellen''' beim Installieren der Extension.

ext_tables_static+adt.sql - SQL Insert Statements für '''statische Werte in Tabellen''' (z.B. PLZ Liste).

ext_conf_template.txt

tca.php - Anpassungen für '''$TCA,''' Informationen für die Behandlung von Datenbanktabellen

locallang[...].xml und locallang[...].php - '''Sprachdateien''' (Begriffe).

====Typische Unterordner (optional)====
pi1, pi2 - Enthalten Frontend Plugins

mod1, mod2 - Backend Module

sv1, sv2 - Services

=== Wichtige Globale Variablen ===
$_EXTKEY - der Extension Key

=== Formulare im Backend ===
Das '''$TCA''' (Table Configuration Array) bestimmt welche Formularfelder verwendet werden.
Das Array ist in ext_tables.php(Bereiche: ctrl und feinterface s.u.) und tca.php gespeichert

* Jeder Eintrag im $TCA ist an eine Datenbanktabelle geknüpft
* Der erste Index ist der Tabellenname.
* Im zweiten Index gibt es 6 Bereiche:
<pre>
ctrl -> Informationen zur Tabelle
interface -> Konfiguration für die Auflistung und Darstellung im Backend
feInterface -> Eigenschaften für das Frontend Editing
columns -> Informationen zu den Feldtypen der Tabelle und der Verarbeitung der Daten (zweiter Index ist hier der Spaltenname)
types -> legt fest welche der in columns definierten Spalten dargestellt werden und in welcher Reihenfolge,
außerdem Zusatzinfo wie alternative Feldbezeichnung, Palettennummer, style codes...
palettes -> Zum Zusammenfassen von mehreren Eingabefeldern, Zusammenstellungen wiederverwenden, Hilfsfelder definieren
</pre>

=== Daten bearbeiten mit TCE und TCEforms ===
Die im $TCA definierten Daten müssen in irgend einer Form bearbeitet werden. Ein umfangreiches Modul dazu befindet sich in der Extension CMS (typo3/sysext/cms/layout/db_layout.php. DDas Modul greift auf die '''Typo3 Core Engine (TCE)''' zurück, die zum Verarbeiten und Speichern von Daten dient. Die '''Formulare werden mit der Klasse TCEforms''' erzeugt. Bearbeitet wird hierbei im Backend.

Immer dann, wenn man die '''im $TCA eingetragenen Tabellen über Eingabemasken manipulieren''' will ist des sinnvoll die TCE zu nutzen.

t3lib_TCEmain -> t3lib/class.t3lib_tce-main.php
t3lib_TCEforms -> TCEforms

==== Einsatz in Extensions ====
Instanz von t3lib_TCEmain erzeugen:
require_once(PATH_t3lib."class.t3lib_tcemain.php");
$tce=t3lib_div::makeInstance('t3lib_TCEmain');
Arrays für Daten und Kommandos erzeugen:
$data[tabelle][uid][feld] = wert
um neue Daten zu schreiben bevor man eine uid hat belegt man uid mit NEW und einem Zufallsstring z.B. NEWo1amh
$cmd[tabelle][uid][befehl] = wert
dabei stehen verschiedene Befehle zur Verfügung:
copy, move, delete, localize, version, new
Die beiden Arrays werden dann mittels
$tce->start($data,$cmd)
an die TCE übergeben und von
$tce->process_cmdmap()
abgearbeitet.

== Wo finde ich welche Funktionen - Bibliotheken von TYPO3 einbinden und nutzen ==
Oft sucht man nach benötigten Funktionen. Z.B. wenn man im Backend oder über das alternative Rendering (eid) Core Funktionen braucht.
Hier mal ein paar Ansätze zum gucken. Dies ist kein zusammenhängender Code nur ein paar Schnipsel um die Hirnwindungen anzuregen

ToDo
<pre>
require_once(PATH_t3lib.'class.t3lib_page.php');
require_once(PATH_tslib."class.tslib_content.php");
require_once(PATH_t3lib."class.t3lib_stdgraphic.php");
require_once(PATH_tslib."class.tslib_gifbuilder.php");
require_once (PATH_t3lib . 'class.t3lib_htmlmail.php');

$pid = intval(t3lib_div::_GET('pid'));

// create object instances:

//$temp_TSFEclassName = t3lib_div::makeInstanceClassName('tslib_fe');

$TSFE = new $temp_TSFEclassName($TYPO3_CONF_VARS, $page, 0, true);
$TSFE->sys_page = t3lib_div::makeInstance('t3lib_pageSelect');
$TSFE->tmpl = t3lib_div::makeInstance('t3lib_tstemplate');
$TSFE->tmpl->init();

// fetch rootline and extract ts setup:
$TSFE->rootLine = $TSFE->sys_page->getRootLine(intval($pid));
$TSFE->getConfigArray();

// return ts setup array:
$setup = $TSFE->tmpl->setup;
$conf = $setup['plugin.']['tx_rgcarousel_pi1.'];

$myCObj = new tslib_cObj();

</pre>

== Funktionen in Klassendateien auslagern ==
Oft ist es übersichtlicher Funktionen in eigene Dateien auszulagern. Im tt_news Frontend-Plugin wird das z.B. so gemacht.

<pre>
require_once (t3lib_extMgm::extPath('tt_news') . 'lib/class.tx_ttnews_catmenu.php');
require_once (t3lib_extMgm::extPath('tt_news') . 'lib/class.tx_ttnews_helpers.php');
require_once (t3lib_extMgm::extPath('tt_news') . 'lib/class.tx_ttnews_cache.php');
</pre>
Die Klassendateien liegen also im Ordner lib.

Die Dateien enthalten gleichnamige Klassen. Das Objekt dazu wird dann z.B. so erzeugt:
$catTreeObj = t3lib_div::makeInstance('tx_ttnews_catmenu');
Typo3 hat also eine eigene Funktion um die Instanz zu erzeugen. Man muß also nicht mit new arbeiten. Der Vorteil ist mir noch nicht klar. Evtl. wird hier noch etwas anderes ausgeführt etwa um die Klasse zu registrieren o.ä.

Drauf zugegriffen wird dann ganz normal z.B.:
$catTreeObj->init($this);

== Wie kann ich eine eigene Extension debuggen? ==
=== Hilfreiche Extensions zur Entwicklung von Extensions ===
'''devlog''' -> schreibt log Einträge in eine Datenbanktabelle. Dazu ruft man an in seiner Extension die Funktion TODO auf und übergibt die Werte die man loggen will.

''' Extension Development Evaluator (extdeveval) ''' -> Referenzen aufrufen, Autmatisch Funktionsinfos schreiben u.v.m.

=== permalink ===
Wenn man eine eigene Extension schreibt benutzt man zum größten Teil Array, und um den Überblick zu behalten was nach den ganzen schritten in einem Array noch so drin steht hat man die möglichkeit mit einer Funktion das Array schön und sauber in einer tabelle anzeigen zu lassen.

Beispiel:

PHP-Code:
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
t3lib_div::debug($data);
</pre>

Ergebnis:

je nach devIPMask Einstellungen ist auch nur

PHP-Code:

debug();

nützlich, vor allem wenn ein Kundenprojekt Online ist einfach im Installtool und devIpMask deine IP eingeben und dann mit debug(); arbeiten, so kannst nur du den debug sehen und nicht irgendwelche User die grade auf der Site sind.

Kleiner Zusatz Tip:

Ihr lasst euch gleichzeitig mehrere Debugs ausgeben und verliert den überblick welcher debug welcher ist... Beispiel Ihr lasst euch ein Array vor einer funktion debugen und anschliessend...

da habt ihr dann die möglichkeit euerem Debug einen Namen zu geben..

Beispiel:
PHP-Code:
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22);
t3lib_div::debug(,'Array vorher');

$data['Name'] = 'T.uX';
$data['Alter'] = 32;

t3lib_div::debug(,'Array nachher');

Auch bei der Verwendung der integrierten DB-Abstraktionsschicht können eine Reihe von Fehlern auftreten, die teilweise nur sehr magere Fehlermeldungen produzieren. Um eine etwas explizitere Fehlerausgabe zu erzwingen sollte man folgende Zeile in seine Extension integrieren*:

PHP-Code:
$GLOBALS['TYPO3_DB']->debugOutput = true;
So wird z.B. das SQL-Stement Ausgegeben, das zu einem Fehler geführt hat.

== Datenbankabfrage in Extensions ==
[[TYPO3 - Datenbankabfragen in Extensions]]

== Struktur einer Extension ==
===ext_emconf.php===

Informationen und Metadaten zur Extension. Etwa die Infos die im Kickstarter unter General Info stehen.

* Root-Verzeichnis
**'''ext_localconf.php''' Enthält '''Konfigurationsdaten''' ($TYPO3_CONF_VARS) für das Backend und Frontend. Hier kann über die Extension API auch '''TypoScript''' eingebunden werden. Hier können auch Klassendateien aufgerufen werden (require_once() ) die bei jedem Aufruf zur Verfügung stehen sollen.
**'''ext_tables.php''' Konfiguration von '''Datenbanktabellen'''. Plugins und Module über die Extension API einbinden. (Alles über Kickstarter)
**'''ext_tables.sql''' '''SQL-Daten''' für die Tabellendefinition. Die Auswertung erfolgt über den Extension Manager und das Install-Tool.
**'''ext_tables_static+adt.sql''' '''SQL-Tabellendefinition''' inkl. Daten. Z.B. für statische Daten (Länderinfos etc.)Die Tabellen müssen zusätzlich in ext_tables.sql definiert sein.
**'''ext_typoscript_*.txt''' '''Globaler TypoScript-Code'''. Steht nicht üver Template-Datensätze zur Auswahl (siehe /static)
**'''ext_conf_template.txt''' Hier werden '''Optionen zur Konfiguration''' angelegt, die der Benutzer im Extensionmanager einstellen kann.
**'''*icon*.gif''' '''Symbol-Dateien''' für Extension,DB-Tabellen,Plugins, Module...
**'''locallang*.php''' Texte für die '''Lokalisierung''' in verschiedenen Sprachen
**'''class.ext_update.php''' Funktionen für ein '''Update der Extension''' (Beispiel siehe newloginbox).

*'''pi1/''' Verzeichnis für '''Skripte und Daten''' des Plugin
**'''class*.php''' '''PHP-Klassen''' z.B. für Plugins oder Submodule

*'''cm1/''' Verzeichnis für Dateien die das '''Kontext-Menü''' betreffen

*'''mod1/''' Verzeichnis für ein Modul.
**'''conf.php''' Konfigurationsdatei für ein '''Modul''' zum einbinden ins Backend.
**'''index.php''' '''Hauptscript eines Moduls'''.

*'''modfunc1/''' Skripte und Daten für '''Submodul-Funktionen'''

*'''static/''' '''TypoScript-Template'''-Dateien. Diese werden über die Extension-API eingebunden und stehen dann in Template-Datensätzen, ähnlich den Standard Templates zur Auswahl.

*'''sv1/''' Verzeichnis für '''Services'''

*'''res/''' Verzeichnis für beliebige 'recourcen'.

*'''doc/''' Verzeichnis der '''Dokumentation'''.

== Wo werden Extensions installiert ? ==
===typo3/sysext/ (System)===
System Extensions wie cms und lang. Hier können keine Extensions mit dem Extension Manager installiert werden.
===typo3/ext/ - globale Extensions (Global) ===
Z.B. diese die von Typo3 mitgeliefert werden. Mit der Option allowGlobalInstall kann man die Installation in dieses Verzeichnis erlauben. Das ist dann nicht sinnvoll wenn sich mehrere Typo3 WEbsites eine Installation teilen, weil es hier zu Versionskonflikten kommen kann.
===typo3conf/ext - lokale Extensions (Local)===
Hier werden normalerweise alle Extensions installiert. Die Lokale Installation hat immer Vorang vor einer globalen.

== Typolinks richtig in Extensions einsetzen ==

In diesem kurzem Tutorial möchte ich zeigen, wie man Typolinks in eigenen Erweiterungen erstellt, die das
Feature 'Simulate Static Documents' unterstützen und eine Ausgabe erstellen, die von Typo3 gecached wird
und so auch mit der Indexed search verwendet werden können. Diese Informationen wurden aus anderen
Erweiterungen zusammengetragen, speziell aus der Erweiterung tt_board.
Typoscript
Zuerst erstelle in der Datei 'ext_typoscript_setup.txt' eine Eigenschaft, die deiner Erweiterung mitteilt, ob
caching genutzt werden soll oder nicht:

<pre>
plugin.tx_myextension_pi1 {
allowCaching = 1
}
</pre>

Wenn das später auf 0 gesetzt wird, werden diese Seiten nicht mehr gecached.

'''Vorbereitung'''

Bereite in der main() Funktion den Typolink vor und konfiguriere das caching:

<pre>
class tx_myextension_pi1 extends tslib_pibase {
...
var $allowCaching = "";
function main($content,$conf) {
$this->conf=$conf;
...
// Preconfigure the typolink
$this->local_cObj = t3lib_div::makeInstance("tslib_cObj");
$this->local_cObj->setCurrentVal($GLOBALS["TSFE"]->id);
$this->typolink_conf = $this->conf["typolink."];
$this->typolink_conf["parameter."]["current"] = 1;
$this->typolink_conf["additionalParams"] =
$this->cObj->stdWrap($this->typolink_conf["additionalParams"],
$this->typolink_conf["additionalParams."]);
unset($this->typolink_conf["additionalParams."]);
// Configure caching
$this->allowCaching = $this->conf["allowCaching"]?1:0;
if (!$this->allowCaching) {
$GLOBALS["TSFE"]->set_no_cache();
}
...
}
}
Links erstellen
Um nun Links in der Erweiterung zu erstellen, benutze das folgende Code Fragment:
$temp_conf = $this->typolink_conf;
$temp_conf["additionalParams"] .= "&tx_myextension_pi1[key]=value";
$temp_conf["useCacheHash"] = $this->allowCaching;
$temp_conf["no_cache"] = !$this->allowCaching;
$the_link = $this->local_cObj->typolink("Linktext", $temp_conf);
</pre>

Danach kann man '$the_link' zu der Ausgabe hinzufügen. Das '$temp_conf' Array kann man mit allen
Eigenschaften des typolink Objektes erweitern.

Tutorial by typo3.hachmeister.org
Von:fruit-lab.de

== Datei Uploads in Backend Extensions ==
Feld im Kickstarter anlegen. in der tca.php kannst du den uploadfolder festlegen.

Komplizierter wirds in folgendem Fall (aus typo3.net 12-2007)

stimmt schon, dass man da den ordner ändern kann, aber was wenn ich nicht alle dateien in einen ordner speichern will?
ich brauche 2 ordner. einen für normale downloads und in den anderen würden die dateien reinkommen, die kostenpflichtig downzuloaden sind. diesen ordner muss ich also per htaccess schützen. darum wärs nötig, dass der upload-ordner für den späteren redakteur frei wählbar, oder zumindest 2 ordner auswählbar sind.

irgendwelche ideen?

alles kein Problem.

Man kann in der ext_emconf.php unter createDirs die benötigten Verzeichnisse angeben.
Für Fileupload gibts auch einige Typofunktionen die man nutzen kann, so helfen einem folgende Klassen weiter:
t3lib_basicFileFunctions
t3lib_extFileFunctions

== Debug Methode ==
Typo3 | Debug Methode :: Hilfe bei der Programmierung

Wenn man eine eigene Extension schreibt benutzt man zum größten Teil Array, und um den Überblick zu
behalten was nach den ganzen schritten in einem Array noch so drin steht hat man die möglichkeit mit einer Funktion das Array schön und sauber in einer tabelle anzeigen zu lassen.

'''Beispiel:'''
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
echo t3lib_div::debug($data);
</pre>

Ergebnis:

[[Bild:TS_debug01.gif]]

je nach devIPMask Einstellungen ist auch nur
debug($sonstwas);
nützlich, vor allem wenn ein Kundenprojekt Online isteinfach im Installtool und devIpMask deine IP eingeben und dann mit debug($sonstwas); arbeiten, so kannst nur du den debug sehen und nicht irgendwelche User die grade auf der Site sind.

Kleiner Zusatz Tip:

Ihr lasst euch gleichzeitig mehrere Debugs ausgeben und verliert den überblick welcher debug welcher ist...

'''Beispiel'''

Ihr lasst euch ein Array vor einer funktion debugen und anschliessend...
da habt ihr dann die möglichkeit euerem Debug einen Namen zu geben..

'''Beispiel:'''
<pre>
$data = array("Name" => "Peter KeineAhnung", "Alter" => 22, "Wohnort" => "Ratingen");
echo t3lib_div::debug($data,'Array vorher');
$data['Name'] = 'T.uX';
$data['Alter'] = 32;
echo t3lib_div::debug($data,'Array nachher');
</pre>

Ergebnis:

[[Bild:TS_debug02.gif]]

Hinweis:
läst du dir eine Variable im debug ausgeben erscheint [b]|debug|[/b]. das funzt nur mit Arrays ;-)
Auch bei der Verwendung der integrierten DB-Abstrktionsschicht können eine Reihe von Fehlern auftreten,
die teilweise nur sehr magere Fehlermeldungen produzieren. Um eine etwas explizitere Fehlerausgabe zu
erzwingen sollte man folgende Zeile in seine Extension integrieren*:
$GLOBALS['TYPO3_DB']->debugOutput = true;

So wird z.B. das SQL-Stement Ausgegeben, das zu einem Fehler geführt hat.
Tutorial by typo3.kj187.de

== PHP-Skripte einbinden ==

=== mit PHP_SCRIPT ===

Im Typo Script:
<pre>
##############################
### temporäres Test Script ###
##############################

temp.phpScript = PHP_SCRIPT
temp.phpScript {
file = demo/test.inc.php
myVerySpecialOwnParameter = Hallo Welt
myParamArray {
a = 2
b = 5
}
}
</pre>
Im Skript text.inc.php
<pre>
<?php
// Use the debug-function to view the config
// array $conf given by TypoScript:
debug( $conf );

$contentArr[] = "Test";
$contentArr[] = $conf['file'];
$contentArr[] = $conf['myVerySpecialOwnParameter'];
$contentArr[] = implode( $conf['myParamArray.'], ', ' );

// Put all your output to $content,
// that TYPO3 will display for you:
$content = implode( $contentArr, '< br />' );
?>
</pre>

=== mit PHP_SCRIPT_EXT ===
Typo3 | Externe PHP Scripte einbinden

Haben Sie ihr Projekt auf Typo3 umgestellt und wollen dennoch ihre eigenen PHP-Scripte verwenden? Dann machen Sie folgendes.

Schreiben Sie in das SETUP Feld des Templates:

<pre>
tt_content.script = CASE
tt_content.script {
key.field = select_key
test = PHP_SCRIPT_EXT
test.file = fileadmin/dein_script.php
}
</pre>

Um das Script jetzt als Contentelement in die Seite einzubinden, legen Sie einen neuen Seiteninhalt an. Wechseln Sie von Typ = Text auf Typ = Skript. In das CODE Feld müssen Sie jetzt nur noch test eintragen und sie sind fertig.

Dies ist die einfachste Methode. Die Ausgabe des Scripts wird aber nicht in den Cache aufgenommen! Diese Funktion wird leider nicht unterstützt.

Tutorial by typo3.kj187.de

Anmerkung Steff: Für die Cache Funktion kann man z.B. eine Einfache Extension basteln.

== Beispiele ==
===Einträge aus Bildausrichtungen im Backend entfernen===
aus cron_cssstyledimgtext
<pre>
<?php
if (!defined ('TYPO3_MODE')) die ('Access denied.');

t3lib_extMgm::addPItoST43($_EXTKEY,'pi1/class.tx_croncssstyledimgtext_pi1.php','_pi1','',1);

$_EXTCONF = unserialize($_EXTCONF);
if ($_EXTCONF['addPageTS']) {
t3lib_extMgm::addPageTSConfig('
TCEFORM.tt_content.imageorient.types.image.removeItems = 8,9,10,17,18,25,26
');
}

$TYPO3_CONF_VARS['FE']['XCLASS']['tslib/class.tslib_content.php']=t3lib_extMgm::extPath($_EXTKEY).'class.ux_tslib_content.php';
?>

</pre>

=== Bilder in eigener Extension rendern ===

In diesem Beispiel benutzte Variablen:
$BildAdresse
$ParameterFuerImgTag
$Alttext

In PHP-Datei der Extension:

$this->conf["imageBeispiel."]["file"]="uploads/pics/".$BildAdresse;
$this->conf["imageBeispiel."]["params"]=$ParameterFuerImgTag;
$this->conf["imageBeispiel."]["altText"]=$Alttext;
$Bild=$this->cObj->IMAGE($this->conf["imageBeispiel."]);
$Content.=$Bild;

In Typoscript Setup

plugin.tx_hoTest_pi1 { //hier Plugin-Name
imageArtikel{
file.maxW = {$ho_Test.BildWidthNews}
imageLinkWrap = 1
imageLinkWrap {
enable = 1
bodyTag = <BODY bgColor=white>
wrap = |
width = 400m
height = 400
JSwindow = 1
JSwindow.newWindow = 1
JSwindow.expand = 17,20
}
}
}

Der Wert {$ho_Test.BildWidthNews} kann aus Constants übernommen werden.

Siehe dazu auch
Konstanten von Constants im Setup verwenden
und
Konstanten für Constant-Editor bereitstellen

(aus www.easy-office4you.de/ 10.1.2006)

=== Spalten der Seiten umbenennen ===

Um die Spalten der Seite im Backend beliebig umzubenennen und/oder zusätzliche eigene Spalten zu verwenden, muß die Extension zed_more_columns installiert werden und dann in der Datei ext_tables.php die Spalten-Namen eingeben werden.

Beispiel:

$TCA["tt_content"]["columns"]["colPos"]["config"]["items"] = array (
"0" => array ("Mitte||Mitte||||||||","0"),
"1" => array ("Links||Links||||||||","1"),
"2" => array ("Rechts||Rechts||||||||","2"),
"3" => array ("Teaser||Teaser||||||||","3"),
"4" => array ("Fusszeile||Fusszeile||||||||","4")
);

== Bei Extension dafür sorgen, daß im Backend kein Sortierungs-Button entsteht ==

In der Datei ext_tables.php der Extension folgende Zeile ändern

"sortby" => "name",

ändern in

"default_sortby" => "ORDER BY name",

Anstatt "name" kann natürlich auch ein anderes Suchkriterium verwendet werden.

== Ausgaben im HTML-Header in Extensions programmieren ==
Manchmal möchte man bestimmte Angaben in den Header schreiben, um zum Beispiel ein JavaScript einzubinden o.ä.

Man könnte im statischen TypoScript für das Objekt page etwas hernehmen. Das funktioniert aber nur wenn das PAGE Objekt auch wirklich page heißt.

Also besser mit einer Typo3 Eigenen Funktion.

'''Beispiel - JavaScript einbinden'''
<pre>
function includeJavaScript() {
$js .= '<script src="'.t3lib_extMgm::siteRelPath($this->extKey).dirname($this->scriptRelPath).'/JS-Verzeichnis/js-file.js" type="text/javascript"></script>';
$GLOBALS['TSFE']->additionalHeaderData[$this->extKey] = $js;
}

//Aufruf der Funktion:
$content=$this->includeJavaScript();
</pre>

Die Variable $this->extKey wird normalerweise immer in der Klassendefinition der Extensiongesetzt und enthält den Namen der Extension (z.B. meineextension)

Für $this->scriptRelPath gilt das gleiche. Hier steht der Pfad ab dem Extension Ordner (z.B. pi1/class.tx_meineExtension_pi1.php)

== Mehrsprachige Extensions ==
Seit der Version 4 hat sich die Vorgehensweise bei der Lokalisierung geändert. Um zu verstehen wie die Lokalisierung von Backend, Frontend etc. funktioniert gibt es hier eine kleine Übersicht:
[[Sprachverwaltung und Lokalisierung in Typo3]]

== $GLOBALS['TSFE'] ==

TSFE ist ein Abbild der Klasse tslib_fe, die kannst Du auch untersuchen.