Skip to content

Added doc for additional parameter for ibexa_render #3043

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mnocon wants to merge 3 commits into
base: 4.6
Choose a base branch
from
Open

Added doc for additional parameter for ibexa_render #3043

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
96d3331
Added doc for additional parameter for ibexa_render
mnocon Feb 4, 2026
8ceb8e4
Added update sections
mnocon Feb 5, 2026
7838c3f
Update docs/update_and_migration/from_5.0/update_from_5.0.md
mnocon Feb 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions docs/release_notes/ibexa_dxp_v4.6.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,37 @@ month_change: false

<div class="release-notes" markdown="1">

[[% set version = 'v4.6.28' %]]
[[= release_note_entry_begin("Ibexa DXP " + version, '2026-02-04', ['Headless', 'Experience', 'Commerce']) =]]
Copy link
Contributor Author

@mnocon mnocon Feb 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This date will be changed, just wanted to have a quick draft ready


### Developer experience

#### Pass custom parameters to `ibexa_render()` Twig function

You can now pass custom parameters to templates when using the `ibexa_render()` Twig function with the new `params` option, similar to how you can with `render(controller())`.

This allows you to provide additional context or data to your view templates:

``` html+twig
{{ ibexa_render(content, {
'viewType': 'line',
'method': 'inline',
'params': {
'custom_param': 'custom_value',
'another_param': 'another_value'
}
}) }}
```

The parameters are available in your template as regular variables.

For more information, see [`ibexa_render()` Twig function](content_twig_functions.md#ibexa_render).

### Full changelog

[[% include 'snippets/release_46.md' %]]
[[= release_note_entry_end() =]]

[[% set version = 'v4.6.27' %]]
[[= release_note_entry_begin("Ibexa DXP " + version, '2026-02-03', ['Headless', 'Experience', 'Commerce']) =]]

Expand Down
31 changes: 31 additions & 0 deletions docs/release_notes/ibexa_dxp_v5.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,37 @@ month_change: false

<div class="release-notes" markdown="1">

[[% set version = 'v5.0.6' %]]
[[= release_note_entry_begin("Ibexa DXP " + version, '2026-02-04', ['Headless', 'Experience', 'Commerce']) =]]

### Developer experience

#### Pass custom parameters to `ibexa_render()` Twig function

You can now pass custom parameters to templates when using the `ibexa_render()` Twig function with the new `params` option, similar to how you can with `render(controller())`.

This allows you to provide additional context or data to your view templates:

``` html+twig
{{ ibexa_render(content, {
'viewType': 'line',
'method': 'inline',
'params': {
'custom_param': 'custom_value',
'another_param': 'another_value'
}
}) }}
```

The parameters are available in your template as regular variables.

For more information, see [`ibexa_render()` Twig function](content_twig_functions.md#ibexa_render).

### Full changelog

[[% include 'snippets/release_50.md' %]]
[[= release_note_entry_end() =]]

[[% set version = 'v5.0.5' %]]

[[= release_note_entry_begin("Ibexa DXP " + version, '2026-01-15', ['Headless', 'Experience', 'Commerce']) =]]
Expand Down
8 changes: 8 additions & 0 deletions docs/templating/twig_function_reference/content_twig_functions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ You can provide `ibexa_render()` with either a content item or a Location object
|`content` or `location`|[`Content`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-Content.html), [`ContentAwareInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-ContentAwareInterface.html) or [`Location`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-Location.html)|Content item or its location.|
|`method`|`string`|(optional) [Rendering method](#rendering-methods). One of: `direct`, `inline`, `esi`, `ssi`. (Default method is `direct`)|
|`viewType`|`string`|(optional) [View type](template_configuration.md#view-types). (Default view type is `embed`)|
|`params`|`array`|(optional) Hash of variables to pass to the template.|

#### Rendering methods

Expand All @@ -48,6 +49,13 @@ You can pass one of the following rendering methods to `ibexa_render()`:
{{ ibexa_render(content, {'viewType': 'line'}) }}

{{ ibexa_render(content, {'method': 'inline'}) }}

{{ ibexa_render(content, {
'viewType': 'line',
'params': {
'custom_param': 'custom_value'
}
}) }}
```

## Content information
Expand Down
4 changes: 4 additions & 0 deletions docs/update_and_migration/from_4.6/update_from_4.6.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -566,6 +566,10 @@ If you do, add the required dependencies to your project:
composer require guzzlehttp/guzzle:^6.5 php-http/guzzle6-adapter:^2.0
```

## v4.6.28

No additional steps needed.

<!-- End of update instructions -->

[[% include 'snippets/update/notify_support.md' %]]
Expand Down
4 changes: 4 additions & 0 deletions docs/update_and_migration/from_5.0/update_from_5.0.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -281,6 +281,10 @@ Run the provided SQL upgrade script to ensure the Messenger tables for [backgrou
psql <database_name> < vendor/ibexa/installer/upgrade/db/postgresql/ibexa-5.0.4-to-5.0.5.sql
```

## v5.0.6

No additional steps needed.

## LTS Updates and additional packages

[LTS Updates](editions.md#lts-updates) are standalone packages with their own update procedures.
Expand Down