TYPO3 - userFunc - Versionsgeschichte

149.172.225.28: /* Vorsicht Fallen */

2018-01-29T15:02:52Z

Vorsicht Fallen

149.172.225.28: /* Vorsicht Namespaces und Cache */

2018-01-29T15:02:35Z

Vorsicht Namespaces und Cache

149.172.225.28 am 29. Januar 2018 um 14:46 Uhr

2018-01-29T14:46:43Z

149.172.225.28: /* UserFunc in TYPO3 7.4 */

2018-01-29T14:35:39Z

UserFunc in TYPO3 7.4

149.172.225.28 am 29. Januar 2018 um 14:34 Uhr

2018-01-29T14:34:17Z

149.172.225.28: /* Sammlung */

2018-01-29T14:23:09Z

Sammlung

149.172.225.28 am 29. Januar 2018 um 14:18 Uhr

2018-01-29T14:18:12Z

149.172.225.28 am 29. Januar 2018 um 14:14 Uhr

2018-01-29T14:14:07Z

149.172.225.28: /* UserFunc in TYPO3 7.4 */

2018-01-23T14:25:10Z

UserFunc in TYPO3 7.4

149.172.225.28 am 23. Januar 2018 um 11:21 Uhr

2018-01-23T11:21:31Z

@@ Zeile 152: / Zeile 152: @@
 Damit das Autoloading funktioniert muss alles zusammenpassen. Beispiel:
-  Extensionname myextensionname
+  Extensionname: myextensionname
   Klassendatei: myextension/Classes/Example.php
   Funktion in der Klasse: myExampleFunction

@@ Zeile 146: / Zeile 146: @@
 Weitere Infos zu der ExtBase Variante findet man hier: http://blog.teamgeist-medien.de/2014/03/typo3-eine-extbase-extension-per-typoscript-einbinden.html
-=== Vorsicht Namespaces und Cache ===
+=== Vorsicht Fallen  ===
 Für die Schreibweisen der Namespaces:
 https://docs.typo3.org/typo3cms/CoreApiReference/ApiOverview/Namespaces/Index.html#namespaces
-Die Namespaces haben mir noch Probleme bereitet ... Ausserdem muss man beim Testen die Extension nach Änderungen de- und wieder installieren oder im Installtool den Cache löschen. Normales Cache löschen hat manchmal nicht ausgereicht.
+Damit das Autoloading funktioniert muss alles zusammenpassen. Beispiel:
-Finde ich schon aufwändiger, aber auch aufgeräumter, da in einer Extension. Der Vorteil kommt wohl vor allem zum Tragen, wenn man mehrere Userfuncs einbinden muss. Neue Datei in Classes und fertig … Und an die Namespaces werde ich mich auch noch gewöhnen :-)
+ Extensionname myextensionname
-OK, ich finde die Diskussion hat sich rentiert, für mich zumindest. Herzlichen Dank Helmut!
+'''Vorsicht normales Cache löschen im Backend reicht nicht'''. Im Installtool löschen oder Extension Deinstallieren / Installieren
 ==Sammlung==

@@ Zeile 4: / Zeile 4: @@
   https://nic3.de/typo3/php (bis Version 7.4 (inkl.)
   V7.4: http://www.schmutt.de/542/userfunc-tutorial-update/
   V8.7: http://typo3blogger.de/userfuncs-per-typoscript-in-typo3-8-7-einbinden/
 == 4.7 und kleiner ==
 Einbindung über PHP Script Objekt

@@ Zeile 41: / Zeile 41: @@
 == UserFunc in TYPO3 7.4 ==
 '''In TYPO3 7.4 wurde die Methode, eigene PHP-Dateien via includeLibs einzubinden, angepasst.'''
 <pre>
@@ Zeile 154: / Zeile 155: @@
 Peter
 ==Sammlung==

@@ Zeile 1: / Zeile 1: @@
 Je nach Version unterschiedlich
-V7.4: http://www.schmutt.de/542/userfunc-tutorial-update/
+Im PHP-Skript muss die Ausgabe in einer '''Variable namens $content''' gespeichert werden. In nachfolgenden Beispiel-Code wird das durch Output-Buffering erledigt.
-V8.7: http://typo3blogger.de/userfuncs-per-typoscript-in-typo3-8-7-einbinden/
+<pre>
 == UserFunc in TYPO3 7.4 ==
-Ab 7.4 hat sich die include Syntax geändert, config.includeLibrary und config.includeLibs wurden entfernt. Userfuncs müssen ab TYPO3 7.4 folgendermaßen eingebunden werden:
+'''In TYPO3 7.4 wurde die Methode, eigene PHP-Dateien via includeLibs einzubinden, angepasst.'''
 === Einfache Extension für die userFunc ===
@@ Zeile 121: / Zeile 157: @@
 ==Sammlung==

@@ Zeile 121: / Zeile 121: @@
 ==Sammlung==
-TYPO3 Versionen 6.0 bis 7.3
+=== TYPO3 Versionen 6.0 bis 7.3 ===
-Der Objekttyp PHP_SCRIPT wurde in der TYPO3-Version 4.7 als veraltet erklärt und in Version 6.0 entfernt. Ab der TYPO3-Version 6.0 wird stattdessen der Objekttyp USER angeboten. Die Funktionsweise ist sehr ähnlich. Statt einem linearen PHP-Skript, ist nun eine Klasse mit einer Methode für die Ausgabe erforderlich.
+Der Objekttyp '''PHP_SCRIPT wurde in der TYPO3-Version 4.7 als veraltet erklärt''' und in Version 6.0 entfernt. Ab der TYPO3-Version 6.0 wird stattdessen der '''Objekttyp USER''' angeboten. Die Funktionsweise ist sehr ähnlich. Statt einem linearen PHP-Skript, ist nun eine Klasse mit einer Methode für die Ausgabe erforderlich.
-includeLibs.user_klasse = fileadmin/php/user_klasse.php
+ includeLibs.user_klasse = fileadmin/php/user_klasse.php
-lib.marker = USER
+ lib.marker = USER
-lib.marker.userFunc = user_klasse->ausgabe
+ lib.marker.userFunc = user_klasse->ausgabe
-Mit includeLibs wird der Pfad zur Klasse user_klasse definiert. Diese befindet sich in diesem Beispiel im Ordner /fileadmin/templates/php. Die Klasse user_klasse stellt Methoden bereit, die den auszuführenden PHP-Code enthalten. Der Klassenname muss immer in der Form user_[klassenname] vorliegen.
+Mit '''includeLibs''' wird der Pfad zur Klasse user_klasse definiert. Diese befindet sich in diesem Beispiel im Ordner /fileadmin/templates/php.
 class user_klasse
+{
@@ Zeile 139: / Zeile 142: @@
+	}
+}
+</pre>
 Mit einem Doppelklick kann der gesamte Code markiert werden.
-TYPO3 Version 7.4 und größer
+=== TYPO3 Version 7.4 und größer ===
-In TYPO3 7.4 wurde die Methode, eigene PHP-Dateien via includeLibs einzubinden, angepasst.
+'''In TYPO3 7.4 wurde die Methode, eigene PHP-Dateien via includeLibs einzubinden, angepasst.'''
 <pre>

← Nächstältere Version		Version vom 29. Januar 2018, 14:18 Uhr
Zeile 118:		Zeile 118:

	Peter		Peter
		+
		+
		+	==Sammlung==
		+	TYPO3 Versionen 6.0 bis 7.3
		+
		+	Der Objekttyp PHP_SCRIPT wurde in der TYPO3-Version 4.7 als veraltet erklärt und in Version 6.0 entfernt. Ab der TYPO3-Version 6.0 wird stattdessen der Objekttyp USER angeboten. Die Funktionsweise ist sehr ähnlich. Statt einem linearen PHP-Skript, ist nun eine Klasse mit einer Methode für die Ausgabe erforderlich.
		+	includeLibs.user_klasse = fileadmin/php/user_klasse.php
		+
		+	lib.marker = USER
		+	lib.marker.userFunc = user_klasse->ausgabe
		+
		+	Mit einem Doppelklick kann der gesamte Code markiert werden.
		+
		+	Mit includeLibs wird der Pfad zur Klasse user_klasse definiert. Diese befindet sich in diesem Beispiel im Ordner /fileadmin/templates/php. Die Klasse user_klasse stellt Methoden bereit, die den auszuführenden PHP-Code enthalten. Der Klassenname muss immer in der Form user_[klassenname] vorliegen.
		+	class user_klasse
		+	{
		+	function ausgabe()
		+	{
		+	return 'Diese Ausgabe wurde durch PHP erzeugt.';
		+	}
		+	}
		+
		+	Mit einem Doppelklick kann der gesamte Code markiert werden.
		+	TYPO3 Version 7.4 und größer
		+
		+	In TYPO3 7.4 wurde die Methode, eigene PHP-Dateien via includeLibs einzubinden, angepasst.
		+
		+	<pre>
		+	lib.marker = USER_INT
		+
		+	lib.marker.includeLibs = fileadmin/php/user_klasse.php
		+	lib.marker.userFunc = user_klasse->ausgabe
		+	</pre>

← Nächstältere Version		Version vom 29. Januar 2018, 14:14 Uhr
Zeile 106:		Zeile 106:
	</syntaxhighlight>		</syntaxhighlight>
	Weitere Infos zu der ExtBase Variante findet man hier: http://blog.teamgeist-medien.de/2014/03/typo3-eine-extbase-extension-per-typoscript-einbinden.html		Weitere Infos zu der ExtBase Variante findet man hier: http://blog.teamgeist-medien.de/2014/03/typo3-eine-extbase-extension-per-typoscript-einbinden.html
		+
		+	=== Vorsicht Namespaces und Cache ===
		+	Für die Schreibweisen der Namespaces:
		+	https://docs.typo3.org/typo3cms/CoreApiReference/ApiOverview/Namespaces/Index.html#namespaces
		+
		+	Die Namespaces haben mir noch Probleme bereitet ... Ausserdem muss man beim Testen die Extension nach Änderungen de- und wieder installieren oder im Installtool den Cache löschen. Normales Cache löschen hat manchmal nicht ausgereicht.
		+
		+	Finde ich schon aufwändiger, aber auch aufgeräumter, da in einer Extension. Der Vorteil kommt wohl vor allem zum Tragen, wenn man mehrere Userfuncs einbinden muss. Neue Datei in Classes und fertig … Und an die Namespaces werde ich mich auch noch gewöhnen :-)
		+
		+	OK, ich finde die Diskussion hat sich rentiert, für mich zumindest. Herzlichen Dank Helmut!
		+
		+	Peter

@@ Zeile 8: / Zeile 8: @@
 Ab 7.4 hat sich die include Syntax geändert, config.includeLibrary und config.includeLibs wurden entfernt. Userfuncs müssen ab TYPO3 7.4 folgendermaßen eingebunden werden:
-<pre>
+<syntaxhighlight lang="typoscript">
 page.20 = USER_INT
 page.20 {
@@ Zeile 14: / Zeile 14: @@
    includeLibs = fileadmin/example_time.php
+}
-</pre>
+</syntaxhighlight>
-Einfache Extension für die userFunc
+=== Einfache Extension für die userFunc ===
-Empfohlen wird aber, die benötigten Klassen über eine Extension einzubinden und das Autoload-Verhalten mit Namepaces auszunutzen. Dafür ist minimal nötig (Beispiel – danke dafür an Peter Linzenkirchner):
+Empfohlen wird aber, die benötigten Klassen '''über eine Extension einzubinden''' und das Autoload-Verhalten mit Namepaces auszunutzen. Dafür ist minimal nötig (Beispiel – danke dafür an Peter Linzenkirchner):
-Ein Ordner in typo3conf/ext/ mit diesem Inhalt:
+'''Ein Ordner in typo3conf/ext/ mit diesem Inhalt:'''
 <pre>
      typo3conf/ext/myincludes
@@ Zeile 27: / Zeile 27: @@
      typo3conf/ext/myincludes/ext_icon.gif
 </pre>
-Der Inhalt der ext_emconf.php:
+'''Der Inhalt der ext_emconf.php:'''
+<syntaxhighlight lang="php">
 <?php
 $EM_CONF[$_EXTKEY] = array(
@@ Zeile 48: / Zeile 48: @@
      ),
 );
-Der Inhalt der Example.php:
+'''Der Inhalt der Example.php:'''
+<syntaxhighlight lang="php">
 <?php
 namespace Myvendor\Myincludes;
@@ Zeile 59: / Zeile 60: @@
+     }
+}
-Und der Aufruf im TS:
+'''Und der Aufruf im TS:'''
+<syntaxhighlight lang="typoscript">
 page.30 = USER_INT
 page.30 {
@@ Zeile 67: / Zeile 69: @@
    userFunc.color = #ff0000
+}
+</syntaxhighlight>
 ExtBase Extension mit userFunc Action
 Oft hat man bereits eine Extbase Extension und will eine bestimmte Action als userFunc aufrufen. Das geht so:
+<syntaxhighlight lang="typoscript">
 = USER_INT
 {
@@ Zeile 84: / Zeile 86: @@
+     }
+}
+</syntaxhighlight>
 Und das ist der zugehörige Controller. Der Eintrag in switchableControllerActions ist nötig, da sonst die default listAction aufgerufen wird:
 <?php
 namespace MyVendor\MyExtension\Controller;
@@ Zeile 101: / Zeile 104: @@
+}
+</syntaxhighlight>
 Weitere Infos zu der ExtBase Variante findet man hier: http://blog.teamgeist-medien.de/2014/03/typo3-eine-extbase-extension-per-typoscript-einbinden.html