Updated ChangeLog; raised version number
[Packages/TYPO3.CMS.git] / typo3 / sysext / extbase / ChangeLog.txt
1 ChangeLog for Extbase
2 =====================
3
4 Changes for 1.4.0 beta1:
5 ========================
6 included in TYPO3 4.6.0 beta1.
7
8 This release features 76 changes, where most of them are bugfixes in all areas of Extbase.
9 Thanks every community member for bug reports, submitting patches and reviewing! Extbase
10 would not be possible without you!
11
12 !!! New Property Mapper, updated MVC stack
13 ------------------------------------------
14
15 The Property Mapper has been completely rewritten in FLOW3, and this has also been backported
16 to Extbase. The new property mapper is very configurable and extensible.
17
18 Furthermore, the MVC stack has been adjusted to be in sync with FLOW3 again. We will provide
19 up-to-date documentation until the final release.
20
21 These are breaking changes in some cases. In order to get the old behavior back, set the
22 TypoScript setting:
23 config.tx_extbase.features.rewrittenPropertyMapper = 0
24
25 !!! The above way of switching to compatibility mode might still change until the final release!
26
27 !!! Updated Validation API
28 --------------------------
29
30 The Validation API has also changed, but this is only a breaking change if you do NOT subclass
31 *AbstractValidator*, but implement *ValidatorInterface* yourself. In this case, you need to
32 adjust your custom validator to support the new API.
33
34 Dependency Injection for Domain Objects
35 ---------------------------------------
36
37 Dependency Injection is now also possible for reconstituted Domain Objects.
38
39 Signal / Slot implementation
40 ----------------------------
41
42 The "Signal / Slot" feature has been backported from FLOW3, implementing a future-proof
43 alternative to hooks.
44
45
46 Full Changes for 1.4.0 beta1:
47 =============================
48 [!!!][TASK] Enable rewritten property mapper by default
49 [+FEATURE] Extbase (Persistence): Allow pid of object to be set from action-controller. Thanks to Michael Budnick and Balisky Christophe. Resolves: #7572
50 [FEATURE] Speed up ObjectAccess
51 [+FEATURE] Extbase (Persistence): Allow removing previously set limit with unsetLimit(). Resolves: #27445
52 [-TASK] Remove autoloader. Thanks to Christian Kuhn. Resolves: #28249
53 [+FEATURE] introduce signal in MVC/Dispatcher
54 [TASK] Correct classnaming for Tx_Extbase_Tests_Unit_BaseTestCase
55 [-BUGFIX] remove datecheck on timezone test
56 [+FEATURE] remove usage of deprecated methods in unit-tests
57 [BUGFIX] Adjust unit tests to changes
58 [BUGFIX] create ClassSchema with ObjectManager::create()
59 [BUGFIX] TypeHandling class not found. This is a hotfix for #28121. Resolves: #28121
60 [TASK] Extbase (Utility): Add service for TypeHandling. Related: #13864
61 [+BUGFIX] Extbase: CGL: Convert case of acronyms from UPPERCASE to CamelCase. Resolves: #12189
62 [TASK] Extbase: Use strpos() instead of strstr() where possible
63 [+BUGFIX] allow skipping of arguments in signal dispatch
64 [TASK] Adjust PHP dependency in ext_emconf.php
65 [FEATURE] Add check for loaded DBAL to requirements check
66 [TASK] Recreate ext_autoload.php. Resolves: #27680
67 [!!!][+FEATURE] (MVC): Modify MVC stack to use the new property mapper. Resolves: #27656
68 [!!!][+FEATURE] (Validation): Adjusted and re-done Validation API. Resolves: #27653
69 [+FEATURE] (Property): Add new property mapper. Related: #27059
70 [+FEATURE] (Persistence): Synchronize PersistenceManagerInterface more with FLOW3. Resolves: #27657
71 [+FEATURE] (Reflection): Object Access can now access private properties. Resolves: #27652
72 [+FEATURE] (Utility): synchronize TypeHandling class with FLOW3. Resolves: #27651
73 [!!!][FEATURE] Improve error and message handling. Resolves: #27650
74 [TASK] (MVC, Property): Deprecation of the the old property mapper
75 [+FEATURE] (Configuration): Feature flag implementation
76 [+BUGFIX] (Persistence): return correct objectCountByQuery when query contains left join and no limit. Fixes: #13075
77 [BUGFIX] Adapt cache configuration to 4.6. Resolves: #27546
78 [+BUGFIX] (SignalSlot): Fix unit tests. Resolves: #27550
79 [+BUGFIX] Make ObjectManager::isRegistered work
80 [+FEATURE] backport SignalSlotDispatcher
81 [+BUGFIX] Fix localization handling to support XLIFF. Resolves: #27411
82 [+BUGFIX] Extbase (Validation): E-mail address with space at the end is invalid. Thanks to Marc Bastian Heinrichs. Resolves: #27305
83 [+BUGFIX] Throw exception if a class to be reflected does not exist. Fixes: #8718
84 [TASK][!!!] Fix localization handling to support XLIFF. Resolves: #27411
85 [TASK] Extbase (Validation): Clean up tests for FloatValidatorTest and Integer ValidatorTest
86 [+BUGFIX] Extbase (Persistence): Use correct language-uid for translations. Thanks to Benjamin Mack. Resolves: #26521
87 [TASK] Extbase (Persistence): Remove duplicate registration in identity map. Thanks to Alexander Stehlik. Resolves: #26875
88 [BUGFIX] Fix EmailAddressValidatorTest
89 [+FEATURE] Extbase (MVC): Make response format configurable in TypoScript. Thanks to Christian Zenker. Resolves: #9216
90 [BUGFIX] Docu, AbstractController: Clearer difference of forward/redirect. Resolves: #7900
91 [BUGFIX] Fix case of setChildSortByFieldName in DataMapFactory. Resolves: #27334
92 [+BUGFIX] (Property) Fixed only adding objects to ObjectStorage. Thanks to Thomas Maroschik. Fixes: #13288
93 [+TASK] Extbase: Move static typoscript utility methods to a service. Related: #13864
94 [+TASK] Extbase: Move most of the static extension utility methods to a service. Related: #13864
95 [+BUGFIX] baseUri is added on external links. Thanks to Michael Feinbier for this fix! Resolves: #10258
96 [+BUGFIX] (Testing): Fix wrong doc comment in BaseTestCase. Resolves #13695
97 [+BUGFIX] Cloning a ValueObject should not set its uid to NULL. Resolves #26772
98 [+BUGFIX] ObjectStorage->toArray(): fix array pointer problem. Resolves #9117
99 [+BUGFIX] Persistence: Fixed building unionStatement from opposite. Thanks to Christian Zindel. Resolves #13782
100 [+BUGFIX] Persistence: Update tstamp column on objects removal. Thanks to Michel Nederlof. Resolves #10634
101 [+BUGFIX] correct warning in ObjectStorage & LazyObjectStorage
102 [~CLEANUP] some smaller comment cleanups
103 [+TASK] Extbase: Moved static cache utility class to a service. Relates to: #13864
104 [+FEATURE] implement ObjectManager::isRegistered()
105 [+TASK] improve exception message in Argument
106 [TASK] Performance tuning in container by moving some information into the cached ClassInfo object.
107 [~BUGFIX] avoid fe_user's type to be overridden
108 [+BUGFIX] Avoiding cHash for nonCacheable actions prevent action from being called. Related: #13970
109 [+BUGFIX] MVC: Make forwarding of objects work. Resolves #9867
110 [~CLEANUP] correct function parameter types
111 [+BUGFIX] Persistence: return ObjectCount return value as an integer. Thanks to Georg Ringer. Resolves #13151
112 [+BUGFIX] Revert incorrect deletion of Query::count() & Query::withUid(). Relates: #13745
113 [~CLEANUP] apply naming convention for flexForms
114 [+TASK] Move FlexForm parsing to a dedicated Service. Thanks to Rens Admiraal. Resolves #13032
115 [!!!][+BUGFIX] make backend-modules in web use new pagetree by default
116 [~CLEANUP] smaller deprecated clean-ups
117 [+FEATURE] Extbase: Enable Dependency Injection for Domain Models. Thanks to Pascal Jungblut. Resolves #11311
118 [+BUGFIX] (Persistence) Make Typo3QuerySettings exchangeable. Resolves #13191
119 [+BUGFIX] (Persistence) clone setDefaultQuerySettings for new queries. Resolves #12702
120 [~BUGFIX] correct annotations of Tx_Extbase_Persistence_Mapper_DataMapper. Resolves #13185. Thanks to Simon Schaufelberger.
121 [~TASK] (FlashMessages) finish the renaming of flashMessages
122 [+BUGFIX] (Configuration): Adjusted ConfigurationManagerInterface Interface to implementation
123 [~TASK] Extbase: Raising version from 1.3.0 to 1.4.0-devel
124 [+TASK] Extbase (MVC): Removed duplicated code from RequestBuilder. Thanks to Peter Niederlag. Resolves #12569.
125
126
127 Changes for 1.3.0:
128 ==================
129 included in TYPO3 4.5.0 LTS.
130
131 This release fixes an important bug in the persistence layer, which caused related objects not to be updated.
132
133 Full Changes for 1.3.0:
134 =======================
135
136 [+BUGFIX] Extbase (Tests): reset added t3lib_div instances in UriBuilder & Extension tests
137 [+BUGFIX] Extbase (Persistence): Fixed updating of related objects. Thanks to Björn Steinbrück and Bastian Waidelich for digging into this issue. Resolves #9270, #9182, #10211.
138 This is the second attempt after having reverted the first one in r3920. The patch includes some clean-up. Important additional changes:
139 * The objects within an ObjectStorage are now added to the queue. This is necessary to persist changes made to those contained objects without having changed the composition of objects.
140 * Moved the _memorizeCleanState() from the AbstractEntity to the AbstractDomainObject. In theory ValueObjects are immutable, but we need this as sometimes ValueObjects are stored in two steps (1. to get a UID, 2. to persist its properties). Maybe we have to recheck this for 1.4.
141 * Fixed some possible problems with detecting an ObjectStorage (namely SplObjectStorage->getUid()).
142 [+TASK] Extbase (Persistence): Added two properties to describe a weird PHP behavior if calling current() on an ObjectStorage.
143 [+BUGFIX] Extbase (MVC): Fixed argument order of Tx_Extbase_Utility_Extension::isActionCacheable() call in UriBuilder
144 [+TASK] Extbase (DomainObject): Added setPid() and getPid() to the DomainObjectInterface and removed the "final" keyword.
145 [~TASK] Extbase: Moved isActionCacheable() from UriBuilder to Utility/Extension helper class
146 Moved the protected method to a public static functions in Tx_Extbase_Utility_Extension
147 and added respective unit tests.
148 Note: We're not happy with all the public static functions in Utility/Extension.php
149 but that's currently the place for those helper functions.
150 [+TASK] Extbase (Utility): implemented validation of arguments passed to sql statements in Tx_Extbase_Utility_Cache. (resolves #11978)
151
152 Changes for 1.3.0 RC1:
153 ======================
154 included in TYPO3 4.5.0 RC1.
155
156 This release features many bugfixes, in the following areas:
157 * Persistence - invalid SQL has been fixed at various places
158 * MVC - the URI Builder can now handle cached / uncached actions correctly
159 * Improved error handling to catch some configuration errors
160 * Localization - TypoScript overrides for locallang keys with dot inside now works (_LOCAL_LANG.foo.bar)
161 * Persistence - added "pid" property and getter and setter to AbstractDomainModel; thus you can now move
162 domain objects to different pages. However, this feature has *no support for workspaces* yet.
163 * Dependency Injection - now allows the injection of prototypes (see below)
164 * Configuration - for defining the Storage PID, one can use arbitary TypoScript objects (see below)
165
166 Dependency Injection Improvements
167 ---------------------------------
168
169 Now, Prototype objects are allowed to be injected into other objects. This means the following cases
170 are supported:
171
172 * Singletons which need Singletons (most common)
173 * Singletons which need Prototypes (very uncommon,
174 as it usually hints at the fact that the injected
175 prototype should be a singleton). In this case,
176 WE WRITE A DEVLOG MESSAGE
177 * Prototypes which need Singletons
178 * Prototypes which need Prototypes
179
180 TypoScript Storage PID Improvements
181 -----------------------------------
182
183 The persistence.storagePid now has stdWrap properties so the storagePid can be set dynamically.
184 Now follows an example for use in the Frontend:
185 plugin.tx_extkey.persistence.storagePid.cObject = TEXT
186 plugin.tx_extkey.persistence.storagePid.cObject.value = 8,3
187 ... and this is how you can use it in the backend:
188 module.tx_extkey.persistence.storagePid.cObject = TEXT
189 module.tx_extkey.persistence.storagePid.cObject.value = 8,3
190
191 Full Changes for 1.3.0 RC1:
192 ===========================
193 [+BUGFIX] Extbase (Object): constructor injection now works if default value for a dependency is NULL. Thanks to Lienhart Woitok! Resolves #11623
194 [+BUGFIX] Extbase (Object): Allow injection of prototypes via dependency injection. Resolves #12013
195 [+BUGFIX] Extbase (Persistence): Use sql_free_result() in Typo3DbBackend to free result memory. Resolves #10957
196 [~BUGFIX] Extbase (Persistence): fixed an wrong referenced exception (resolves #12403)
197 [~BUGFIX] Extbase (Persistence): make Tx_Extbase_Persistence_Repository::remove() handle freshly created objects right. (resolves #11128)
198 [+BUGFIX] Extbase (MVC): UriBuilder automatically added a cHash even on links to nonCacheable actions where this is not needed/recommended (resolves #8565)
199 [~BUGFIX] Extbase (Persistence): made union statement on comma seperated list use find_in_set (Thanks to Marc Bastian Heinrichs) (resolves #9772)
200 [~FOLLOWUP] Extbase (Utility): allow clearPageCache() to clear single, multiple and all pageCaches. (resolves 11978)
201 [+TASK] Extbase (Utility): allow clearPageCache() to clear single, multiple and all pageCaches.
202 [+BUGFIX] Extbase (MVC): Improve Error Handling in Request Builder. Resolves #11302
203 [+BUGFIX] Extbase (Persistence): remove superfluous require_once statements. Thanks to Oliver Klee. Resolves #12324
204 [+BUGFIX] Extbase (Tests): Remove require_once of phpunit testclasses. Thanks to Oliver Klee. Resolves #12323
205 [+BUGFIX] Extbase (Utility): Make _LOCAL_LANG override work with dots. Thanks to Thomas Maroschik. Resolves #12121
206 [+BUGFIX] Extbase (Persistence): Fixed using the correct columnname for contains comparison with RELATION_HAS_MANY and empty parentKeyFieldName. Resolves #11048
207 [+BUGFIX] Extbase (Persistence): Added the missing pid property to the AbstractDomainModel. Related to #11361
208 [+BUGFIX] Extbase (Persistence): Language Oberlay now works with page table as well. Thanks to Andre Stoesel. Resolves #11319
209 [+BUGFIX] Extbase (Persistence): The QueryObject gets cloned now in the getFirst() method of the QueryResult (as it was intended). Thanks to Sebastian Fischer. Resolves #11855.
210 [+BUGFIX] Extbase (Bootstrap): Bootstrap calls initialize on reflectionService if it's already initialized. Resolves #12346, resolves #12156
211 [+BUGFIX] Extbase (Persistence): Fix equals constraint with $caseSensitive FALSE (closing bracket missing). Thanks to Alexander Berl. Resolves #10781
212 [+BUGFIX] Extbase (Reflection): ObjectAccess::isPropertyGettable works for ArrayAccess objects. Resolves #10148
213 [+BUGFIX] Extbase (Configuration): Allow StoragePid to be manually defined by TS. Thanks to Rens Admiraal! Resolves #8397
214 [+BUGFIX] Extbase (Configuration): Fix warning in AbstractConfigurationManager. Resolves #11631
215 [+BUGFIX] Extbase (Object): Disabling Dependency Injection for injectSettings method. Resolves #11011
216
217
218 Changes for 1.3.0 Beta 4:
219 =========================
220 included in TYPO3 4.5.0 Beta 4.
221
222 This release contains numerous bugfixes, and a few small features:
223
224 * Tx_Extbase_Utility_Extension::registerPlugin() now has a fourth parameter $pluginIconPathAndFilename
225 that you can set to the path of an icon, that will be displayed in the plugin dropdown in the backend.
226 You can use it like:
227 Tx_Extbase_Utility_Extension::registerPlugin(
228 $_EXTKEY,
229 'MyPlugin',
230 'My Plugin description',
231 t3lib_extMgm::extRelPath($_EXTKEY) . 'Resources/Public/Icons/someIcon.gif'
232 );
233 * Hidden Records in Workspaces now work
234 Before, if t3lib_pageSelect::getRecordOverlay returned FALSE (if
235 no translation is found), a fatal error occured:
236 PHP Catchable Fatal Error: Argument 2 passed to Tx_Extbase_Persistence_Mapper_DataMapper::getTargetType()
237 must be an array, boolean given, called in Persistence/Mapper/DataMapper.php
238
239 Full Changes for 1.3.0 Beta 4:
240 ==============================
241
242 [+TASK] Extbase (Tests): Fixed a repository unit test so that it works in CLI mode
243 [+TASK] Extbase (Tests): Fixed Extbase unit tests
244 [+BUGFIX] Extbase (Persistence): Hidden Records in Workspaces now work
245 [~TASK] Extbase: Fixed line endings (Windows to Unix).
246 [~TASK] Fluid (Tests): Fixed some more testcase class names and some unit tests
247 [+FEATURE] Extbase (Utility): Add support for custom specify custom plugin icon. Resolves #11179
248
249 Changes for 1.3.0 Beta 3:
250 =========================
251 included in TYPO3 4.5.0 Beta 3.
252
253 This release features numerous stability improvements, the biggest one
254 being a re-written core of the Object Manager, such that Lifecycle Methods
255 are supported now. This means, that a method "initializeObject()" gets called
256 as soon as all dependencies are injected and initialized.
257
258 Additionally, Extbase didn't work in all cases in the TYPO3 Backend. This has
259 also been improved, so Extbase (again) works in the backend
260 with an empty page tree.
261
262 Full Changes for 1.3.0 Beta 3:
263 =============================
264
265 [+BUGFIX] Extbase (Tests): Fixed Tx_Extbase_MVC_Controller_AbstractController_testcase. Thanks to Oliver Klee. Resolves #11567.
266 [BUGFIX] Extbase (Configuration): Make Extbase work again in Backend
267 [!!!][+TASK] Extbase (Object): Rewritten Object Container
268 [+BUGFIX] Extbase (MVC): Improve Exception message
269 If one misses the @dontvalidate annotation, he will
270 get a strange error which does not have a hint that
271 the @dontvalidate is missing. Now, the exception message
272 is extended.
273 [+API] Extbase (Configuration): Adding getContentObject to API
274 [+TASK] Extbase (Reflection): Added deprecation annotation to ObjectAccess::getAccessiblePropertyNames()
275 To stay in sync with FLOW3, the methods getAccessibleProperties() and getAccessiblePropertyNames() to
276 getGettableProperties() and getGettablePropertyNames().
277 For compatibility reasons the old methods will stay in Extbase until version 1.5.
278 Note: you can now check wheter properties are settable as well
279 [+FEATURE] Extbase (Reflection): Tx_Extbase_Reflection_ObjectAccess supports stdClass objects now
280 I've backported the ObjectAccess class and its unit tests from FLOW3.
281 Note: FLOW3's implementation allows to specify a third argument for the
282 method getPropertyPath() in order to support Closures.
283 This part is not backported as it's not compatible with PHP < 5.3.
284
285 Changes for 1.3.0 Beta 2a:
286 ==========================
287 included in TYPO3 4.5.0 Beta 2.
288
289 This release includes a whole bunch of bugfixes and refactorings, the most important ones listed below.
290 Because the FlashMessages now use t3lib_FlashMessage, TYPO3 4.5 is MANDATORY!
291
292 The main changes are:
293
294 * Tx_Extbase_MVC_Controller_FlashMessages now internally uses the
295 t3lib_FlashMessageQueue that has been introduced with TYPO3 4.3.
296 This results in following changes:
297 - flashmessages are now treated globally, not in a per-extension-scope. As soon as you output the messages first, the session will be flushed
298 - a flashmessage is not a simple strings anymore, but consists of
299 message body and (optionally) title & severity.
300 You can specify title and severity like this:
301 $this->flashMessages->add('Your message', 'some title', t3lib_FlashMessage::WARNING);
302 - you can now output flashmessages in backend that were set from other TYPO3 classes
303 - a revised flashmessage ViewHelper allows you to render flashmessages in the style
304 of core flashmessages now (see Fluid changelog)
305 - Resolves #10821
306 * Configuration Manager can now deal with recurring FlexForm Sections (#6067)
307 * Fixed Tx_Extbase_Domain_Model_FrontendUser (and marked the old API as deprecated)
308 * Bugfixes related to Lazy Loading
309
310 Full Changes for 1.3.0 Beta 2a:
311 ==============================
312 [+BUGFIX] Extbase (Configuration): change the order of methods to determine the current pageId for backend modules, which is used to fetch the TS framework configuration. Fixes #11205
313 [+TASK] Extbase (Object): Make sure the class info cache is returning valid objects
314 [+BUGFIX] Extbase (Persistence): Persistence_Backend::getIdentifierByObject should work with LazyLoadingProxy
315 getIdentifierByObject should check if object is an instance of Tx_Extbase_Persistence_LazyLoadingProxy and should return the
316 identifier of the real object.
317 [+BUGFIX] Extbase (Configuration): slightly tweaked FrontendConfigurationManager (basically replaced explode() by t3lib_div::trimExplode() call)
318 [+TASK] Extbase (Tests): Added some unit tests for Backend- and FrontendConfigurationManager. To be continued
319 [+BUGFIX] Extbase (DomainObject): added default __toString method to Tx_Extbase_DomainObject_AbstractDomainObject. Thanks to Marco Huber. Resolves #8083
320 [+BUGFIX] Extbase (MVC): Fixed UriBuilder for handling LazyLoadingProxy objects as arguments. Resolves #10705
321 [+TASK] Extbase (Object): re-added Tx_Extbase_Object_Manager to gain more backwards compatibility. This class is marked deprecated and will be removed in Extbase 1.5
322 [+BUGFIX] Extbase (Tests): tweaked ObjectContainer tests. Tests are failing deliberately for now
323 The DI implementation has to be rewritten, as discussed.
324 This relates to: #11160
325 [+BUGFIX] Extbase (Domain): fixed (non-breaking) method name for getting usergroup in Tx_Extbase_Domain_Model_FrontendUser. Resolves #11019
326 [+TASK] extbase (ConfigurationManager): Made FrontendConfigurationManager parse recurring sections in flexforms right. Thanks to Franz Koch (resolves #6067)
327 [+BUGFIX] Extbase (Configuration): Slightly tweaked AbstractConfigurationManager
328 [+TASK] Extbase (Tests): Added unit tests for AbstractConfigurationManager
329 Note: the ConfigurationManager now always overrides switchableControllerActions
330 when retrieving configuration for the current plugin. Before that only happened
331 when no extensionName/pluginName was specified.
332 Additionally: It's not possible anymore to specify new controllers in
333 switchableControllerAction configuration. That was the intended behavior.
334 [+TASK] Extbase (Tests): Renamed test files from "*_testcase.php" to "*Test.php"
335 [+TASK] Extbase (Tests): Moving all Tests in "Unit" directory.
336 [+FEATURE] Extbase (MVC): add possibility to output FlashMessageQueue (Resolves #10821)
337 [+TASK] Extbase (Persistence): counting query results does not work with limit constraints (resolves #10956) Tx_Extbase_Persistence_Storage_Typo3DbBackend::getObjectCountByQuery() replaces the SELECT part
338 of a query by COUNT(*) before executing a statement.
339 This did not work as expected in some cases, e.g. the LIMIT constraint was ignored by the count query.
340 [+TASK] Extbase (Persistence): findOneBy*() methods should return NULL if no item was found (Resolves #10958)
341 [+TASK] Extbase (Core): Slightly improved error handling in bootstrap (Resolves #11055)
342 [~TASK] Extbase (Utility): Changed Tx_Extbase_Utility_TypoScript:convertPlainArrayToTypoScriptArray to self::convertPlainArrayToTypoScriptArray. Resolves #10538.
343 [+BUGFIX] Extbase (MVC): UriBuilder: use current plugin if no pluginName has been specified
344 If multiple plugins are found, that are configured to handle the specified action, Extbase
345 will throw an Exception. Now, this only happens if the *current* plugin does not contain
346 the action.
347
348 Changes for 1.3.0 Beta 1a:
349 ==========================
350 included in TYPO3 4.5.0 Beta 1.
351
352 Extbase 1.3.0 Beta 1 has a lot new and greatly improved features, and also many bugfixes.
353 The highlights are outlined below, and explained in-depth a little further down.
354
355 NOTE: This release brings new table definitions, so please visit the install tool or the Extension
356 Manager and update the tables of Extbase.
357
358 *** EVERY FEATURE IS DESCRIBED IN DEPTH BELOW ***
359
360 * Dependency Injection
361 * Dispatcher Refactoring & Completely re-done Configuration Manager
362 This means that Tx_Extbase_Dispatcher is now DEPRECATED!
363 Additionally, if you defined the TypoScript setup for a plugin by hand (which you should not),
364 the syntax has changed a bit there.
365 * QueryResult refactoring (needed for Fluid Widgets)
366 THIS COULD BE A BREAKING CHANGE FOR YOU!
367
368 Additionally, the following smaller features were implemented:
369
370 * Configurable plugin namespaces (#8365)
371 * Automatic target page determination (#9121)
372 * Improved resolveView() mechanism
373 * Allowing plugins to be registered as new content element (#10666)
374 * Default Orderings & QuerySettings (#10319)
375
376 Breaking Changes:
377
378 * The UriBuilder now uses the current cObject instead of creating a new instance in the constructor. This is a breaking change if you instantiated the UriBuilder in your code. Please use the Extbase ObjectManager or inject the ConfigurationManager manually.
379 * fixed typo in getter and setter of Tx_Extbase_Domain_Model_FrontendUser::lastlogin
380 * Flashmessages now share a scope throughout the extension. Before, every plugin had it's own scope leading to the messages only being output when entering the same plugin again (e.g. redirecting from one plugin to another would never display the messages)
381
382 Known issues:
383
384 * The Unit Tests do not fully work again, we will fix that in the next days.
385 * There might be still issues with the support of backend modules, we are working on that!
386
387 Dependency Injection
388 --------------------
389
390 Instead of creating objects through t3lib_div::makeInstance, and connecting them together manually,
391 you yan now use Dependency Injection (DI) for that. Let's give an example: If my class "Tx_Foo_Controller_MyController"
392 needs another class "Tx_Foo_Service_LoggingService", it can get an instance of the logging service
393 by Dependency Injection, by specifying the following code:
394
395 class Tx_Foo_Controller_MyController {
396 protected $loggingService;
397
398 /**
399 * @param Tx_Foo_Service_LoggingService $loggingService
400 */
401 public function injectLoggingService(Tx_Foo_Service_LoggingService $loggingService) {
402 $this->loggingService = $loggingService;
403 }
404 }
405
406 The DI container finds that the class "MyController" has an method whose name starts with "inject",
407 and thus passes the logging service to MyController.
408 It is important that you can *only retrieve Singletons* through the inject annotations. If you need
409 to instanciate a prototype object, it is important to *not* use t3lib_div::makeInstance() anymore
410 (as it bypasses the DI container), but instead you need to inject the ObjectManager, and ask it
411 to create your prototype object using the create() method. Example:
412
413 class Tx_Foo_Controller_MyController {
414 protected $logFile;
415
416 /**
417 * @param Tx_Extbase_Object_ObjectManagerInterface $objectManager
418 */
419 public function injectObjectManager(Tx_Extbase_Object_ObjectManagerInterface $objectManager) {
420 $this->logFile = $objectManager->create('Tx_Foo_Domain_Model_LogFile');
421 }
422 }
423
424 In the above example, you have seen that we reference not the concrete implementation *ObjectManager*,
425 but instead the *ObjectManagerInterface*. If a name ends with "...Interface", Extbase DI automatically
426 strips away the "Interface" from the name, and expects to find a concrete implementation of that interface.
427 This is generally a very good practice: For your core classes, you should always reference an *interface*,
428 and let the DI container instanciate the concrete class.
429
430 Additionally, Extbase DI allows to *replace* certain implementation classes by other classes through
431 configuration in TypoScript. Let's give an example, and then you can see the concept:
432
433 config.tx_extbase.objects {
434 Tx_Extbase_Persistence_Storage_BackendInterface {
435 className = Tx_Extbase_Persistence_Storage_Typo3DbBackend
436 }
437 }
438
439 This essentially means to the DI container: "At all places where you encounter a "BackendInterface",
440 you should instanciate the "Typo3DbBackend" class."
441
442 However, note that this setting can only be configured *globally* right now, it is not possible
443 to override that on a per-extension basis.
444
445 Generally, the Extbase DI container provides a subset of the functionality of FLOW3's dependency injection.
446
447 Dispatcher Refactoring & Completely re-done Configuration Manager
448 -----------------------------------------------------------------
449
450 In the last versions of Extbase, the Dispatcher (Tx_Extbase_Dispatcher) was the main entry point to Extbase.
451 However, as we did not have Dependency Injection at that point, it became really complex and did lots of things
452 which it should not do in the first place. That's why we greatly improved that part. Now, any Extbase extension
453 is invoked using the Tx_Extbase_Core_Bootstrap. Additionally, the TypoScript used for the registration of any
454 Extbase extension has been cleaned up and adjusted:
455
456 lib.foo = USER
457 lib.foo {
458 userFunc = tx_extbase_core_bootstrap->run
459 extensionName = YourExtension
460 pluginName = YourPlugin
461 }
462
463 Additionally, you can also override the list of Switchable Controller Actions through TypoScript:
464
465 lib.foo = USER
466 lib.foo {
467 userFunc = tx_extbase_core_bootstrap->run
468 extensionName = YourExtension
469 pluginName = YourPlugin
470 switchableControllerActions {
471 Standard {
472 1 = action2
473 2 = action3
474 }
475 }
476 }
477
478 Of course, you cannot call actions which were not defined previously in the plugin; so the Switchable
479 Controller Actions in TypoScript can be only used to shrink the number of actions available.
480
481 NOTE: If you manually defined the above snippet, notice that there is a NON-BACKWARDS-COMPATIBLE change
482 in there. But you did that at your own risk, as that was never public API ;)
483
484 If you used Tx_Extbase_Dispatcher before in your own code, it should still work, but it is deprecated.
485 Instead, instead
486
487 OLD: Tx_Extbase_Dispatcher::getConfigurationManager()
488 NEW: inject Tx_Extbase_Configuration_ConfigurationManagerInterface into your class
489
490 OLD: Tx_Extbase_Dispatcher::getPersistenceManager()
491 NEW: inject Tx_Extbase_Persistence_ManagerInterface into your class
492
493 OLD: Tx_Extbase_Dispatcher::getExtbaseFrameworkConfiguration()
494 NEW: inject Tx_Extbase_Configuration_ConfigurationManagerInterface into your class,
495 and call $configurationManager->getConfiguration(Tx_Extbase_Configuration_ConfigurationManagerInterface::CONFIGURATION_TYPE_FRAMEWORK);
496 on the ConfigurationManager.
497
498 Please note that the Configuration Manager is STILL NO PUBLIC API, and its method signature has also changed.
499
500 QueryResult refactoring (needed for Fluid Widgets)
501 --------------------------------------------------
502
503 Before this change, a call of $query->execute() inside a repository immediately executed the query and
504 returned the result as array.
505 Now, queries are executed lazily at the first moment where you really need them. This means that $query->execute()
506 returns an object of type Tx_Extbase_Persistence_QueryResultInterface, which behaves like an array, meaning you
507 can use foreach() to loop over the query result.
508 However, due to an inconsistency of PHP, the array_* methods, and the iteration methods like current(),
509 next(), ... do NOT work on objects which implement ArrayAccess -- that's the reason why the QueryResult
510 refactoring is a breaking change.
511
512 Now, however, the following is possible:
513 * Return the first query result: $query->execute()->getFirst()
514 * Get the underlying query: $query->execute()->getQuery()
515 * Convert the result to array: $query->execute()->toArray()
516
517 This change is a prerequisite for Fluid Widgets to work. See the Fluid ChangeLog for details.
518
519
520 Configurable Plugin Namespaces
521 ------------------------------
522
523 By default each Extbase plugin has a unique URI prefix to avoid collisions with other plugins on your website.
524 This so called plugin namespace usually has the format tx_yourextension_yourplugin.
525 With Extbase 1.3 it is possible to override this namespace. This comes in handy if want to interact with 3rd party
526 extensions, for example with tt_news:
527
528 plugin.tx_yourextension.view.pluginNamespace = tx_ttnews
529
530 This sets the plugin namespace of all your plugins inside the extension to "tx_ttnews", making it possibl
531 to directly access tt_news parameters in your controller:
532
533 /**
534 * @param integer $tt_news tt_news Article uid
535 * @return void
536 */
537 public function yourAction($tt_news) {
538 // interact with $tt_news uid
539 }
540
541 This works with automatic mapping to Domain models too of course:
542
543 /**
544 * @param Tx_YourExtension_Domain_Model_NewsArticle $tt_news tt_news Article
545 * @return void
546 */
547 public function yourAction(Tx_YourExtension_Domain_Model_NewsArticle $tt_news) {
548 // interact with $tt_news object
549 }
550
551 You can also override the plugin namespace for a single instance by adding the section <view.pluginNamespace> to your
552 plugin FlexForm.
553
554
555 Automatic target page determination
556 -----------------------------------
557
558 In TYPO3 v5 we won't have the notion of page uids. To accustom developers to this change, we're trying to free you from
559 the need to specify target pages from within your Extension. Of course you can put all your functionality into one fully
560 fledged plugin, then you won't have to deal with target pages as the current page is used by default.
561
562 But sometimes you want to be able to change the surrounding contents of a special view of your extension (e.g. the
563 subcontent column of a details page). As before you can still specify the target page explicitly like:
564
565 <f:link.action action="foo" pageUid="123" />
566
567 With Extbase 1.3 you can also use a new feature called "automatic target page determination". It is disabled by default,
568 but you can enable it with the following TypoScript:
569
570 plugin.tx_yourextension.view.defaultPid = auto
571
572 Then Extbase will search the page tree for a plugin that is configured to handle the specified action and you can omit
573 the "pageUid" parameter in your links. Of course, this does not work if you use the same plugin multiple times in your
574 page tree. In this case you can override the default page ID for the respective plugins:
575
576 plugin.tx_yourextension_yourplugin.view.defaultPid = 123
577
578 Note: By default this feature is not activated, because that would be a breaking change in some cases
579
580
581 Improved resolveView() mechanism
582 --------------------------------
583
584 Another feature we backported from FLOW3 is the improved view resolving.
585 You can now change the default view implementation *per format* by inserting the following line in your Controller:
586
587 protected $viewFormatToObjectNameMap = array(
588 'json' => 'Tx_YourExtension_View_JsonView',
589 'html' => 'Tx_YourExtension_View_HtmlView'
590 );
591
592
593 Allowing plugins to be registered as new content element
594 --------------------------------------------------------
595
596 This is done using an additional parameter to Tx_Extbase_Utility_Extension::configurePlugin
597 that allows you to specify the plugin type. Example:
598
599 Tx_Extbase_Utility_Extension::configurePlugin(
600 $_EXTKEY,
601 'BlogList',
602 array('Blog' => 'index'),
603 array(),
604 Tx_Extbase_Utility_Extension::PLUGIN_TYPE_CONTENT_ELEMENT
605 );
606 (The default value for the pluginType parameter is Tx_Extbase_Utility_Extension::PLUGIN_TYPE_PLUGIN)
607
608 Default Orderings & QuerySettings
609 ---------------------------------
610
611 It is now possible to change the default orderings of a repository without you having to modify the query by setting
612 the $defaultOrderings property of your Repository to a non-empty array:
613
614 protected $defaultOrderings = array(
615 'title' => Tx_Extbase_Persistence_QueryInterface::ORDER_ASCENDING,
616 'date' => 'title' => Tx_Extbase_Persistence_QueryInterface::ORDER_DESCENDING
617 );
618
619 This will change the default ordering for all queries created by this repository. Of course you can override the
620 ordering by calling $query->setOrderings() in your custom finder method.
621
622 Besides it's now possible to change the default query settings of a repository. This way you could for instance disable
623 "respect storage pid" for all queries. We added a life-cycle method "initializeObject" to the repository which will be
624 executed as soon as the repository is created. Just override it like the following:
625
626 public function initializeObject() {
627 $querySettings = $this->objectManager->create('Tx_Extbase_Persistence_Typo3QuerySettings');
628 $querySettings->setRespectStoragePage(FALSE);
629 $this->setDefaultQuerySettings($querySettings);
630 }
631
632 Of course, QuerySettings can be overridden too in your custom finder method by calling $query->setQuerySettings();
633
634
635 Full Changes for 1.3.0 Beta 1a:
636 ===============================
637 [+TASK] Extbase: Re-implement support for BE modules
638 [+FEATURE] Extbase (Utility): Allow plugins to be registered as new content element
639 Added a fifth parameter to Tx_Extbase_Utility_Extension::configurePlugin that allows
640 you to specify the plugin type (currently "list_type" and "CType" are supported).
641 Thanks to Marc Bastian Heinrichs, Rens Admiraal & Franz Koch for your help!
642 Resolves: #10666
643 [+BUGFIX] Extbase (Utility): Added condition to Tx_Extbase_Utility_Extension::getTargetPidByPlugin() in order to only select tt_content entries that are of CType "list". Thanks to Marc Bastian Heinrichs
644 [!!!][~TASK] Extbase (Configuration): Major rework of the ConfigurationManager
645 Configuration of controllers and actions is now stored in a global registry
646 ($GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['extbase']['extensions']). But you
647 should never access this directly. Instead always retrieve the frameworkConfiguration
648 from the ConfigurationManager.
649 Inserting an Extbase plugin is now as simple as:
650 lib.foo = USER
651 lib.foo {
652 userFunc = tx_extbase_core_bootstrap->run
653 extensionName = YourExtension
654 pluginName = YourPlugin
655 }
656 This is not really a breaking change as it does not change the public API. But it's not unlikely that it changes the behavior of your Extension in case you modified the TypoScript, that is generated by Tx_Extbase_Utility_Extension::configurePlugin().
657 NOTE: Unit tests of Extbase and Fluid v4 are broken currently. We'll be fixing those asap
658 [~TAKS] Extbase (MVC): FrontendRequestHandler now retrieves the current cObject through the ConfigurationManager
659 [+BUGFIX] Extbase (MVC): FrontendRequestHandler was refering to $this->frameworkConfiguration which wasn't available
660 [-API] Extbase (MVC): marked Tx_Extbase_MVC_Web_Request::getContentObjectData() deprecated as should retrieve the current cObject through the ConfigurationManager
661 [+TASK] Extbase (MVC): modified the Tx_Extbase_MVC_Web_RequestBuilder so that it's possible to change the action only by specifying the action parameter. Before you had to specify the controller as well, even if it was the default controller
662 [+BUGFIX] Extbase (MVC): Flashmessages now share a scope throughout the extension. Before, every plugin had it's own scope leading to the messages only being output when entering the same plugin again (e.g. redirecting from one plugin to another would never display the messages)
663 [~TASK] Extbase (Core): The Flashmessages now get persisted in the Bootstrap in resetSingletons()
664 [-TASK] Extbase (Core): Removed some commented lines from Bootstrap
665 [FEATURE] Extbase (Object): Make DI Class Mapping configurable through TS
666 It is now possible to configure the Dependency Injection class mapping by specifying:
667 config.tx_extbase.objects.[FullyQualifiedObjectName].className = [NewClassName]
668 This has the effect of effectively replacing [FullyQualifiedObjectName] with
669 [NewClassName].
670 Resolves: #10559
671 [-TASK] Extbase (Utility): Removed two obsolete checks for $GLOBALS['TSFE']->tmpl->setup['tt_content.']['list.']['20.'] in Tx_Extbase_Utility_Extension
672 [~TASK] Extbase: added two doc comments that were missing
673 [+BUGFIX] Extbase (Persistence): Extbase still used PHPs current() on some QueryResults in Persistence/Repository. Replaced these by calls to the getFirst() method of the QueryResult
674 [+TASK] Extbase (Persistence): added a private field to the QueryResult to make the above case easier to debug: When calling current() on an Iterator, PHP returns the first field of that object instead of calling the current() method of the Iterator interface.. With our somewhat pragmatic approach you'll see the warning if you debug the results of current($query->execute())
675 [+BUGFIX] Extbase (Persistence): Replaced two occurrences of Query->count() by Query->execute()->count() to avoid deprecated warnings in the Core
676 [+BUGFIX] Extbase (MVC): view configuration (templateRootPath, ...) has to be set before View::canRender() is called
677 [!!!][+TASK] Extbase (MVC): The UriBuilder now uses the current cObject instead of creating a new instance in the constructor. This is a breaking change if you instantiated the UriBuilder in your code. Please use the Extbase ObjectManager or inject the ConfigurationManager manually.
678 [+BUGFIX] Extbase (Reflection): ReflectionService now uses a cacheIdentifier per Extension. Besides the Bootstrap now resets the ReflectionService after dispatching a request. This resolves #10146
679 [+TASK] Extbase (Configuration): The ConfigurationManager now holds the current cObject. You can retrieve it via ConfigurationManagerInterface::getContentObject()
680 [+BUGFIX] Extbase (Configuration): When loading configuration of other plugins, the context specific configuration (e.g. flexform settings) are no longer merged with the frameworkConfiguration
681 [+BUGFIX] Extbase (MVC): Controllers are no Singletons by default. If a controller contains stateful fields (e.g. $this->settings) this breaks multiple plugins on one page
682 [+TASK] Extbase (Persistence): QuerySettings now also store the storage page id(s). This is required for the upcoming Ajax Widgets
683 [+BUGFIX] Extbase: fixed php warning in Tx_Extbase_Persistence_LazyLoadingProxy when loading the real instance would return NULL. Resolves #10683
684 [+BUGFIX] Extbase: use 3rd parameter = TRUE of t3lib_div::trimExplode to split switchableControllerActionParts from flexform. Thanks to Georg Ringer. Resolves #10688
685 [+TASK] Extbase: Replaced "public static" by "static public" in various places to be CGL conform
686 [+TASK] Extbase: Marked Utitlity_Extension camelCase/underscore helper functions deprecated
687 [+TASK] Extbase: Removed obsolete FIXME comments, whitespace fixes
688 [!!!] Extbase: Reintegrating branch "dispatcher" to trunk. Resolves: #10605
689 Branch history:
690 [+FEATURE] Extbase (Configuration): Extend ConfigurationManager so that it can load configuration of different plugins
691 [+FEATURE] Extbase (Configuration): 1st level cache for ConfigurationManager. Resolves: #10717. Resolves: #10716
692 [+TASK] Extbase: cleaned up Configuration* implementation, replaced t3lib_div::makeInstance() calls
693 Streamlined ConfigurationManager API and enforced its usage throughout the Extbase classes.
694 Replaced all t3lib_div::makeInstance() calls by $objectManager->create()/$objectManager->get() throughout the Extbase classes.
695 Some smaller tweaks and fixes. Resolves: #10655. Resolves: #10712
696 [TASK] Extbase (Object): Make tests work again. Resolves: #10709
697 [TASK] Extbase (Object): Updated autoload.php and emconf. Relates to: #10561
698 [TASK] Extbase (Object): Use typed exceptions. Relates to: #10561
699 [TASK] Extbase (Object): CGL cleanup
700 Additionally, removed support for @inject annotations at methods. Relates to: #10561
701 [TASK] Extbase (Object): Remove getParents. Relates to: #10561
702 [TASK] Extbase (Object): Remove isSingleton. Relates to: #10561
703 [TASK] Extbase (Object): Remove injectExtensionSettings feature. Relates to: #10561
704 [TASK] Extbase (Object): Change namespaces to Tx_Extbase_Object_Container. Relates to: #10561
705 [TASK] Extbase (Object): Add Container to Extbase. Relates to: #10561
706 [+TASK] Extbase (Core): moved Tx_Extbase_Bootstrap to Tx_Extbase_Core_Bootstrap
707 Moving Bootstrap to be compliant with FLOW3
708 Removed obsolete Classes. Resolves: #10704
709 [+TASK] Extbase: Merged current trunk (r2689) with local modifications into dispatcher branch
710 Note: This still needs a cleanup and some fixes (see FIXME comments) before it can be merged back to the trunk. Relates to: #10605. Relates to: #10655
711 [+TASK] Extbase (Configuration): Moved CONFIGURATION_TYPE_* constraints to ConfigurationManagerInterface. Resolves #10604.
712 [~TASK] Extbase (Configuration): The concrete configuration management strategy gets instanciate only once now.
713 [+FEATURE] Extbase (MVC): Decoupled framework settings from Dispatcher.
714 With the new dependency injection feature you can get the Configuration Manager injected by adding the lines
715 protected $configurationManager;
716 public function injectConfigurationManager(Tx_Extbase_Configuration_ConfigurationManagerInterface $configurationManager) {
717 $this->configurationManager = $configurationManager;
718 }
719 You can get various types of configuration invoking
720 $this->configurationManager->getConfiguration(Tx_Extbase_Configuration_ConfigurationManager::CONFIGURATION_TYPE_EXTBASE)
721 where the class constant must be either CONFIGURATION_TYPE_EXTBASE (for Extbase settings), or CONFIGURATION_TYPE_SETTINGS (for the current module/plugin settings), or CONFIGURATION_TYPE_TYPOSCRIPT (for a raw TS array). Resolves #4741.
722 [~TAKS] Extbase: Removed obsolete code.
723 [~TASK] Extbase: Added core patch for mod.php (see previous commit).
724 [+TASK] Extbase: Changed the way a module gets called.
725 - You can now specify a function name to be invoked by mod.php:
726 $TBE_MODULES['_dispatcher'][] = 'Tx_Extbase_Bootstrap->callModule';
727 - This requires a core patch.
728 [~TASK] Extbase: Changed configuration of the RequestHandler class names to TypoScript.
729 - The request handlers can now be registered in TypoScript with the setting:
730 config.tx_extbase.mvc.requestHandlers.[RequestHandlerClassName] = [RequestHandlerClassName].
731 - There are now two RequestHandlers in Extbase: FrontendRequestHandler and BackendRequestHandler. Common functionality is in the AbstractRequestHandler.
732 [+API][+FEATURE] Extbase (Utility): Implemented mechanism to register RequestHandlers.
733 [+TASK] Extbase: Backported Request Handler Resolver.
734 [~TASK] Extbase: Added "deprecated" annotation to Dispatcher.
735 [~TASK] Extbase: Added missing comment.
736 [+BUGFIX] Extbase (Reflection): The ReflectionService now gets injected to the dispatcher. Related to #10146.
737 [+BUGFIX] Extbase (Reflection): Changed the way the Reflection Service and it's cache gets initialized.
738 * Removed check for pre-initialized Reflection Service in the Bootstrap.
739 * Now using a fixed cache key ('ReflectionData').
740 Related to #10146.
741 [~TASK] Extbase: First step of the Dispatcher refactoring.
742 * Added and adapted some Unit Tests.
743 * Moved the Dispatcher to MVC.
744 * Added a backwards compatibility Dispatcher on root level.
745 * Added a Bootstrap class.
746 * Removed all backend module support for now.
747 Related to #7153.
748 [+TASK] Extbase: Added branch for the dispatcher refactoring.
749 [!!!][+BUGFIX] Extbase: fixed typo in getter and setter of Tx_Extbase_Domain_Model_FrontendUser::lastlogin . Thanks to Christian Schwan. Resolves #9345
750 [+FEATURE] Extbase (MVC): Backport possibility to change the view object class name more easily
751 Backported FLOW3s improved resolveView() mechanism. Tx_Fluid_View_TemplateView is still the default implementation, but can be easily changed by setting $defaultViewObjectName in your controller. Besides it's possible to specifying different views depending on the current request format by setting $viewFormatToObjectNameMap.
752 NOTE: If the view can't be rendered, the new template based "NotFoundView" will be created. So instead of the invisible HTML comments of the EmptyView, you'll get a more meaningful error message if the template file could not be found
753 Resolves: #8990
754 [!!!][+FEATURE] Extbase (Persistence): Backport QueryResult from FLOW3
755 Now Query::execute() returns an instance of QueryResultInterface that allows it to modify the query before actually accessing the records that it retrieves. This is required for the upcoming "Fluid widgets" backport (#10568).
756 NOTE: This change is not backwards compatible, if you work with PHPs array_* functions on the query result. To work around this issue, you'll have to convert the query result to an array before by calling the QueryResult::toArray() method. We're planning to add a compatibility mode, but that's not yet implemented.
757 Resolves: #10566
758 [+BUGFIX] Extbase (Object): Minor fix in ObjectManager to make it compatible with PHP 5.2.x
759 Relates to: #9062
760 [+BUGFIX] Extbase (Object): Refactor Object Manager
761 The Object Manager is now at the same location and
762 has the same API as in FLOW3.
763 [+BUGFIX] Extbase: Major cleanups to Dependency Injection and Persistence
764 Now, DI finally works with Persistence, cleaning
765 this greatly up. Additionally, all internal
766 t3lib_div::makeInstance calls have been replaced.
767 Now, dependency injection is actually usable.
768 Additionally, we completely thought over which
769 persistence classes need to be singleton and which
770 should be prototype, leading finally to a
771 coherent design in the persistence layer.
772 [+BUGFIX] Extbase: remove non-used interfaces
773 Removed classes which were not used.
774 Relates to: #9062
775 Resolves: #10585
776 Resolves: #10564
777 * Cleaned up Persistence Backend
778 * Cleaned up QOM Factory
779 [+BUGFIX] Extbase (MVC): Fix arguments object
780 The arguments object is now correctly inheriting from ArrayObject
781 Resolves: #10562
782 [+BUGFIX] Extbase (MVC): Make database connection work again
783 Resolves: #10585
784 [+FEATURE] Extbase (DI): merging DI into trunk. (resolves #10558)
785 [+TASK] Extbase: Undefined identifier in Tx_Extbase_Persistence_Storage_Typo3DbBackend::removeRow
786 Method clearPageCache was given an undefined variable $uid as second parameter.
787 Resolves: #10570
788 [+TASK] Extbase: $query->contains generate incomplete SQL
789 Use FIND_IN_SET instead of a self-constructed query of LIKE statements
790 Resolves: #8959
791 [+BUGFIX] Extbase (Persistence): Removed method createQuery from the QOMFactory. It is neither part of the API nor is it used by Extbase. Resolves #10215
792 [+BUGFIX] Extbase (Property): Minor fix in PHP doc comment
793 Fix the order of @param annotation in Tx_Extbase_Property_Mapper::mapAndValidate()
794 Resolves: #5887
795 [~CONFIGURATION] Extbase (MVC): Changed default value for automatic target page determination
796 The page id gets automatically detected if plugin.tx_extensionname_pluginname.view.defaultPid
797 is an empty string (was "auto" before). This ensures backwards compatibility.
798 Resolves #9121
799 [TASK] Extbase: moved Release Notes to ChangeLog.txt.
800 [+FEATURE] Extbase (MVC): Automatic target page determination
801 you can use the "pageUid" argument of the link.* and uri.* view helpers
802 to link to a different page. That is deprecated though as we won't have
803 the notion of "page uids" in v5. Instead the target page is now determined
804 automatically.
805 If the target page can't be determined because more than one active
806 plugin is capable of handling the action an exception will be thrown.
807 In that case you'll have to define the target page either by using the
808 pageUid argument or - preferably - by setting
809 plugin.tx_extensionname_pluginname.view.defaultPid to a fixed page uid.
810 Note: This feature still has to be documented!
811 Resolves: #9121
812 [+FEATURE] Extbase (MVC): Configurable plugin namespace
813 until now the namespace (aka prefix) of Extbase plugins was
814 fixed (tx_extensionname_pluginname). This is now configurable
815 via TypoScript. Just write:
816 plugin.tx_extensionname_pluginname.view.pluginNamespace = my_custom_namespace
817 to change the prefix for a specific plugin or
818 plugin.tx_extensionname.view.pluginNamespace = my_custom_namespace
819 to change if for the whole extension.
820 Note: This feature still has to be documented!
821 Resolves: #8365
822
823 Changes for 1.3.0 Alpha 2:
824 ==========================
825 included in TYPO3 4.5.0 Alpha 2.
826
827 Since the last version, one (possible BREAKING) change happened:
828
829 * Fixed Extbase Caching Bug.
830 Non-cacheable actions were cached due to the fact that TYPO3s
831 TypoScript condition "GP" does not merge GET & POST vars.
832 Additionally "switchableControllerActions" that were overridden
833 in the plugin flexform were not taken into account.
834
835 !!! This is a breaking change if you set up your TS configuration
836 of the plugin manually.
837
838 Full Changes:
839 -------------
840
841 [!!!][+BUGFIX] Extbase: Fix Extbase Caching Bug (thanks to Bastian Waidelich)
842
843 [-TASK] Extbase (MVC): removed fallback to current page in AbstractController::redirect() as that's already done within the UriBuilder if $targetPageUid is NULL
844
845
846 Changes for 1.3.0 Alpha 1:
847 ==========================
848 included in TYPO3 4.5.0 Alpha 1.
849
850 Since the last version, the following notable things happened:
851
852 * All methods trying to find an object by uid now ignore the storagePid. This changes the behavior of argument mapping and the way extbase fetches 1:1 relations. Resolves #5631. You should not experience any negative side-effects of this change, i.e. if your extension worked before, it will definitely after this change. However, it makes the record handling more robust.
853 * Performance improvements in TypoScript::convertTypoScriptArrayToPlainArray. Thanks to Timo Schmidt.
854 * Numerous other bugfixes, see below.
855
856 Full Changes:
857 -------------
858 [~TASK] Extbase: Raised version number to 1.3.0-devel to reflect the version scheme defined in the wiki. Resolves #9152. Thanks Xavier for pointing to it.
859 [+TASK] Extbase (MVC): cleaned up View implementations and added assign() and assignMultiple() methods to ViewInterface. This resolves #9137
860 [+BUGFIX] Extbase: Fixed a small typo in extension description.
861 [+BUGFIX] Extbase (Persistence): DataMapper now mapps NULL into a property on non-existing related object instead of FALSE. Resolves #8973.
862 [+BUGFIX] Extbase (Reflection): getParentClass() in Tx_Extbase_Reflection_ClassReflection no longer causes a fatal error if no parent class exists. Resolves #8800.
863 [+BUGFIX] Extbase (Utility): Improved performance of TypoScript::convertTypoScriptArrayToPlainArray. Thanks to Timo Schmidt. Resolves #8857.
864 [~TASK] Extbase: Changed state to 'stable'. Resolves #8768.
865 [+BUGFIX] Extbase: Fixed EOL and encoding of several files. Resolves #8876.
866 [+BUGFIX] Extbase (MVC): Fixed a problem where a non-required action argument throwed Exception if it was not found in the Backend. Thanks to Marc Bastian Heinrichs. Resolves #7277.
867 [!!!][+BUGFIX] Extbase (Persistence): All methods trying to find an object by uid now ignores the storagePid. This changes the behavior of argument mapping and the way extbase fetches 1:1 relations. Resolves #5631.
868 [+BUGFIX] Extbase (Persistence): Fixed a problem where localized objects inside an aggregate are not translated. Resolves #8555.
869 [~TASK] Extbase: Removed new lines at the end of php files.
870
871 RELEASE NOTES of Extbase v1.0.0
872 ===============================
873
874 This package contains the Extbase Framework for Extensions. You may
875 also want to install the BlogExample (blog_example) to experiment
876 with. This little example extension demonstrates some of the main
877 features of Extbase. The documentation is bundled in a separate
878 extension called doc_extbase. Both, the blog_example and the
879 doc_extbase can downloaded via TER.
880
881 http://typo3.org/extensions/repository/view/blog_example/current/
882 http://typo3.org/extensions/repository/view/doc_extbase/current/
883
884 Currently Extbase is in ALPHA state. Do not expect everything in the
885 right place and shape. And keep in mind that the API may change
886 until TYPO3 v4.3beta1 is released.
887
888 If you have any feature requests or encountered issues regarding
889 this package please use the facilities on forge to report.
890
891 We are very open to answer your questions. Please use the newsgroup
892
893 typo3.projects.typo3v4mvc on lists.netfielders.de
894
895 so other developers can react to your comments and also
896 profit from the postet solutions. Do not contact a member of the
897 development team via private email (or skype, or visits, or ...)
898 until he accepted this channel. We all do coding for Extbase on
899 our sparetime and must handle our regular work load - and don't
900 forget about our families ;-).
901
902 We hope you have fun with this package!
903
904 -- Your Extbase Development Team
905
906 HOW TO CREATE THE CHANGELOG
907 ===========================
908 git log [startRevision]..HEAD --pretty=format:"%s%n%b%n" | grep -v "^$" | grep -v "git-svn-id"
909
910 Verify that the merge into the Core succeeded:
911 diff -urNw --exclude=".git" --exclude=".svn" -I "@version" ../../../typo3/sysext/extbase/ .