Wikizone - Benutzerbeiträge [de]

Typo3 - Benutzer Registrierung (sr feuser register)

2010-05-03T19:32:46Z

91.47.237.205: /* Probleme lösen */

Diese Extension kann die wichtigsten Dinge für Frontend Benutzer ab:
* Registrieren
* An- / Abmeldung
* Zuordnung zu verschiedenen Benutzergruppen
* etc.

== Links ==
[http://wiki.typo3.org/index.php/De:Front_End_User_Registration Typo3 Wiki]

[http://blog.marit.ag/2010/02/12/fe-user-gesalzenen/ User Registrierung mit gesalzenen Passwörtern]

Zusatzfelder:
http://blog.marit.ag/2010/02/03/sr_feuser_register-zusatzfeld/

== Quickstart ==
benötigt:
* static_info_tables
* div2007 (für Flexforms)
* kb_md5fepw (wenn md5 Passwords verwendet werden sollen)

=== Wichtige Ordner und Seiten ===
* O: Benutzer (oder Abos) enthält notwendige Benutzergruppen und die User
* S: Login (oder Newsletter) enthält normales Login und sr_feuser_register (default, startingpoint ist der feuser - Ordner)
*S: Registrierung (sr_feuser_register, mode create, startingpoint wie oben)

=== Benutzergruppen anlegen ===
* Gruppe für nicht bestätigte Registrierungen
* Gruppe für bestätigte Registrierungen

=== TypoScript ===
'''Statisches Template'''
* FE User Registration

'''Constants'''
<pre>
// Ordner mit Benutzern für Loginform
styles.content.loginform.pid = 87
// bei alter newloginbox...
# plugin.tx_newloginbox_pi1.storagePid = 87

plugin.tx_srfeuserregister_pi1{
// Seite mit den Benutzern
pid = 87
// Benutzergruppen uid nach Registrierung aber vor Bestätigung (z.B. "NL nicht bestätigt")
userGroupUponRegistration = 1
// Benutzergruppen uid nach Bestätigung (z.B. "NL bestätigt")
userGroupAfterConfirmation = 2
// Seite mit Login Form
loginPID = 88
// Seite mit Registierung
registerPID = 89
// Seite zum editieren der Benutzerdaten
editPID = 90
// Seite mit Bestätigung der Registrierung
confirmPID = 91
// Wieviel Bilder dürfen hochgeladen werden
maxImages = 1
dateFormat = d.m.Y
dateSplit = .
salutation = informal
siteName = KO rockt!
formFields = password,first_name, last_name, email,module_sys_dmail_html, module_sys_dmail_category,disable
requiredFields = first_name,last_name,email
email = steff@ko-rockband.de
// nur mit RealURL ?
useShortUrls = 1
// Kategorien von Direct Mail
module_sys_dmail_category_PIDLIST = 86
//
dmailCheckedUponRegistration = 1
}
</pre>

'''Setup'''
<pre>
// Sprachlabel anpassen
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de{
v_really_wish_to_delete_informal = Willst Du Dein Konto wirklich löschen?
v_your_account_was_created_informal = Dein Konto <strong>%2$s</strong> wurde erstellt. Wir senden eine E-Mail an die Adresse <strong>%4$s</strong>, damit Du die Anmeldung bestätigen kannst.
}
// Titel der Benutzerseite überschreiben (wird in E-Mails benutzt)
plugin.tx_srfeuserregister_pi1.pidTitleOverride = KO rockt! News

</pre>

== Beispiel: sr_feuser_register für Newsletter einsetzen ==

In diesem Beispiel geht es darum die Benutzer Registrierung für Direct Mail (direct_mail) einzubauen und zu konfigurieren.

== Probleme lösen ==
=== Marker von eigenen Feldern mit TCA_INPUT werden nicht mehr ersetzt ===
Es wird nur noch der Marker ausgegeben.

Lösung: Extension über Hook anmelden

siehe auch http://bugs.typo3.org/view.php?id=5846

Seit sr_feuser_register muss jede Extension mit neuen Felder für fe_users angemeldet werden. Dasselbe gilt auch für sr:_email_subscribe und tt_address. Der Grund ist eine Code-Optimierung, damit im Frontend nicht mehr die $TCA einer jeden installierten Extension eingelesen werden muss, was eine Menge an RAM einspart, weil im $TCA auch viele Übersetzungstexte vorkommen.

In der ext_localconf.php der Extension mit dem Extension Key meineext muss das eingetragen werden:

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['sr_feuser_register']['extendingTCA'][] = 'meineext';

=== Fehlermeldung: sr_feuser_register: The form's token is too short! ===

Das kann an einem Bug in der Version: 2.5.25 liegen. Hierfür gibt es aktuell (1.5.2010) Kein Update aber einen Patch: http://bugs.typo3.org/view.php?id=14125&nbn=5

Wichtig ist danach eine aktuelle div2007 Version (bei mir 0.3.1 aufzuspielen. Sonst gibts gleich die nächsten Fehler.

=== Felder die über TCA verändert werden funktionieren im Backend aber nicht im Frontend ===
Zitat aus der Mailingliste von Oliver Klee:

Das Problem ist, dass das TCA deiner Extension im FE nicht geladen wird
und sr_feuser_register daher die Einstellungen der Felder nicht kennt.
So habe ich das dann gelÃ¶st:

'''myext/ext_localconf.php'''
<pre>
$TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['ext/sr_feuser_register/lib/class.tx_srfeuserregister_tca.php'] = t3lib_extMgm::extPath('myext') . 'class.ux_tx_srfeuserregister_tca.php';
</pre>

'''myext/class.ux_tx_srfeuserregister_tca.php:'''

<pre>
class ux_tx_srfeuserregister_tca extends tx_srfeuserregister_tca {
function init (&$pibase, &$conf, &$controlData, &$langObj, $extKey,$theTable)
{
global $TCA;
tx_div2007_alpha::loadTcaAdditions_fh001(array('my ext'));
return parent::init( $pibase, $conf, $controlData, $langObj, $extKey, $theTable);
}
}

== Anpassen ==
http://blog.marit.ag/2010/02/03/sr_feuser_register-zusatzfeld/</pre>

=== Nur aktuelle Benutzerdaten anzeigen ===
http://www.typo3-jack.net/typo3-english-lists-netfielders-de/1686-typo3-sr_feuser_register-show-mode-like-edit.html

Typo3 - Benutzer Registrierung (sr feuser register)

2010-05-03T19:02:21Z

91.47.237.205: /* Probleme lösen */

Real URL (realurl)

2010-05-03T18:54:38Z

91.47.237.205:

== Links ==
Pathcache ausschalten:
http://blog.marit.ag/2007/07/24/realurl-pathcache-ausschalten/
== Tipps ==
===Alte Simulatic Links===
von außen erhalten...
RewriteRule ([0-9]+)\.([0-9]+)\.html$ http:///index.php?id=$1&type=$2 [R=301,L]
Sprich: meineDomain.de/123.html wird zu meineDomain.de/index.php?id=123
Wenn die Seiten andere IDs beinhalten dann kann man alte Seiten per Redirect umleiten (siehe htaccess)

===Lange Pfade abkürzen===

Hinweis: In neuen RealURL geht das scheinbar auch ohne die folgende Extension

Manchmal hat man sehr lange Pfade wenn die Navigation in Unterordnern liegt. Mit der Extension '''aoe_realurlpath''' kann man diese Teile "cutten"

Vorgehen
* Extension installieren
* realurl konfiguration anpassen
<pre>
'pagePath' => array (
'type' => 'user',
// -> delete this
'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
// -> use this
'userFunc' => 'EXT:aoe_realurlpath/class.tx_aoerealurlpath_pagepath.php:&tx_aoerealurlpath_pagepath->main',
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => '7',
'rootpage_id' => '1',
// -> add this
'segTitleFieldList'=>'alias,tx_aoerealurlpath_overridesegment,nav_title,title,subtitle',
),
</pre>

=== Manuelles serialisieren ===
RealURL arbeitet mit einer serialisierten Konfiguration bis zu 10 mal schneller. Wenn man aber die Konfigurations-Datei von Hand erstellen (oder verändern will) kann man mit dem serialisierten Array nichts anfangen.
In php kann man mit den Befehlen serialize und unserialize die Arrays konvertieren.

Beispiel:
<pre>
$serializedConfig = serialize($TYPO3_CONF_VARS['EXTCONF']['realurl']);
print($serializedConfig);
</pre>

== Probleme lösen ==
=== Mal gehts, mal nicht ===
Beim Testen von RealURL hilft es oftmals einen anderen Browser zum testen der Seiten zu benutzen, mit dem man nicht eingeloggt ist. Das hilft um Probleme im Zusammenhang mit dem Caching zu lösen.

=== realurl_autoconf.php wird nicht erstellt ===
Das Problem hängt mit anderen Extensions zusammen. Ist Powermail installiert in den Extension Einstellungen von Powermail die Option für Realurl bei der installation der realurl Extension ausschalten.

Im typo3forum.net war auch die Rede von Problemen mit t3skin. Konnte ich bisher nicht nachvollziehen aber temporäres ausschalten hilft wohl auch hier.

=== weitere Probleme ===
* Fehlermeldung Pfad/sowieso/ not found nearest match is
** Problem bei der Konfigurationsdatei (Leerzeichen vorne, falsche id etc.)
* Stylesheets, Bilder etc. aus TypoScript Konfiguration werden nicht gefunden.
** BaseURL stimmt nicht config.baseURL = http://www.meineDomain.de/
* Konfiguration loswerden:
** realurl und urltools Verweisen in der localconf auf ihr Konfigurationsfile. Alle Einträge und die Dateien können gelöscht werden wenn nicht mehr benötigt.
* Es werden falsche Links in der Art meineDomain.de/SeitenID generiert => siehe [[Typo3 - RealURL mit mehreren Domains]]

== Quickinfo ==
=== Einfachere automatische Konfiguration mit neuer Version) ===
(Update 12/2009)
Mindestens ab Version 1.7 erkennt die Autokonfiguration angelegte Domain-Records und passt die Konfiguration daraufhin an. Sprich - folgendes vorgehen.
* Wichtig: Zuerst alle Domain Records anlegen (auch für den Hauptbaum). Dies nimmt die autoconf als Basis für die Record Arrays und setzt dann auch gleich die Root IDs
* htaccess Datei anpassen
* Extensions die für realurl eine Konfiguration für realurl mitbringen vor real url installieren
* realurl installieren
* TypoScript anpassen (config.baseURL für alle Seitenbäume nicht vergessen)

In http://dmitry-dulepov.com/article/automatic-realurl-configuration-howto.html spricht Dimitry davon daß die Autokonfiguration zukünftig automatisch aktualisiert wird. Im Moment nur wenn die Datei gelöscht wird.

Wenn man manuell konfiguriert sollte man also alles nach realurl_conf.php kopieren, damit nichts ausversehen überschrieben wird.
(Update Ende)

<pre>
config{
simulateStaticDocuments = 0
tx_realurl_enable = 1
baseURL = http://www.grauff.com/
}
</pre>
* First try autoconfiguration
* If doesen't work switch off and use manual configuration or use aeurltool (or realurlsettings) (easier to configure and contains working standard configuration)
* look section tipps for better configuration

==Konfiguriern mit Hilfe von danp_realurlconfigurator==

für die Konfoguration hilft auch die extension danp_realurlconfigurator

== Configure Apache ==
RealURLs work by providing 'virtual paths' to 'virtual files'. These don't actually exist on the file-system, so you must tell Apache to let a PHP-script handle the request if it can't find the file. This way, all URLs to pages (like www.server.com/products/product1/left.html) will be 'redirected' to /index.php, which will handle the translation of the URL into GET parameters. Real files (like images, the TYPO3 backend, static html-files, etc.) will still be handled by Apache itself though.

You should put the supplied sample .htaccess file (called _.htaccess) in the root of your TYPO3-installation.

Alternatively, you could include the following lines in your httpd.conf, probably in the VirtualHost-section. Here is an example:

<pre>
<VirtualHost 127.0.0.1>
DocumentRoot /var/www/typo3/dev/testsite-3/
ServerName www.test1.intra
RewriteEngine On
RewriteRule ^/typo3$ - [L]
RewriteRule ^/typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* /index.php
</VirtualHost>
</pre>

NOTICE: USING httpd.conf is currently known not to work since t3lib_div::getIndpEnv('TYPO3_SITE_URL') is not correct. Solution remains to be found.

If you put it into a .htaccess file it has to look slightly different, basically stripping the leading slashes (“/”):

<pre>
RewriteEngine On
#RewriteBase /mySubfolderIfNeeded
RewriteRule ^/typo3$ - [L]
RewriteRule ^/typo3/.*$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-l
RewriteRule .* index.php

</pre>

This will tell Apache that it should rewrite every URL that's not a filename, directory or symlink. It leaves everything starting with /typo3/ alone too.

Notice: For this work you need the Apache module “mod_rewrite”!

Also refer to the Appendix for extended information on mod_rewrite issues.

== TS Config ==
<pre>
config.simulateStaticDocuments = 0
config.baseURL = http://mydomain.com/
config.tx_realurl_enable = 1
</pre>

== localconf.php Configuration ==
=== Mehrere Domains verwalten ===
Dies wird von autoconfig mittlerweile selbstständig gemacht. Hier aber noch ein Link für die manuelle Konfiguration:
http://www.typo3-book.com/blog/index.php/2009/01/27/realurl-mit-mehreren-domains-bzw-root-id%C2%B4s-stammbaumen/

und hier ab Typo3 Version 4.2 und RealURL 1.5 mit Konfigurationsmöglichkeiten die es erlauben GET Parameter in Domainnamen umzusetzen:

http://typo3-blog.net/tutorials/news/realurl-multilanguage-domain.html

==== Beispiel das auch mit älteren realurl Versionen funktioniert ====

Im ersten Teil wird in _DEFAULT eine Standard Konfiguration mit einer rootid erstellt. Am Ende wird diese nur noch für die anderen (Im Seitenbaum nachfolgenden) Domains kopiert und die rootpageid neu gesetzt

<pre>
<?php

/**
*
* default realurl configuration
* based on realurl-configuration of news.typo3.org
* http://news.typo3.org/about/realurl-configuration/
*
*/

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl'] = array (
'_DEFAULT'=>array(
'init' => array (
'enableCHashCache' => '1',
'appendMissingSlash' => 'ifNotFile',
'enableUrlDecodeCache' => '1',
'enableUrlEncodeCache' => '1',
),
'redirects' => array (
),
'preVars' => array (
'0' => array (
'GETvar' => 'no_cache',
'valueMap' => array (
'nc' => '1',
),
'noMatch' => 'bypass'
),
'1' => array (
'GETvar' => 'L',
'valueMap' => array (
'de' => '0',
'en' => '1',
),
'noMatch' => 'bypass',
),
'2' => array (
'GETvar' => 'lang',
'valueMap' => array (
'de' => 'de',
'en' => 'en',
),
'noMatch' => 'bypass',
),
),
'pagePath' => array (
'type' => 'user',
'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => '7',
'rootpage_id' => '1',
'firstHitPathCache'=>1,
),
'fixedPostVars' => array (
),
'postVarSets' => array (
'_DEFAULT' => array (
'archive' => array (
'0' => array (
'GETvar' => 'tx_ttnews[year]',
),
'1' => array (
'GETvar' => 'tx_ttnews[month]',
'valueMap' => array (
'january' => '01',
'february' => '02',
'march' => '03',
'april' => '04',
'may' => '05',
'june' => '06',
'july' => '07',
'august' => '08',
'september' => '09',
'october' => '10',
'november' => '11',
'december' => '12',
),
),
),
'browse' => array (
'0' => array (
'GETvar' => 'tx_ttnews[pointer]',
),
),
'select_category' => array (
'0' => array (
'GETvar' => 'tx_ttnews[cat]',
),
),
'article' => array (
'0' => array (
'GETvar' => 'tx_ttnews[tt_news]',
'lookUpTable' => array (
'table' => 'tt_news',
'id_field' => 'uid',
'alias_field' => 'title',
'addWhereClause' => ' AND NOT deleted',
'useUniqueCache' => '1',
'useUniqueCache_conf' => array (
'strtolower' => '1',
'spaceCharacter' => '-',
),
),
),
'1' => array (
'GETvar' => 'tx_ttnews[swords]',
),
),
),
),
'fileName' => array (
//
// if you don't want .html-URLs set the following to "false" (e.g. 'defaultToHTMLsuffixOnPrev' => false,)
// then you get http://www.yourdomain.com/imprint/ instead of http://www.yourdomain.com/imprint.html
//
'defaultToHTMLsuffixOnPrev' => true,
'index' => array (
'rss.xml' => array (
'keyValues' => array (
'type' => '100',
),
),
'rss091.xml' => array (
'keyValues' => array (
'type' => '101',
),
),
'rdf.xml' => array (
'keyValues' => array (
'type' => '102',
),
),
'atom.xml' => array (
'keyValues' => array (
'type' => '103',
),
),
),
),
),
);

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']['www.siedlevoss.de'] = $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']['_DEFAULT'];
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']['www.siedlevoss.de']['pagePath']['rootpage_id'] = 103;
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']['www.vanderrolle.de'] = $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']['_DEFAULT'];
$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl']['www.vanderrolle.de']['pagePath']['rootpage_id'] = 133;

?>

</pre>

=== Auszüge (Stand 2008) aus verschiedenen Dokus ===

with the variable $TYPO3_CONF_VARS['EXTCONF']['realurl']

This is managed automatically for newer realurl versions

<pre>
<?php

/**
*
* aeUrlTool default realurl configuration
* based on realurl-configuration of news.typo3.org
* http://news.typo3.org/about/realurl-configuration/
*
*/

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['realurl'] = array (
'_DEFAULT' => array (
'init' => array (
'enableCHashCache' => '1',
'appendMissingSlash' => 'ifNotFile',
'enableUrlDecodeCache' => '1',
'enableUrlEncodeCache' => '1',
),
'redirects' => array (
),
'preVars' => array (
'0' => array (
'GETvar' => 'no_cache',
'valueMap' => array (
'nc' => '1',
),
'noMatch' => 'bypass'
),
'1' => array (
'GETvar' => 'L',
'valueMap' => array (
'de' => '0',
'en' => '1',
),
'noMatch' => 'bypass',
),
'2' => array (
'GETvar' => 'lang',
'valueMap' => array (
'de' => 'de',
'en' => 'en',
),
'noMatch' => 'bypass',
),
),
'pagePath' => array (
'type' => 'user',
'userFunc' => 'EXT:realurl/class.tx_realurl_advanced.php:&tx_realurl_advanced->main',
'spaceCharacter' => '-',
'languageGetVar' => 'L',
'expireDays' => '7',
'rootpage_id' => '1',
),
'fixedPostVars' => array (
),
'postVarSets' => array (
'_DEFAULT' => array (
'archive' => array (
'0' => array (
'GETvar' => 'tx_ttnews[year]',
),
'1' => array (
'GETvar' => 'tx_ttnews[month]',
'valueMap' => array (
'january' => '01',
'february' => '02',
'march' => '03',
'april' => '04',
'may' => '05',
'june' => '06',
'july' => '07',
'august' => '08',
'september' => '09',
'october' => '10',
'november' => '11',
'december' => '12',
),
),
),
'browse' => array (
'0' => array (
'GETvar' => 'tx_ttnews[pointer]',
),
),
'select_category' => array (
'0' => array (
'GETvar' => 'tx_ttnews[cat]',
),
),
'article' => array (
'0' => array (
'GETvar' => 'tx_ttnews[tt_news]',
'lookUpTable' => array (
'table' => 'tt_news',
'id_field' => 'uid',
'alias_field' => 'title',
'addWhereClause' => ' AND NOT deleted',
'useUniqueCache' => '1',
'useUniqueCache_conf' => array (
'strtolower' => '1',
'spaceCharacter' => '-',
),
),
),
'1' => array (
'GETvar' => 'tx_ttnews[swords]',
),
),
),
),
'fileName' => array (
//
// if you don't want .html-URLs set the following to "false" (e.g. 'defaultToHTMLsuffixOnPrev' => false,)
// then you get http://www.yourdomain.com/imprint/ instead of http://www.yourdomain.com/imprint.html
//
'defaultToHTMLsuffixOnPrev' => true,
'index' => array (
'rss.xml' => array (
'keyValues' => array (
'type' => '100',
),
),
'rss091.xml' => array (
'keyValues' => array (
'type' => '101',
),
),
'rdf.xml' => array (
'keyValues' => array (
'type' => '102',
),
),
'atom.xml' => array (
'keyValues' => array (
'type' => '103',
),
),
),
),
),

);

?>
</pre>

== Workaround wenn Pfade verloren gehen ==

Sollten Sie den "Pagepath" über den Web-Menüpunkt Info->Speaking Url Management ändern, kann es Ihnen passieren, dass die Pfade in Links und Menüs nicht aktualisiert werden.

Als Workaround hilft es, den Seitencache zu löschen und dann die Seiten mit einem anderen Browser zu öffnen, bei dem man nicht als BE-User eingeloggt ist.

[http://www.oliver-thiele.de/cms-typo3/tutorials/realurl-tutorial.html Tutorial hierfür]

Typo3 - Backend Module programmieren (Extensions)

2010-05-03T18:53:01Z

91.47.237.205:

== Links ==

http://blog.marit.ag/2008/07/15/eigene-backendmodule-richtig-konfigurieren/

Typo3 - Extensions programmieren

2010-05-03T18:52:49Z

91.47.237.205:

Weiterführende Links:

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

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

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

http://wiki.typo3.org/Extension_Developers_Guide

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 - 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 - required what ?==
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");

$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>

== 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 - Caching

2010-05-03T18:50:49Z

91.47.237.205:

== Links ==

http://blog.marit.ag/2009/01/19/wir-fordern-statisches-caching-fur-statische-seiten/#more-262

Typo3 - Caching in Extensions

2010-05-03T18:50:27Z

91.47.237.205: /* Links */

== Links ==
[[Typo3 - Caching]]

http://www.typo3-handbuch.de/index.php?id=164

http://www.sk-typo3.de/Richtiges-Cachen-mit-pi_base.188.0.html

http://www.sk-typo3.de/COA_INT-in-Extensions.190.0.html

== Caching in Typo3 ==
=== no_cache ===
Das Caching in Typo3 läßt sich auf verschiedene Arten ausschalten:
* no_cache=1 Parameter in der URL
* Seiteneigenschaften
* set no Cache Funktion
* TypoScript
Hierbei wird die komplette Seite bei jedem Aufruf neu berechnet. Die Performance nimmt dabei drastisch ab. Deshalb wird das Ausschalten des Seitencaches nicht empfohlen.
=== USER_INT / COA_INT ===
Bei USER_INT Objekten wird die Seite Gechachet und für das USER_INT Objekt ein Platzhalter hinterlegt. Es wird nur der Teil des USER_INT Objektes jedesmal neu berechnet.

Dies sollte nicht gemeinsam mit cHashing verwendet werden.

Damit das Plugin richtig als USER_INT Objekt behandelt wird muß folgendes beachtet werden:

var $pi_checkCHash = FALSE;
var $this->pi_USER_INT_obj = 1;

Hier kann es notwendig sein in der localconf das Plugin auf USER_INT umzustellen. Der letzte Parameter ist ausschlaggebend.

t3lib_extMgm::addPItoST43($_EXTKEY, 'pi1/class.tx_myExtKey_pi1.php', '_pi1', 'list_type', 0);

=== cHash ===
Bei USER Objekten kommt das Caching mit cHash zum Tragen. Dabei wird jede Seite mehrfach gespeichert. Und zwar gibt es für jede Kombination der POST/GET Parameter eine Version der Seite.

Sinnvoll ist dies wenn eine Seite bei einer Parameter-Kombination immer die gleichen Ergebnisse erzielt. Bei Hochdynamischen Seiten (Forum etc.) Wo sich dauernd etwas ändert ist das USER_INT Objekt vorzuziehen.

var $pi_checkCHash = TRUE;
var $this->pi_USER_INT_obj = 0;

und in der localconf:
t3lib_extMgm::addPItoST43($_EXTKEY, 'pi1/class.tx_myExtKey_pi1.php', '_pi1', 'list_type', 1);

== Praxis ==
Eine typische Anforderung ist eine Extension mit Suchformular, eine Ergebnisliste und viele Detailansichten. Die Detailseiten sollen gecachet und durchsuchbar sein, aber die Form und die Ergebnisliste sollen nicht gecachet werden. Wie soll das gehen.

Eine Möglichkeit ist es 2 Plugins in die Extension zu nehmen und diese unterschiedlich zu cachen.

Eleganter ist allerdings ein Caching mit USER/USER_INT Switch

Caching immer dann wichtig wird, wenn ein Link oder ähnliches geklickt wird und die aufgerufene Seite (auch wenn es die selbe ist) dementsprechend aus dem Cache kommt oder neu gerechnet wird. Dies hängt davon ab was unsere Zielseite anzeigen soll. Dazu erzeugen wir bei Bedarf ein USER_INT Objekt und müssen darauf achten, das die Links auf der Seite korrekt erzeugt werden. Muß also auf zwei Dinge achten Das das so ist ist historisch begründet und leider etwas umständlich.

So gehts:

Wir arbeiten mit 2 Caching Parametern:
der Funktionsparameter '''$cache''' ist Zuständig für die korrekte Linkerzeugung in den Linkfunktionen
die Object-Variable '''$this->pi_USER_INT_obj''' ist dafür Zuständig den Inhalt entweder zu berechnen(Das Zielobjekt ist ein USER_INT Objekt) oder aus der Datenbank zu holen (das Zielobjekt ist ein USER Objekt).

=== cHash links zu USER objects ===
Links zu einem USER-Objekt brauchen einen cHash, wenn Du willst, das das Zielobjekt gecachet wird. Der cHash ist eine Versicherung, das der Aufruf gültige Parameter besitzt und die Datenbank in der Lage ist, die gewünschte Ansicht zu cachen. Um dieses zu erreichen musst Du folgendes setzen:
$cache =1
$this->pi_USER_INT_obj = 0

=== Einfache Links zu USER_INT-Objekten ===
USER_INT Objekte werden niemals gecachet. So würde es auch keinen Sinn machen, sie mit einem cHash aufzurufen. Obwohl dieses keinen Sinn machen würde, kann man den cHash für diesen Fall verhindern.
$cache =0
$this->pi_USER_INT_obj = 1

=== Ergebnis ===
So sieht das dann im Ergebnis aus:

<pre>
class tx_myExtension extends tslib_pibase{
var $pi_checkCHash = TRUE; // if this is a USER plugin
var $this->pi_USER_INT_obj; // we don't set it here
...
function someFunction(...){
...
// link to USER
$cache = 1;
$this->pi_USER_INT_obj = 0;

$label = 'Link to USER plugin'; // the link text
$overrulePIvars = array( ... the parameters we need to send to the target plugin .... );
$clearAnyway=1; // the current values of piVars will NOT be preserved
$altPageId=33; // ID of the target page, if not on the same page
$link = $this->pi_linkTP_keepPIvars($label, $overrulePIvars, $cache, $clearAnyway, $altPageId);
...
// link to USER_INT
$cache = 0;
$this->pi_USER_INT_obj = 1;
$label = 'Link to USER_INT plugin'; // the link text
$overrulePIvars = array( ... the parameters we need to send to the target plugin .... );
$clearAnyway=1; // the current values of piVars will NOT be preserved
$altPageId=33; // ID of the target page, if not on the same page
$link = $this->pi_linkTP_keepPIvars($label, $overrulePIvars, $cache, $clearAnyway, $altPageId);
...
}
}
</pre>

== Caching in TYPO3-Extensions (Artikel)==

Michael Türk 29. Mai 2008

http://www.typo3-scout.de/2008/05/29/caching-in-typo3-extensions/

Wer einmal einen genaueren Blick auf die Abläufe im TYPO3-Frontend-Rendering geworfen hat, weiß, wie viele komplexe Vorgänge an der Ausgabe der TYPO3-Seiten beteiligt sind. Diese Komplexität steigt weiter, je mehr Extensions installiert sind. Würden TYPO3 Seiten bei jedem Aufruf neu aufgebaut, würde die Performance der Seiten erheblich Leiden und die Server hätten damit eher ihre Probleme. Außerdem funktioniert die Such-Indexierung nur dann, wenn die Inhalte zwischengespeichert werden.

Leider scheint das Caching an sich etwas zu wenig dokumentiert zu sein. Es finden sich immer wieder neue Extensions, welche die Caching-Mechanismen von TYPO3 nicht richtig einzusetzen verstehen. Dies liegt wahrscheinlich nicht zuletzt daran, dass die Schalter zum Aktivieren der Caching-Funktionalitäten recht gut versteckt und leicht zu übersehen sind.

Um die Performance von statischen Seiten zu verbessern, wird der fertig gerenderte HTML Code in der Datenbank abgelegt, um beim nächsten Abruf der Seite direkt aus der Datenbank geladen zu werden. Bei Extensions unterscheiden sich zwei verschiedene Vorgehensweisen:

1. Ein Großteil der Frontend-Plugins liefert '''bei gleichen Parametern immer gleiche Ergebnisse'''. Dies kennt man von News oder Shop-Systemen. Dies bedeutet, dass man die Ausgabe für verschiedene Parameter-Kombinationen jeweils im Cache ablegen kann, um sie bei der nächsten Anfrage beschleunigt ausgeben zu können.

2. Darüber hinaus existieren jedoch Erweiterungen, deren '''Ausgaben hochdynamisch''' sind. Zu dieser Gruppe zählen unter anderem Community-Features, deren Ausgabe minütlich wechseln kann, '''obwohl die Parameter gleich bleiben''' (oder gar keine Parameter angegeben werden). Hier würde Cache verhindern, dass der Benutzer alle neuen Informationen geliefert bekommt

Die Cache-Mechanismen werden zum an '''zwei verschiedenen Stellen''' der Extension ein- und ausgeschaltet. Dies ist zum Einen die Datei '''ext_localconf.php''' und zum anderen die Datei des Plugins selbst, die die '''Plugin-Base-Klasse''' enthält (welche in der Regel auf piX.php endet)

'''ext_localconf.php'''
<pre>
t3lib_extMgm::addPItoST43($_EXTKEY,‘piX/class.tx_extensionname_piX.php’,‘_piX’,‘list_type’,1);
</pre>
Der entscheidende Punkt in dieser Anweisung ist der letzte Parameter. Dieser wird im angegebenen Beispiel auf true gesetzt und das System somit angewiesen, die Ausgabe der Extension zu cachen.

<pre> t3lib_extMgm::addPItoST43($_EXTKEY,‘piX/class.tx_extensionname_piX.php’,‘_piX’,‘list_type’,0);
</pre>
Im zweiten Fall wurde nun die Variable auf false gesetzt und die Ausgabe daher nicht zwischengespeichert.

'''class.extensionname_piX.php'''

Innerhalb der Extension kann nun noch festgelegt werden, ob das Plugin '''cHashing-Mechanismen zum Identifizieren gleicher Parameter-Kombinationen''' nutzen soll. cHashs werden durch den Typolink-Mechanismus erstellt, wobei die eingehenden Parametern zusammen mit dem geheimen internen Schlüssel zu einem Hash-Wert zusammengefasst werden. Dieser Mechanismus wird über das Setzen einer Klassenvariable erreicht:

var $pi_checkCHash = true;

'''Alternativ''' kann ein Plugin explizit '''als USER_INT Objekt''' ausgewiesen werden. Für diese wird in den gecachten Seiten ein Platzhalter hinterlegt, während die eigentliche Ausgabe der Extension erst zur Laufzeit der Webseite eingesetzt wird.
<pre>
function main($content,$conf) {
[...]
$this->pi_USER_INT_obj = 1;
[...]
}
</pre>

Ein häufig auftretender Fehler hierbei ist die Kombination der beiden letztgenannten Optionen. Allerdings widersprechen sich die beiden Konzepte, da beispielweise bei der Link-Generierung keine Cache Hashes gebildet werden, wenn ein Plugin einem USER_INT-Objekt entspricht. Um an dieser Stelle dynamische Ausgaben zu generieren, behelfen sich viele Entwickler mit der no_cache-Anweisung, die das Caching für die gesamte Seite deaktiviert. Dies bedeutet, dass die gesamte Seite von einer Indizierung ausgeschlossen wird und das Rendern der Seite erschwert wird. Von der Anweisung

$GLOBALS[‘TSFE’]->set_no_cache();

sollte in einer Live-Seite prinzipiell Abstand genommen werden.

Wie man sieht, sind die Anweisungen für Caching-Mechanismen eher übersichtlich, so dass die fachgerechte Einstellung des eigenen Frontend-Plugins keine allzu große Hürde darstellen sollte. In der Praxis gestaltet sich dies bisher leider noch zu oft als eine Hürde für Extensions mit viel Potential.

Typo3 - Benutzer Registrierung (sr feuser register)

2010-05-03T18:49:07Z

91.47.237.205:

Diese Extension kann die wichtigsten Dinge für Frontend Benutzer ab:
* Registrieren
* An- / Abmeldung
* Zuordnung zu verschiedenen Benutzergruppen
* etc.

== Links ==
[http://wiki.typo3.org/index.php/De:Front_End_User_Registration Typo3 Wiki]

[http://blog.marit.ag/2010/02/12/fe-user-gesalzenen/ User Registrierung mit gesalzenen Passwörtern]

Zusatzfelder:
http://blog.marit.ag/2010/02/03/sr_feuser_register-zusatzfeld/

== Quickstart ==
benötigt:
* static_info_tables
* div2007 (für Flexforms)
* kb_md5fepw (wenn md5 Passwords verwendet werden sollen)

=== Wichtige Ordner und Seiten ===
* O: Benutzer (oder Abos) enthält notwendige Benutzergruppen und die User
* S: Login (oder Newsletter) enthält normales Login und sr_feuser_register (default, startingpoint ist der feuser - Ordner)
*S: Registrierung (sr_feuser_register, mode create, startingpoint wie oben)

=== Benutzergruppen anlegen ===
* Gruppe für nicht bestätigte Registrierungen
* Gruppe für bestätigte Registrierungen

=== TypoScript ===
'''Statisches Template'''
* FE User Registration

'''Constants'''
<pre>
// Ordner mit Benutzern für Loginform
styles.content.loginform.pid = 87
// bei alter newloginbox...
# plugin.tx_newloginbox_pi1.storagePid = 87

plugin.tx_srfeuserregister_pi1{
// Seite mit den Benutzern
pid = 87
// Benutzergruppen uid nach Registrierung aber vor Bestätigung (z.B. "NL nicht bestätigt")
userGroupUponRegistration = 1
// Benutzergruppen uid nach Bestätigung (z.B. "NL bestätigt")
userGroupAfterConfirmation = 2
// Seite mit Login Form
loginPID = 88
// Seite mit Registierung
registerPID = 89
// Seite zum editieren der Benutzerdaten
editPID = 90
// Seite mit Bestätigung der Registrierung
confirmPID = 91
// Wieviel Bilder dürfen hochgeladen werden
maxImages = 1
dateFormat = d.m.Y
dateSplit = .
salutation = informal
siteName = KO rockt!
formFields = password,first_name, last_name, email,module_sys_dmail_html, module_sys_dmail_category,disable
requiredFields = first_name,last_name,email
email = steff@ko-rockband.de
// nur mit RealURL ?
useShortUrls = 1
// Kategorien von Direct Mail
module_sys_dmail_category_PIDLIST = 86
//
dmailCheckedUponRegistration = 1
}
</pre>

'''Setup'''
<pre>
// Sprachlabel anpassen
plugin.tx_srfeuserregister_pi1._LOCAL_LANG.de{
v_really_wish_to_delete_informal = Willst Du Dein Konto wirklich löschen?
v_your_account_was_created_informal = Dein Konto <strong>%2$s</strong> wurde erstellt. Wir senden eine E-Mail an die Adresse <strong>%4$s</strong>, damit Du die Anmeldung bestätigen kannst.
}
// Titel der Benutzerseite überschreiben (wird in E-Mails benutzt)
plugin.tx_srfeuserregister_pi1.pidTitleOverride = KO rockt! News

</pre>

== Beispiel: sr_feuser_register für Newsletter einsetzen ==

In diesem Beispiel geht es darum die Benutzer Registrierung für Direct Mail (direct_mail) einzubauen und zu konfigurieren.

== Probleme lösen ==
=== Marker von eigenen Feldern mit TCA_INPUT werden nicht mehr ersetzt ===
Es wird nur noch der Marker ausgegeben.

Lösung: Extension über Hook anmelden

siehe auch http://bugs.typo3.org/view.php?id=5846

Seit sr_feuser_register muss jede Extension mit neuen Felder für fe_users angemeldet werden. Dasselbe gilt auch für sr:_email_subscribe und tt_address. Der Grund ist eine Code-Optimierung, damit im Frontend nicht mehr die $TCA einer jeden installierten Extension eingelesen werden muss, was eine Menge an RAM einspart, weil im $TCA auch viele Übersetzungstexte vorkommen.

In der ext_localconf.php der Extension mit dem Extension Key meineext muss das eingetragen werden:

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['sr_feuser_register']['extendingTCA'][] = 'meineext';

=== Fehlermeldung: sr_feuser_register: The form's token is too short! ===

Das kann an einem Bug in der Version: 2.5.25 liegen. Hierfür gibt es aktuell (1.5.2010) Kein Update aber einen Patch: http://bugs.typo3.org/view.php?id=14125&nbn=5

Wichtig ist danach eine aktuelle div2007 Version (bei mir 0.3.1 aufzuspielen. Sonst gibts gleich die nächsten Fehler.

== Anpassen ==
http://blog.marit.ag/2010/02/03/sr_feuser_register-zusatzfeld/

Typo3 - TCA

2010-05-03T18:34:28Z

91.47.237.205:

== TCA ist das Table Configuration Array von Typo3 ==
In diesem PHP Array wird konfiguriert, wie die Datenbankfelder von Typo3 und allen Extensions im Backend dargestellt werden. Also ob ein Feld als Text Input oder Selectbox dargestellt wird. Woher die Inhalte kommen, Sprachlabels, Validierung, Reiter, Wizards etc.

Indem man dieses Array verändert hat man großen Einfluss auf das Typo3 Backend. Wenn eine Extension für die Frontenddarstellung darauf zugreift hat es auch Einfluss auf die Frontend Darstellung (Bsp. sr_feuser_register)

== Links ==
Zu Paletten: http://blog.marit.ag/2009/12/14/neue-tca-pallette/#more-457

Position von Feldern, auf bestimmte Seitentypen beschränken: http://typo3-blog.net/tutorials/news/addtoalltcatypes.html

== Welche Konfiguration hat ein bestimmtes Feld ? ==

Im Backend Configuration Modul, da kann man sehen wie ein Feld konfiguriert ist.

== Wie kann ich die Konfiguration verändern, bzw. eigene Felder anlegen ==
* Extension schreiben, mit dem Kickstarter Felder anlegen.
* Die Felder werden in ext_tables.php angelegt und können dort auch weiter bearbeitet werden.
* Welche Optionen es gibt steht in der Typo3 Core Api

== Weiterführendes ==
Video von Irene Höppner

== Wichtige Funktionen ==

== Beispiele ==

== Probleme lösen ==
=== Überschreiben des TCA Wertes funktioniert nicht ===
Lösung: Oft ist die Reihenfolge des Einbindens der Extensions (localconf.php) und die Priorität (s.u.) entscheidend

in ext_emconf.php meiner TCA-Überschreibe-Extension musste ich noch

'priority' => 'top',