🎨 Twig-функции и фильтры

В шаблонах apidcms доступны все стандартные возможности Twig плюс собственные функции.

Функции

url(path)

Генерирует URL страницы сайта.

<a href="{{ url('docs') }}">Документация</a>
<a href="{{ url(nav_item.url ~ '/' ~ item.slug) }}">{{ item.title }}</a>

asset(path)

Генерирует URL для статического файла.

<img src="{{ asset('images/logo.png') }}" alt="Лого">
<link rel="stylesheet" href="{{ asset('css/custom.css') }}">

get_setting(key)

Получает значение системной настройки.

<title>{{ get_setting('site_title') }}</title>
<meta name="description" content="{{ get_setting('site_description') }}">

get_navigation()

Возвращает массив всех активных пунктов меню.

{% for item in get_navigation() %}
  <a href="{{ url(item.url) }}">{{ item.title }}</a>
{% endfor %}

render_form(name, options)

Встраивает форму в любую страницу.

{{ render_form('contacts', {
    submit_text: 'Отправить',
    form_class: 'my-form'
}) }}

Подробнее: Встраивание формы

get_record(table, id)

Получает одну запись по ID.

{% set author = get_record('users', post.author_id) %}
<span>{{ author.name }}</span>

get_records(table, ids)

Получает несколько записей по списку ID.

{% set related = get_records('posts', [1, 3, 7]) %}
{% for p in related %}
  <a href="{{ url('blog/' ~ p.slug) }}">{{ p.title }}</a>
{% endfor %}

get_all(table, orderBy, orderDir)

Получает все активные записи из таблицы.

{% set reviews = get_all('reviews', 'created_at', 'DESC') %}

get_pivot(source_table, source_id, relation_name, target_table)

Получает связанные записи через many-to-many pivot-таблицу.

{% set cats = get_pivot('catalog', item.id, 'categories', 'categories') %}
{% for cat in cats %}
  <span class="tag">{{ cat.name }}</span>
{% endfor %}

Параметры:

• source_table — таблица сущности (например catalog)
• source_id — ID сущности
• relation_name — имя связи из page_config.relations (например categories)
• target_table — таблица-справочник (например categories)

Возвращает массив записей из целевой таблицы. Для одиночных связей (1:M) используйте get_record().

session_id()

Возвращает ID текущей сессии (для CSRF-токенов и т.д.).

<input type="hidden" name="token" value="{{ session_id() }}">

Фильтры

|markdown_to_html

Парсит Markdown в HTML.

<div class="content">
  {{ item.content|markdown_to_html|raw }}
</div>

Безопасный режим включён — сырой HTML из Markdown экранируется.

Стандартные фильтры Twig

Доступны все встроенные фильтры Twig: