ngbm_render_zone
¶
This tag is used to render an entire layout zone. Since zones do not have their own template, this tag simply renders all blocks one after another.
Note
Examples below show usage as if the tag is used in frontend layout templates
which load the zone from ngbm.layout
variable available in those
templates. This does not mean you can’t transfer an instance of
Netgen\BlockManager\API\Values\Layout\Zone
object manually.
To render a zone, you can simply call the tag with the zone in question:
{% ngbm_render_zone ngbm.layout.zone('left') %}
This will render the provided zone in the default
view context.
You can also render the zone with your own custom view context:
{% ngbm_render_zone ngbm.layout.zone('left') context='my_context' %}
Warning
When rendering a zone with a custom view context, all blocks and block items which do not specify custom view context will be rendered with the view context you provided. You need to make sure all your blocks and block items have the templates for specified view context, otherwise, you will get an exception while rendering the page.