This document discusses extending TYPO3 applications using Extbase. It introduces new methods and examples for a news system. Dependency injection, signals/slots, and cached classes are presented as methods introduced with Extbase. XClass and hooks are discussed as previous methods for extending TYPO3 before Extbase. The document provides examples of mapping classes and connecting slots to demonstrate these extension techniques.

1. Estendere applicazioni
extbase
Nuovi metodi ed esempi con news system
Presentato da: Cristian Buja T3Camp Italia 2014
Milano 14 - 15 marzo

2. Cristian Buja
2010
2014
2011
2012
2013

3. Sulla strada di TYPO3 ed Extbase

4. Metodi precedenti ad extbase
Xclass Hooks

5. Xclass prima di TYPO3 6.0
ext_localconf.
php
ext:example
ux_backend.php
associazione
2
3
1dichiarazione
backend.php
typo3
3 REQUISITI

6. Xclass prima di TYPO3 6.0
3 associazione in ext_localconf.php
$GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['XCLASS']['typo3/backend.php'] =
'typo3conf/examples/xclass/ux_backend.php'
1 dichiarazione in typo3/backend.php
if (defined('TYPO3_MODE') && $GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['XCLASS']['typo3/backend.php']) {
include_once($GLOBALS['TYPO3_CONF_VARS'][TYPO3_MODE]['XCLASS']['typo3/backend.php']);
}
2 sintassi del nome file
ux_[nome_classe].php

7. TYPO3 6.0 rompe le catene!
ext_localconf.php
$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects']
['TYPO3CMSBackendControllerNewRecordController'] = array (
'className' =>
'DocumentationExamplesXclassNewRecordController'
);
Solo associazione !

8. Cambiamenti nelle classi statiche
Deprecated
t3lib_div
Use
TYPO3CMSCoreUtilityGeneralUtility
GeneralUtility::makeInstance()
GeneralUtility::callUserFunction()
GeneralUtility::getUserObj()

9. Hooks remains the same…?
Estensioni
$TYPO3_CONF_VARS['EXTCONF'][ extension_key ][ sub_key ] = value
Core
$TYPO3_CONF_VARS['SC_OPTIONS'][ main_key ][ sub_key ][ index ] = function_reference
Moduli BE
$TBE_MODULES_EXT[ backend_module_key ][ sub_key ] = value

10. Metodi introdotti con extbase
Dependency
Injection Signal / Slot

11. Dependency Injection (DI)
Injection Extbase
/**
* @var Tx_Extbase_Object_ObjectManagerInterface $objectManager
*/
protected $objectManager;
/**
* @param Tx_Extbase_Object_ObjectManagerInterface $objectManager
* @return void
*/
public function injectObjectManager (
Tx_Extbase_Object_ObjectManagerInterface $objectManager
) {
$this->objectManager = $objectManager;
}

12. Dependency Injection (DI)
Injection Extbase > 4.7
/**
* @var TYPO3CMSExtbaseSignalSlotDispatcher
* @inject
*/
protected $signalSlotDispatcher;
@inject
is
Comment the code

13. Dependency Injection (DI)
Costructor injection
/**
* @param TYPO3CMSExtbaseObjectManagerInterface $objectManager
*/
public function __constructor(TYPO3CMSExtbaseObjectManagerInterface $objectManager) {
$this->objectManager = $objectManager;
}
Initialize Object
/**
* Additional inizialization
*/
public function inizializeObject() { ... }

14. Object manager: istanziare oggetti
GeneralUtility::makeIstance()
ObjectManager->get()
/**
* @var TYPO3CMSExtbaseObjectObjectManagerInterface
* @inject
*/
protected $objectManager;
public function foo () {
...
$cObj = $this->objectManager
->get('TYPO3CMSFrontendContentObjectContentObjectRenderer');
...
}

15. Extbase: Mappatura delle classi
Typoscript Setup:
config.tx_extbase.object {
TYPO3CMSExtbasePersistenceGenericStorageBackendInterface {
className = TYPO3CMSExtbasePersistenceGenericStorageTypo3DbBackend
}
}
Injection
+ Typoscript

16. Extbase: Mappatura delle classi
Typoscript Setup:
plugin.tx_example.object {
TYPO3CMSExtbasePersistenceGenericStorageBackendInterface {
className = TYPO3CMSExtbasePersistenceGenericStorageTypo3DbBackend
}
}
Extbase > 6.1
Ovverride global config
Power Up!

17. Signal / Slot
TYPO3CMSExtbaseSignalSlotDispatcher.php
public function connect (
$signalClassName, $signalName,
$slotClassNameOrObject, $slotMethodName,
$passSignalInformation = TRUE
) { … }
public function dispatch (
$signalClassName, $signalName,
array signalArguments = array()
) { … }
Paradigma Event / Observer

18. Dispatcher injection
TYPO3CMSExtbaseMvcControllerAbstractController.php
/**
* Injects the signal slot dispatcher
*
* @param TYPO3CMSExtbaseSignalSlotDispatcher $signalSlotDispatcher
*/
public function injectSignalSlotDispatcher(
TYPO3CMSExtbaseSignalSlotDispatcher $signalSlotDispatcher
) {
$this->signalSlotDispatcher = $signalSlotDispatcher;
}
Dispatcher

19. Connect Slot
ExampleController.php
/**
* Injects the signal slot dispatcher
*
* @param TYPO3CMSExtbaseSignalSlotDispatcher $signalSlotDispatcher
*/
public function initializeObject () {
$this->signalSlotDispatcher->connect( ... );
}
Dispatcher
Observer
Observer
Observer

20. Dispatch signal
TYPO3CMSExtbaseMvcControllerActionController.php
$this->signalSlotDispatcher->dispatch(
__CLASS__,
'beforeCallActionMethod',
array(
'controllerName' => get_class($this),
'actionMethodName' => $this->actionMethodName,
'preparedArguments' => $preparedArguments
)
);
Dispatcher
Observer
Observer
Observer
Event

21. Dove mettere le connessioni allo slot?
ext_localcong.php
$signalSlotDispatcher =
TYPO3CMSCoreUtilityGeneralUtility
::makeInstance('TYPO3CMSExtbaseObjectObjectManager')
-> get('TYPO3CMSExtbaseSignalSlotDispatcher');
$signalSlotDispatcher->connect( ... );

22. Work around in news system
+ metodi al domain object?
+ action a un controller?
Dependency Injection
+ estensioni agiscono sulle medesime classi?

23. Work around in news system

24. Cached class
Resources/Private/extend-news.txt
Domain/Model/News
Classes/Domain/Model/News.php
class News extends Tx_News_Domain_Model_News {
protected $newField;
public function getNewField() { … }
public function setNewField($newField) { … }
}

25. Cached class
ext_localconf.php
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_tcemain.php']
['clearCachePostProc'][$_EXTKEY . '_classcache'] =
'EXT:' . $_EXTKEY .
'/Classes/Cache/ClassCacheBuilder.php:Tx_News_Cache_ClassCacheBuilder->build';
Cosa fa?

26. Cached class
typo3temp/Cache/Code/cache_phpcode/Domain_Model_News.php
class Tx_News_Domain_Model_News extends Tx_Extbase_DomainObject_AbstractEntity {
…
…
/***********************************************************************
this is partial from: /var/www/html/typo3conf/ext/example/Classes/Domain/Model/News.php
***********************************************************************/
protected $newField;
public function getNewField() { … }
public function setNewField($newField) { … }
}

27. Estensioni per news system
➔ newsdirsync
➔ roq_newsevent
➔ mfc_author
➔ pb_news_job
➔ newsslider
➔ newsfal
➔ newsextended

28. Imprevisti in extension manager
Downgrade delle news
Ordine delle dipendenze errato

29. Esempio: publications con le news
Specifiche mancanti
➔ campi aggiuntivi
➔ ricerca avanzata
➔ layout dedicato
➔ ordinamento alternativo

30. Cosa vogliamo ottenere

31. Estendere Domain Model
News
Campi specifici delle publications
Dto/NewsDemand
Campo per ordinamento
Dto/Search
Campi per la form

32. Campi visibili aggiunti alle news

33. Ricerca avanzata
Hook:
$GLOBALS ['TYPO3_CONF_VARS'][EXT][news]
['Domain/Repository/AbstractDemandedRepository.php']['findDemanded']
function findDemanded($params, &$parent) { .. }
$params = array(
'demand' => $demand,
'respectEnableFields' => &$respectEnableFields,
'query' => $query,
'constraints' => &$constraints,
);

34. Layout dedicato
page TSConfig
tx_news.templateLayouts {
1 = News
2 = Publications
}
Template
<f:if condition=“{settings.templateLayout}=2}”>

35. Layout dedicato

36. Ordinamento Alternativo
$TYPO3_CONF_VARS['EXT']['news']['orderByNews'] .= ',publication_year';

37. News Related by Category
lib.news.relatedByCategory = USER
lib.news.relatedByCategory {
userFunc = TYPO3CMSExtbaseCoreBootstrap->run
pluginName = Pi1
extensionName = News
controller = News
action = list
switchableControllerActions.News.1 = list
persistence =< plugin.tx_news.persistence
settings =< plugin.tx_news.settings
settings {
isRelatedByCategory = 1
excludeAlreadyDisplayedNews = 1
useStdWrap = categories
categoryConjunction = and
categories.field = uid
limit = 5
}
}
Detail.html
<!-- Related by category -->
<f:for each="{newsItem.categories}" as="category">
<f:cObject
typoscriptObjectPath="lib.news.relatedByCategory"
data="{category}" />
</f:for>
List.html
...
<f:if condition={settings.isRelatedByCategory}”>
<f:then>
<h4>Related by category: {contentObjectData.title}</h4>
<ul><f:for each”{news}” as=”newsItem”><li><n:link
newsItem="{newsItem}"
settings="{settings}"
>{newsItem.title}</n:link></li><f:for></ul>
</f:then>
...

38. Parole chiave
Dependency Injection
XClass
Extbase
Hook
Signal / Slot
News
TYPO3
Cached Class

39. Link Utili
http://docs.typo3.org/TYPO3/CoreApiReference/ApiOverview/Hooks/
http://docs.typo3.org/TYPO3/CoreApiReference/ApiOverview/Xclasses/
http://forge.typo3.org/projects/typo3v4-mvc/wiki/Dependency_Injection_(DI)
http://docs.typo3.
org/flow/TYPO3FlowDocumentation/stable/TheDefinitiveGuide/PartIII/SignalsA
ndSlots.html
http://typo3.org/api/typo3cms/
http://2012.t3campitalia.it/slide-video-typo3-t3camp-italia/slide-come-
modificare-il-core-di-typo3-senza-toccarlo.html
http://docs.typo3.org/typo3cms/extensions/news/

40. Grazie per l’attenzione