URLs на основе документов и красивых URL

Введение

Одним из основных вариантов маршрутизации в Pimcore являются пути документов Pimcore. Вместе с «красивыми» URL они определяют адрес документа в браузере. Путь документа и красивые URL обрабатываются третьими по приоритету при обработке маршрутов.

Путь документа

Каждый документ имеет путь (в дереве документов), который напрямую соответствует адресу в браузере (например, https://demo.pimcore.org/en/basic-examples).

Если существует путь документа, совпадающий с запрошенной частью пути, то маршрут использует контроллер, действие и представление, определённые в настройках документа, передавая их диспетчеру вместе с самим документом. См. документацию по документам для подробностей по настройке документов.

Красивый URL (пользовательские slugs / чистый URL)

Настройка Pretty URL (красивый URL) переопределяет полный путь документа только для целей маршрутизации. Это полезно, когда вы хотите создавать более короткие пути или удобные для восприятия URL для шаринга. «Красивый» URL не выполняет перенаправление на исходный URL.

Красивые URL можно задать в настройках документа, как показано на скриншоте ниже.:

Создание URL для документов

По умолчанию маршрут также отвечает за сборку (формирование) URL для документов.

Пример

Простая ссылка на другой документ

<a href="{{ pimcore_document(2) }}">Test-Link</a>  
  
/* ИЛИ */  
  
{% set document = pimcore_document(2) %}  
<a href="{{ document.fullpath }}">Test-Link</a>  

Ссылка на /about

Ссылка на тот же документ (из которого пришёл запрос) с добавлением параметров

<a href="{{ pimcore_url({'key': 'value'}) }}">Test-Link</a>  

Ссылка на /about?key=value