72 lines
1.8 KiB
ReStructuredText
72 lines
1.8 KiB
ReStructuredText
|
|
.. include:: /Includes.rst.txt
|
|
|
|
.. _feature-64200:
|
|
|
|
==================================================
|
|
Feature: #64200 - Allow individual content caching
|
|
==================================================
|
|
|
|
See :issue:`64200`
|
|
|
|
Description
|
|
===========
|
|
|
|
The `stdWrap.cache.` property is now available as first-class function to all
|
|
content objects. This skips the rendering even for content objects that evaluate
|
|
`stdWrap` after rendering (e.g. `COA`).
|
|
|
|
Usage:
|
|
|
|
.. code-block:: typoscript
|
|
|
|
page = PAGE
|
|
page.10 = COA
|
|
page.10 {
|
|
cache.key = coaout
|
|
cache.lifetime = 60
|
|
#stdWrap.cache.key = coastdWrap
|
|
#stdWrap.cache.lifetime = 60
|
|
10 = TEXT
|
|
10 {
|
|
cache.key = mycurrenttimestamp
|
|
cache.lifetime = 60
|
|
data = date : U
|
|
strftime = %H:%M:%S
|
|
noTrimWrap = |10: | |
|
|
}
|
|
20 = TEXT
|
|
20 {
|
|
data = date : U
|
|
strftime = %H:%M:%S
|
|
noTrimWrap = |20: | |
|
|
}
|
|
}
|
|
|
|
The commented part is `stdWrap.cache.` property available since 4.7,
|
|
that does not stop the rendering of `COA` including all sub-cObjects.
|
|
|
|
Additionally, stdWrap support is added to key, lifetime and tags.
|
|
|
|
|
|
Impact
|
|
======
|
|
|
|
If you've previously used the `cache.` property in your custom cObject,
|
|
this will now fail, because `cache.` is unset to avoid double caching.
|
|
You are encouraged to rely on the core methods for caching cObjects or
|
|
rename your property.
|
|
|
|
`stdWrap.cache` continues to exists and can be used as before. However
|
|
the top level `stdWrap` of certain cObjects (e.g. `TEXT` cObject)
|
|
will not evaluate `cache.` as part of `stdWrap`, but before starting
|
|
the rendering of the cObject. In conjunction the storing will happen
|
|
after the `stdWrap` processing right before the content is returned.
|
|
|
|
Top level `cache.` will not evaluate the hook
|
|
`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_content.php']['stdWrap_cacheStore']`
|
|
any more.
|
|
|
|
|
|
.. index:: PHP-API, TypoScript, Frontend
|