Bearbeiten von „Extbase Extensions - Snippets und Glossar“

== Hinweis neue Namespace Regelung für Klassen ==
[[Extbase Änderungen ab TYPO3 V6]]

== Glossar ==

===Extbase===
ist ein MVC Framework für die Extension entwicklung in TYPO3

===FLOW3===
 - ist ein PHP-Framework, welches TYPO3 Version 5 verwenden wird.

===Fluid===
 - Template Engine ähnlich wie Smarty ab Version 5

===Namespace=== 
Im Model hinterlegt z.B. : namespace TripMaps\Slidercalc\Domain\Model; taucht in vielen Funktionen wieder auf.

== Snippets Links ==
http://typo3.org/documentation/snippets/

== Objekt-Abfragen im Controller steuern ==
[[Extbase - Sortierung und Abfrage von Objekten]]
Das Ergebnis der findAll() Funktion läßt sich mit dem QueryInterface steuern.
'''Beispiel'''
 $this->blubRepository->setDefaultOrderings(array('objectstorage.eigenschaft_der_objekte_nach_denen_ich_sortieren_will' => Tx_Extbase_Persistence_QueryInterface::ORDER_ASCENDING));
 $this->categoryRepository->setDefaultOrderings(array('events.title' => Tx_Extbase_Persistence_QueryInterface::ORDER_ASCENDING));
oder in neueren Versionen Namespace Variantae
 $defaultOrderings = array ('title' => \TYPO3\CMS\Extbase\Persistence\QueryInterface::ORDER_DESCENDING);

== TypoScript Konfiguration im Controller nutzen ==
=== Hinweis zu Settings in TypoScript ===
Im Action Controller und im Fluid Template sind nur die Objekte über $this->settings bzw. settings.objektname sichtbar die in '''plugin.tx_extname.settings''' liegen.

TypoScript
<pre>
plugin.tx_some-extname.settings {
    myXsetting = XXXX
}
</pre>
PHP
 $valX = $this->settings['myXsetting'];

== E-Mails mit Extbase ==
http://t3-developer.com/extbase-fluid/extensions-erweitern/e-mail-versand-aus-extensions/mailversand/

http://www.benny-vs-web.de/typo3/extbase-fluid-zum-rendern-von-e-mail-templates-verwenden/
== Lokalisierung - Language Files ==

=== Im Extbase Controller lokalisieren ===
Z.B. bei Fehlermeldungen. flashMessages oder speziellen Ausgaben

 Tx_Extbase_Utility_Localization::translate($langkey,$extensionName)
$extensionName = Extbase name (UpperCammelCase ohen Unterstriche)

$langkey muss der locallang.xml datei bzw. xlf hinzugefügen.

 <label index="tx_t3easyplugins_domain_model_plugin.createdSuccessful">Your new Plugin was created.</label>

Unten ein kleines Beispiel.
Tx_Extbase_Utility_Localization::translate

<pre>/**
 * action create
 *
 * @param $newEntry
 * @return void
 */
public function createAction(Tx_T3easyPlugins_Domain_Model_Plugin $newEntry) {
    $this->entryRepository->add($newEntry);
    $this->flashMessageContainer->add(Tx_Extbase_Utility_Localization::translate('tx_t3easyplugins_domain_model_Plugin.createdSuccessful', 'T3easyPlugins'));
    $this->redirect('list');
}
</pre>
locallang.xml
<pre>
...
<label index="tx_t3easyplugins_domain_model_plugin.createdSuccessful">Your new Plugin was created.</label>
...
</pre>

== Actions ==
=== Controller und Actions Basics ===
http://docs.typo3.org/typo3cms/ExtbaseFluidBook/7-Controllers/1-Creating-Controllers-and-Actions.html
=== Auf Daten andererer Modelle / Repositorys im Controller zugreifen. (verknüpfte Daten auflisten) ===
Im Controller steht wegen der strikten '''Trennung der Modelle''' erstmal das Repository (Die Datenstruktur) des Models zur Verfügung. Die verknüpften Daten (hier im Beispiels die Genres, gibt der View zwar über die Verknüpfung aus, das sind aber nur die mit dem jeweiligen Datensatz '''verknüpften Daten'''. Z.B. die Genres einer Band. Will man z.B. '''alle Genres im Listview der Bands''' ausgeben braucht man ein '''Repository der Genres und muß den Genre Controller in den Band Controller injecten'''. Dann kann man auf alle Funktionen des Genre Controllers auch aus dem Band Controller zugreifen. So bleibt auch alles sauber getrennt.

* eigenes Repository für verknüpfte Daten erstellen (z.B. Genre)
<pre>
	/**
	 * genreRepository
	 *
	 * @var \Geobit\Gbbandpass\Domain\Repository\GenreRepository
	 * @inject
	 */
	protected $genreRepository = NULL;
</pre>
* in gewünschten Controller (Hauptcontroller) injecten dazu innerhalb der Klasse folgendes hinzufügen:

You can inject every repository of every installed extbase extension. Just add the dependency injection code to your controller. Depending on your TYPO3 version ist either:

'''TYPO3 >= 6.0:'''
<pre>
/**
 * @var \Vendor\Extension\Domain\Repository\SomeRepository
 * @inject
 */
protected $someRepository;
'''TYPO3 = 4.7:'''
<pre>
/**
 * @var Tx_MyExtension_Domain_Repository_SomeRepository
 * @inject
 */
 protected $someRepository;
</pre>
'''TYPO3 < 4.7'''
<pre>
/**
 * @var Tx_MyExtension_Domain_Repository_SomeRepository
 */
 protected $someRepository;

/**
 * Inject SomeRepository
 * @param Tx_MyExtension_Domain_Repository_SomeRepository $someRepository
 * @return void
 */
public function injectSomeRepository(Tx_MyExtension_Domain_Repository_SomeRepository $someRepository) {
  $this->someRepository = $someRepository;
}
</pre>
Jetzt kann man $this->someRepository mit all seinen Methoden auch in diesem Controller nutzen.

'''Hinweis:''' Nach Änderung System Cache löschen !

=== Controller-Action Kombinationen für Frontend-Plugins definieren ===
http://docs.typo3.org/typo3cms/ExtbaseFluidBook/b-ExtbaseReference/Index.html

In ext_localconf.php sind '''erlaubte Actions''' hinterlegt. Der '''erste Eintrag ist die Default-Action'''.
<pre>
\TYPO3\CMS\Extbase\Utility\ExtensionUtility::configurePlugin(
	'Geobit.' . $_EXTKEY,
	'Mailformtest',
	array(
		'Mailform' => 'list, show, new, create',
		
	),
	// non-cacheable actions
	array(
		'Mailform' => 'create, ',
		
	)
);
</pre>
Zu diesem Beispiel gehört der Controller unter
 Classes/Controller/MailformController.php

== Diverse ==
=== Actions anlegen ===
Im Controller:
<pre>
/**
 * action list
 *
 * @return void
 */
public function listAction() {
	$myextname = $this->myextRepository->findAll();
	$this->view->assign('myextname', $myextname);
}
</pre>

=== addFlashMessage ===
Im Controller
<pre>
 $this->addFlashMessage('This is a simple success message');
 $this->addFlashMessage('The message body', 'Message title', \TYPO3\CMS\Core\Messaging\AbstractMessage::OK, TRUE);
 $this->addFlashMessage('<strong>HTML-Messageplement</strong>', '', \TYPO3\CMS\Core\Messaging\AbstractMessage::ERROR);
</pre>

== Default Sortierung in Extbase ==
Quelle: http://t3n.de/magazin/zehn-tipps-tricks-extbase-fluid-227639/2/ (11/2014)

Default-Sortierung im Repository

Nicht unbedingt unbekannt, aber weitestgehend ungenutzt ist ein Feature, welches in Extbase 1.3 hinzugekommen ist: Im Repository besteht die Möglichkeit, das Ergebnis nach bestimmten Feldern aufsteigend oder absteigend zu sortieren. Dies wird beispielsweise mittels „
 $query->setOrderings(array('name' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING));
erledigt.

Um dies nicht für jede einzelne Repository-Funktion einstellen zu müssen, gibt es die Eigenschaft defaultOrderings:

Im Repository
 protected $defaultOrderings = array ('name' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING);

== Debugging ==
=== Debugging im Controller ===

==== Beispiel ====
 print \TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump( $this );

==== Beispiel ====
<pre>
t3lib_utility_Debug::debug($var, 'Debug: ' . __FILE__ . ' in Line: ' . __LINE__);
 
# namespaces
\TYPO3\CMS\Core\Utility\DebugUtility::debug($var, 'Debug: ' . __FILE__ . ' in Line: ' . __LINE__);
</pre>
==== Beispiel ====
<pre>
Tx_Extbase_Utility_Debugger::var_dump($var);
 
# namespaces
\TYPO3\CMS\Extbase\Utility\DebuggerUtility::var_dump($var);
</pre>

== Zugriff auf TypoScript ==
https://typo3.org/api/typo3cms/class_t_y_p_o3_1_1_c_m_s_1_1_extbase_1_1_configuration_1_1_configuration_manager.html#ac6b6323862565409eddac516dca08c10
<pre>
getConfiguration	(
 	$configurationType,
 	$extensionName = NULL,
 	$pluginName = NULL 
)	
</pre>

== AJAX mit Extbase ==
=== AJAX über neuen Page Type ===
Quelle: http://t3-developer.com/extbase-fluid/extensions-erweitern/ajax-in-extensions/ajaxcalls-mit-pagetype/ (2014/12)

Die Verwendung eines eigenen page Types für Ajax Calls ist relativ simpel. Zunächst müsst ihr euer Extensionsetup um einen neuen '''PageType erweitern'''. Die PageType Nummer muss einmalig in der Installation sein, also ggf. bereits vergebene PageTypes für RSS, Sitemaps, Print & Co beachten.

==== Extensionsetup ===

Bitte beachtet das ihr in der letzten Zeile eure den Extensionnamen ohne 'tx_' Prefix angeben müsst!

'''TypoScript'''
<pre>
ajaxCall = PAGE 
ajaxCall { 
typeNum = 999 
     config.disableAllHeaderCode = 1 
     config.metaCharset = UTF-8 
    10 = COA 
    10 < tt_content.list.20.myextension_myplugin 
 }
</pre>
'''Der AjaxCall in jQuery'''
<pre>
$('#jq-send').click(function(e) { 
    $.ajax({ 
        var controller = tx_myExt_myplugin[controller]= blabla; 
        var action = tx_myExt_myplugin[action]= meineControllerFunction; // ohne Action am Ende 
        var pagetype = 999;
        var path = $(location).attr('href');

        url: path +  '/?' + controller + '&' + action + '&type=' + pagetype 
        //optionale Parameter 
        data: 'useruid=' + useruid, 

        success: function(result) { 
            console.log(result); 
            //hier kommen eure Anweisungen rein
        }, 
        error: function(error) { 
            console.log(error); 
        } 
    }); 
});
</pre>
Ein Beispiel findet ihr auch in meiner Blogextension "multiblog" auf Github: ajaxCall in Blogextension

====Ajax Function im Controller====

Die Controllerfunction muss natürlich wie jede Action in der '''ext_localconf.php registriert''' sein. Innerhalb dieser Action steht euch die ganz '''normale Extbase Umgebung''' zur Verfügung, also alles das was ihr in 'normalen' Funktionen auch habt (injected Repositories, mapped Tables, settings etc.) Genau das ist der '''Unterschied zu einem AjaxCall über eID''', das komplette TSFE ist geladen.

Am Ende der Funktion müsst Ihr euch nur entscheiden, was Ihr zurückgeben wollt:

'''Rückgabe eine json strings (z.B. Ergebnisarray):'''

 return json_encode($myArray);

'''Rückgabe eines kompletten Views als html string'''. Am Ende der Ajax Funktion im Controller setzt Ihr ganz normal euren View (Template muss vorhanden sein):

 $this->view->assign('myAjaxAction, $values);

'''Keinerlei Rückgabe''' z.B wenn Ihr nur Daten nur für einen Counter speichert:

 exit;

Innerhalb von der jQuery Funktion ''success:function(result) { }'' wird dann das Ergebnis ausgewertet. Die vom Controller zurückgegebenen Werte stehen in der '''Variablen result''' zur Verfügung.

=== AJAX Call über eid Mechanismus ===
Quelle: http://t3-developer.com/extbase-fluid/extensions-erweitern/ajax-in-extensions/ajax-dispatcher-eid-in-typo3-61/ (2014/12)

Ajax Dispatcher für TYPO3 6.2 - wichtige Hinweise!

Damit das nachfolgende Script auch unter TYPO3 6.2.3 funktioniert, müssen folgende Zeilen geändert werden:

Zeile 101:

 \TYPO3\CMS\Core\Core\Bootstrap::getInstance();
Siehe auch forge.typo3.org/issues/59070.

Ajax Dispaytcher für TYPO3 6.1 und Namespaces. Die Datei ist getestet und läuft auch ;). Ihr müsst in '''Zeile 82 + 83 den von Euch benutzen Vendor und Extension Namen einsetzten'''.

Siehe auch alle weiteren Angaben im Kommentarbereich des Dispatchers.
<pre>
<?php
/** *************************************************************
*
* Extbase Dispatcher for Ajax Calls TYPO3 6.1 namespaces
*
* IMPORTANT Use this script only in Extensions with namespaces
*
* Klaus Heuer <klaus.heuer@t3-developer.com>
*
* This script is part of the TYPO3 project. The TYPO3 project is
* free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* The GNU General Public License can be found at
* http://www.gnu.org/copyleft/gpl.html.
*
* This script is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* This copyright notice MUST APPEAR in all copies of the script!
* ************************************************************* */
/** ************************************************************
* Usage of this script:
*
* - Copy this script in your Extension Dir in the Folder Classes
* - Set the Vendor and Extension Name in Line 82 + 83
* - Include the next line in the ext_localconf.php, change the ext name!
* - $TYPO3_CONF_VARS['FE']['eID_include']['ajaxDispatcher'] = \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extPath('myExtension').'Classes/EidDispatcher.php';
*
* Use for Ajax Calls in your jQuery Code:
*
* $('.jqAjax').click(function(e) {
* var uid = $(this).find('.uid').html();
* var storagePid = '11';
*
* $.ajax({
* async: 'true',
* url: 'index.php',
* type: 'POST',
*
* data: {
*     eID: "ajaxDispatcher",
*     request: {
*          pluginName: 'patsystem',
*          controller: 'Todo',
*          action: 'findTodoByAjax',
*          arguments: {
*               'uid': uid,
*               'storagePid': storagePid
*               }
*           }
*      },
*      dataType: "json",
*
*      success: function(result) {
*           console.log(result);
*      },
*      error: function(error) {
*           console.log(error);
*      }
* });
*************************************************************** */
/**
* Gets the Ajax Call Parameters
*/
$ajax = \TYPO3\CMS\Core\Utility\GeneralUtility::_GP('request');
/**
* Set Vendor and Extension Name
*
* Vendor Name like your Vendor Name in namespaces
* ExtensionName in upperCamelCase
*/
$ajax['vendor'] = 'T3Developer';
$ajax['extensionName'] = 'ProjectsAndTasks';
/**
* @var $TSFE \TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController
*/
$TSFE = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Frontend\Controller\TypoScriptFrontendController', $TYPO3_CONF_VARS, 0, 0);
\TYPO3\CMS\Frontend\Utility\EidUtility::initLanguage();
// Get FE User Information
$TSFE->initFEuser();
// Important: no Cache for Ajax stuff
$TSFE->set_no_cache();
//$TSFE->checkAlternativCoreMethods();
$TSFE->checkAlternativeIdMethods();
$TSFE->determineId();
$TSFE->initTemplate();
$TSFE->getConfigArray();
\TYPO3\CMS\Core\Core\Bootstrap::getInstance()->loadConfigurationAndInitialize();
$TSFE->cObj = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer');
$TSFE->settingLanguage();
$TSFE->settingLocale();
/**
* Initialize Database
*/
\TYPO3\CMS\Frontend\Utility\EidUtility::connectDB();
/**
* @var $objectManager \TYPO3\CMS\Extbase\Object\ObjectManager
*/
$objectManager = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('TYPO3\CMS\Extbase\Object\ObjectManager');
/**
* Initialize Extbase bootstap
*/
$bootstrapConf['extensionName'] = $ajax['extensionName'];
$bootstrapConf['pluginName'] = $ajax['pluginName'];
$bootstrap = new TYPO3\CMS\Extbase\Core\Bootstrap();
$bootstrap->initialize($bootstrapConf);
$bootstrap->cObj = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance('tslib_cObj');
/**
* Build the request
*/
$request = $objectManager->get('TYPO3\CMS\Extbase\Mvc\Request');
$request->setControllerVendorName($ajax['vendor']);
$request->setcontrollerExtensionName($ajax['extensionName']);
$request->setPluginName($ajax['pluginName']);
$request->setControllerName($ajax['controller']);
$request->setControllerActionName($ajax['action']);
$request->setArguments($ajax['arguments']);
$response = $objectManager->create('TYPO3\CMS\Extbase\Mvc\ResponseInterface');
$dispatcher = $objectManager->get('TYPO3\CMS\Extbase\Mvc\Dispatcher');
$dispatcher->dispatch($request, $response);
echo $response->getContent();
//die();
?>
</pre>