Warning: You are browsing the documentation from version 4 to 10 of Pimcore.
Please visit https://pimcore.com/docs/platform/ for the latest versions of Pimcore.
Version:
Edit on GitHub
Snippet Editable¶
General¶
Use the snippet editable to embed a document snippet, for example teasers or other boxes into your document.
Snippets are like little pages which can be embedded in other documents. You have to create them the same way as other documents (pages).
Configuration¶
Name | Type | Description |
---|---|---|
defaultHeight |
integer | A default height if the element is empty |
height |
integer | Height of the snippet in pixel |
reload |
bool | Reload document on change |
title |
string | You can give the element a title |
width |
integer | Width of the snippet in pixel |
class |
string | A CSS class that is added to the surrounding container of this element in editmode |
cache |
bool | Enable cache for rendered snippet |
Methods¶
Name | Return | Description |
---|---|---|
getId() |
int | ID of the assigned snippet |
getSnippet() |
Snippet | The assigned snippet object |
isEmpty() |
bool | Whether the editable is empty or not. |
Examples¶
Basic Usage¶
{{ pimcore_snippet("mySnippet", {"width": 250, "height": 100}) }}
Caching¶
By default caching is disabled.
You can enable snippet caching by passing the configuration cache: true
or
by enabling the full page cache.
Regardless if you're using the full page cache or not it's a good practice to
enable the cache directly on the editable if the snippet result should be cached.
{{ pimcore_snippet("mySnippet", {cache: true}) }}