Skip to content

Embed related content

To embed content in another Content item, you query for it in the Repository. There are two ways to query for a Content item:

Embed siblings with Query type

To render the Siblings of a Content item (other content under the same parent Location), use the Siblings Query type.

To do it, use the built-in ez_query controller's contentQueryAction:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
            content_view:
                full:
                    blog_post:
                        controller: ez_query::contentQueryAction
                        template: '@ezdesign/full/blog_post.html.twig'
                        params:
                            query:
                                query_type: 'Siblings'
                                parameters:
                                    content: '@=content'
                                    limit: 3
                                    sort: 'date_published desc'
                                assign_results_to: items
                        match:
                            Identifier\ContentType: blog_post

The results of the Siblings query are placed in the items variable, which you can use in the template:

1
2
3
4
{{ ez_content_name(content) }}
{% for item in items.searchHits %}
    {{ ez_render(item.valueObject, {'viewType': 'line'}) }}
{% endfor %}

Embed Relations with a custom controller

You can use a custom controller for any situation where Query types are not sufficient.

1
2
3
4
5
6
7
                    article:
                        controller: App\Controller\RelationController::showContentAction
                        template: '@ezdesign/full/article.html.twig'
                        params:
                            accepted_content_types: [ 'article', 'test_target', 'test_source' ]
                        match:
                            Identifier\ContentType: article

This configuration points to a custom RelationController that should render all Articles with the showContentAction() method.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
<?php declare(strict_types=1);

namespace App\Controller;

use eZ\Publish\API\Repository\ContentService;
use eZ\Publish\API\Repository\LocationService;
use eZ\Publish\Core\MVC\Symfony\View\View;

class RelationController
{
    private $contentService;

    private $locationService;

    public function __construct(ContentService $contentService, LocationService $locationService)
    {
        $this->contentService = $contentService;
        $this->locationService = $locationService;
    }

    public function showContentAction(View $view, $locationId)
    {
        $acceptedContentTypes = $view->getParameter('accepted_content_types');

        $location = $this->locationService->loadLocation($locationId);
        $contentInfo = $location->getContentInfo();
        $versionInfo = $this->contentService->loadVersionInfo($contentInfo);
        $relations = $this->contentService->loadRelations($versionInfo);

        $items = [];

        foreach ($relations as $relation) {
            if (in_array($relation->getDestinationContentInfo()->getContentType()->identifier, $acceptedContentTypes)) {
                $items[] = $this->contentService->loadContentByContentInfo($relation->getDestinationContentInfo());
            }
        }

        $view->addParameters([
            'items' => $items,
        ]);

        return $view;
    }
}

This controller uses the Public PHP API to get the Relations of a Content item (lines 27-28).

The controller takes the custom parameter called accepted_content_types (line 23), which is an array of Content Type identifiers that are rendered.

This way you can control which Content Types you want to show or exclude.

Finally, the controller returns the view with the results that were provided in the items parameter. You can use this parameter as a variable in the template:

1
2
3
4
5
6
7
8
{% block content %}
<h1>{{ ez_content_name(content) }}</h1>
<ul>
    {% for item in items %}
        {{ ez_render(item, {'viewType': 'embed'} ) }}
    {% endfor %}
</ul>
{% endblock %}