INTERNAL
composer require proklung/twig-extensions-bundle
Файл local/configs/packages/twig_extension_pack.yaml
:
twig_extension_pack:
# Путь к dev сборке Webpack
webpack_build_dev_path: 'local/build/'
# Путь к production сборке Webpack
webpack_build_production_path: 'local/dist/'
# Сервис кэшера (реализующий Symfony\Contracts\Cache\CacheInterface) для реализации работы директивы cache
# (https://twig.symfony.com/doc/3.x/tags/cache.html)
# Если null (~) - фича отключена
cacher: 'cache.app'
# Экспорт runtimes наружу (в Битрикс)
runtimes_export: false
render
Доработанный вариант функции render из фреймворка.
Первый вариант - рендер по контроллеру.
{{ render(controller("Local\\ExampleSimpleController", { 'id': 3 })) }}
Второй вариант - рендер по роуту.
{{ render('/api/entrypoint/', {'headers' : { 'X-Requested-With': 'XMLHttpRequest'} }) }}
Нюанс: не будет работать без установленного кастомного бандла с Symfony роутером (https://github.com/ProklUng/wp.symfony.router.bundle или https://github.com/ProklUng/BitrixSymfonyRouterBundle).
render_service
Рендер из сервиса.
{{ render_service('app.controller.user', 'detail', {'user': user}, {'eventDispatcher': 'event_dispatcher'}) }}
renderController
Рендер контроллера.
{{ renderController('Local\Buffering\Buffer::showBuffered', 'additional-styles') }}
dump
Стандартный твиговский dump.
dump_custom
Красивый твиговский dump (на базе Symfony\Component\VarDumper
).
json_decode
json_decode как твиговская функция.
glob
glob как твиговский фильтр.
{% for size, icon in 'img/icons/favicon-*.png'|glob %}
<link rel="icon" type="image/png" sizes="{{ size }}" href="{{ asset(icon) }}">
{% endfor %}
{% for css in 'node_modules/@fortawesome/fontawesome-free-webfonts/css/*.css'|glob(false) %}
<link href="{{ asset(css) }}" rel="stylesheet">
{% endfor %}
youtube
{{ 'youtube_video_id'|youtube }} {# YouTube, размер по умолчанию (560x315) #}
{{ 'youtube_video_id'|youtube(640) }} {# YouTube, заданной ширины (640x315) #}
{{ 'youtube_video_id'|youtube(640, 480) }} {# YouTube с заданной шириной и высотой #}
{{ 'youtube_video_id'|youtube('100%') }} {# YouTube, fluid ширина (100% x 315px) #}
{% set content = '<div><p>Youtube video:</p>http://youtu.be/video_id</div>' %}
{{ content|youtubeBoxes|raw }} {# div с p и встроенное видео #}
encore_entry_link_tags
- путь к CSS entry Symfony Encoreencore_entry_script_tags
- путь к JS entry Symfony Encorequote
- строку в кавычкиsortbyfield
- сортировка массива по полюurl
- url по роуту и его параметрамabsolute_url
- абсолютный (со схемой и хостом) по urlpath
- путь по роуту и его параметрамnaturaljoin
csrf_token
- проверка csrf токена приложенияinclude(<путь к файлу>)
- включение php или html файлаtruncate
- обрезка строки с сохранением html тэгов
Wordpress:
apply_filter
- apply_filter.
Из пакета, оригинальная документация:
APPLICATION
- экземпляр класса \CMain, который хранится в глобальной переменной$APPLICATION
USER
- экземпляр класса \CUser, который хранится в глобальной переменной$USER
app
- экземпляр класса \Bitrix\Main\Application, если библиотека работает в битриксе с d7result
- массив $arResult, сформированный в компоненте. См. примечания по настройкеextract_result
params
- массив arParams, содержащий параметры компонентаtemplate
- экземпляр класса \CBitrixComponentTemplate для данного шаблонаcomponent
- экземпляр класса \CBitrixComponent для текущего компонента. Следует учитывать, что это не тот класс, который определен в компоненте, а именно \CBitrixComponenttemplateFolder
- путь до директории текущего шаблона относительно DOCUMENT_ROOTparentTemplateFolder
- путь до директории шаблона родительского компонента, если используется комплексный компонент. Эта переменная не учитывает родство шаблонов при использовании, например, функцииextends
в twiglang
- массив языкозависимых переменных текущего шаблона. Будет удалено в версии 1.1
showComponent()
- аналог\CMain::IncludeComponent()
. Данная функция только подключает компонент, но не возвращает результат работы компонента. Если вызывать подключение компонента с помощью объектаAPPLICATION
, то twig пытается вывести возвращаемое этим методом значение, что приводит часто к появлению артефактов в шаблонах.getMessage()
- синоним для функцииGetMessage()
или метода\Bitrix\Main\Loc::getMessage()
, если проект работает с d7bitrix_sessid_post()
иbitrix_sessid_get()
- переменные для генерации подписи с ID сессии в формах, синонимы одноименных функций в битриксеshowNote()
,showError()
иshowMessage()
- синонимы функцийShowNote()
,ShowError()
иShowMessage()
К сожалению, в Битрикс иногда сложно обойтись без использования суперглобальных переменных напрямую в шаблонах, поэтому все суперглобальные переменные из php пробрасываются в каждый шаблон и доступны по именам _SERVER, _GET, _POST, _REQUEST, _SESSION, _COOKIE, _FILES, _ENV и _GLOBALS
Если на проекте используется пакет с поддержкой твиговского движка
в компонентах, то в экземпляр того Твига автоматически перебрасываются все зарегистрированные в контейнере
extensions
(то, что отмечено в конфигах тэгом twig.extension
) и runtimes
(тэг twig.runtime
).
Также эта штука поддается использованию автономно, без контейнера.
Где-нибудь в init.php
(для extensions
; для runtimes
класс обработчик - Prokl\TwigExtensionsPackBundle\Services\Twig\TwigRuntimesBag
):
use Prokl\TwigExtensionsPackBundle\Services\Twig\TwigExtensionsBag;
use Bitrix\Main\EventManager;
$events = [new Local\TwigExtension, Local\FooExtension::class];
$handler = new TwigExtensionsBag($events);
$eventManager = EventManager::getInstance();
$eventManager->addEventHandler(
'',
'onAfterTwigTemplateEngineInited',
[$handler, 'handle']
);
Если пакет не установлен, то соответствующие сервисы удаляется на стадии компиляции контейнера.
Изначальная конфигурация пакета имеет приоритет над прокидываемым снаружи.