04. April 2014

Eigene Distributionen erstellen

in Extension, Tutorial, TYPO3

Seit dem lang ersehnten Release der TYPO3 Version 6.2 gibt es neben den ganzen vielen Features nun eine neue Art von Extension, die Distribution.

Wer schon mal eine 6.2 nackt installiert hat, hat bestimmt im letzten Schritt die Möglichkeit gesehen, eine Liste von Distributionen herunterzuladen.
Mit heutigem Stand gibt es zwei Distributionen, das „helloworld package“ und das altbekannte „Introduction Package“:

Distributionsauswahl TYPO3 Backend

Solche Distributionen enthalten alles, um direkt nach Installation eine vorgefertigte Website erscheinen zu lassen.
In den Distributionen sind sowohl die abhängigen Extensions, das nötige TypoScript wie auch das Template in HTML und CSS enthalten.

Natürlich gibt es nun auch die Möglichkeit, Distributionen selber herzustellen.

Dies geht folgendermaßen:

  1. Reserviere einen Extension Key auf typo3.org (http://typo3.org/extensions/extension-keys/). In unserem Beispiel ist der Extension Key „yourext“
  2. Erstelle eine lokale Extension
  3. Setze die Abhängigkeiten in der ext_emconf.php (Beispiel unten)
  4. Die Dateien, die bei der Installation in das Verzeichnis „fileadmin/yourext“ kopiert werden sollen, müssen in der Extension in das Verzeichnis „Initialisation/Files/“
  5. Wenn etwas in die Datenbank geschrieben werden soll (wie z.B. TypoScript Templates), gehören drei Schritte dazu:
    1. Erstelle die Datensätze in einem bestehenden TYPO3 System
    2. Exportiere diese Datensätze mittels der Export-Funktion von TYPO3 in eine .t3d Datei
    3. Benenne die Datei in data.t3d um und kopiere sie ins Verzeichnis „Initialisation“
  6. Setze die Kategorie deiner Extension in der ext_emconf.php auf „distribution“

Wenn du die Distribution für alle verfügbar machen willst, kannst du sie natürlich ins TER hochladen.

Hier das Beispiel der ext_emconf.php:

$EM_CONF[$_EXTKEY] = array(
	'title' => 'title',
	'description' => 'description',
	'category' => 'distribution',
	'author' => 'your name',
	'author_email' => 'yourmail@typo3.org',
	'author_company' => '',
	'shy' => '',
	'priority' => '',
	'module' => '',
	'state' => 'beta',
	'internal' => '',
	'uploadfolder' => '0',
	'createDirs' => '',
	'modify_tables' => '',
	'clearCacheOnLoad' => 0,
	'lockType' => '',
	'version' => '0.3',
	'constraints' => array(
		'depends' => array(
			'extbase' => '6.2',
			'fluid' => '6.2',
			'typo3' => '6.2',
			'news' => '2.2',
		),
		'conflicts' => array(
		),
		'suggests' => array(
		),
	),
);

Hier ist diese Anleitung nochmal auf englisch: http://wiki.typo3.org/Distributions

11 Reaktionen zu “Eigene Distributionen erstellen”

Kommentare abonnieren (RSS) oder TrackBack URL

great tip! can you also do this in english?

ben van 't ende am 04. April 2014 um 15:43

Added link to post.

Thomas Löffler am 04. April 2014 um 15:54

Hello World gibt’s seit kurzem nicht mehr 😉

Das war nur zu Testzwecken.

Markus K am 04. April 2014 um 18:24

Den Screenshot hatte ich heute erstellt. Scheint es wohl noch zu geben.
Kann aber sein, dass die Distribution die nächsten Tage rausfliegt.

Thomas Löffler am 04. April 2014 um 21:03

wie kann man denn das Bild ändern? Also das, wo jetzt das Päckchen mit dem Fragezeichen ist…..

Wadim am 05. April 2014 um 11:36

Im Template steht: EXT:{distribution.extensionKey}/Resources/Public/Images/Distribution.png und Fallback halt EXT:extensionmanager/Resources/Public/Images/Distribution.png (das ist wahrscheinlich das Fragezeichen). Beste Grüße, Tim

Tim Lochmüller am 05. April 2014 um 12:07

Zwei Bilder kann man einbinden und werden vom TER (nach dem nächsten Deployment) ausgelesen:

Resources/Public/Images/Distribution.png [220×150]
Resources/Public/Images/DistributionWelcome.png [300×400]

Thomas Löffler am 07. April 2014 um 13:52

Bei der ext_emconf.php am Anfang nicht das „<?php" vergessen.
Ist mir nämlich gerade passiert und hab den Fehler ewig nicht entdeckt 😉

Mike Streibl am 17. April 2014 um 14:47

Hätte eine Frage,
bei mir steht in der ext_conf.php
‚constraints‘ => array(
‚depends‘ => array(
‚typo3‘ => ‚7.6.0-7.6.99‘,
‚realurl‘ => “,
),
‚conflicts‘ => array(
),
’suggests‘ => array(
),
),

es sollte doch jetzt realurl automatisch installiert werden?
Doch ich bekomme eine Fehlermeldung

Oops, an error occurred!

The package „XXX“ depends on „realurl“ which is not present in the system.

Christian am 26. Januar 2017 um 18:48

Hey Christian, kann es sein, dass deine Extension schon installiert ist? Bitte erst deinstallieren, dann Abhänigkeit ergänzen, dann installieren. Leichter ist es noch mit Composer… Grüße,
Tim

Tim Lochmüller am 26. Januar 2017 um 19:53
Trackbacks & Pingbacks

[…] Erstellung wird hier kurz erklärt und sehr ausführlich und gut nachvollziehbar im Screencast von Jochen […]

Pingback von Ein Hoch auf TYPO3 Distributions | Andy Wesely am 21. Oktober 2015 um 09:04

Kategorien

Archiv