tonyair/silverstripe-framework
1
0
Fork 0
mirror of https://github.com/silverstripe/silverstripe-framework synced 2024-10-22 14:05:37 +02:00
Code Issues Projects Releases Wiki Activity

DOCS Clarify nested cache block restrictions

Browse Source 
Fixes #6078
This commit is contained in:
Jonathon Menz 2016-10-13 14:52:41 -07:00
parent 646d34ec48
commit d2c0b98bc5
1 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/en/02_Developer_Guides/08_Performance/00_Partial_Caching.md
View File

@ -209,8 +209,8 @@ could also write the last example as:
<% end_cached %>
<div class="warning" markdown="1">
Currently cached blocks can not be contained within if or loop blocks. The template engine will throw an error
letting you know if you've done this. You can often get around this using aggregates.
Currently a nested cache block can not be contained within an if or loop block. The template engine will throw an error
letting you know if you've done this. You can often get around this using aggregates or by un-nesting the block.
</div>
Failing example:
@ -219,7 +219,7 @@ Failing example:
<% cached $LastEdited %>
<% loop $Children %>
<% cached LastEdited %>
<% cached $LastEdited %>
$Name
<% end_cached %>
<% end_loop %>
@ -239,6 +239,19 @@ Can be re-written as:
<% end_cached %>
Or:
:::ss
<% cached $LastEdited %>
(other code)
<% end_cached %>
<% loop $Children %>
<% cached $LastEdited %>
$Name
<% end_cached %>
<% end_loop %>
## Cache expiry
The default expiry for partial caches is 10 minutes. The advantage of a short cache expiry is that if you have a problem