Композитный сайт: tips & tricks

Tue, 24 Jun 2014 13:48:23 +0400

1. Как сделать динамическую область вне контекста шаблона компонента?
====code====

\Bitrix\Main\Page\Frame::getInstance()->startDynamicWithID("area");
   //динамический контент вне компонента
\Bitrix\Main\Page\Frame::getInstance()->finishDynamicWithID("area", "Загрузка...");

============= Способ с буферизацией. Удобнее в использовании, но нельзя использовать отложенные функции внутри динамической области и в заглушке.
====code====

$frame = new \Bitrix\Main\Page\FrameHelper("my_dynamic_area");
$frame->begin();
   //динамический контент
$frame->beginStub();
  //заглушка
$frame->end();

============= В следующем обновлении композитного сайта: компонент, находящийся в динамической области, не участвует в голосовании.

2. Как отменить композитное кеширование в любом месте страницы (проголосовать "против") ?
====code====

\Bitrix\Main\Data\StaticHtmlCache::getInstance()->markNonCacheable();

=============

3. Страницы с расширением *.html не обрабатываются. Что делать?
На странице настроек в поле "Маска включения" добавляем "*.html".

4. Как учитывать композитные страницы в Google Analytics?
Google Analytics и Яндекс.Метрика собирают данные клиентской загрузки на основе Navigation Timing. Эта статистика показывает реальное время, с которым пользователи открывают страницы вашего сайта. Здесь важно понимать, что композит влияет только на время ожидания ответа от сервера (Server Response Time). Он не влияет на время: а) DNS lookup б) TCP-соединения в) загрузки JS, CSS и картинок.

По глобальной JS-переменной window.frameRequestStart можно определить, что страница отдалась пользователю из композитного кеша.
====code====

var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-18655900-1']);
_gaq.push(['_setCustomVar', 1, 'Cache', window.frameRequestStart ? 'Composite': 'NoComposite', 3]);

============= Код для Google Analytics нужно располагать ниже кода, выполняющего фоновый композитный запрос.

5. В чем разница между $this->createFrame()->begin(); и $this->createFrame()->begin(""); ?
Есть несколько способов выделить в шаблоне компонента динамическую область.
Самый популярный вариант выглядит так:
====code====

$frame = $this->createFrame()->begin();
   //динамический контент
$frame->beginStub();
   //заглушка
$frame->end();

============= Метод beginStub может отсутствовать, т.к. в метод begin можно сразу передать текст заглушки.
====code====

$frame = $this->createFrame()->begin("Загрузка...");
   //динамический контент
$frame->end();

============= Пустая строка будет означать пустую заглушку.
====code====

$frame = $this->createFrame()->begin("");
   //динамический контент
$frame->end();

============= А вот так можно записать контент динамической области в кеш, когда контент заглушки совпадает c контентом динамической части.
====code====

$frame = $this->createFrame()->begin();
   //динамический контент = заглушка
$frame->end();

=============
Этот способ позволяет избежать дублирования и повторного выполнения код.
С версии main 14.5.2 контент заглушки стал учитываться при подсчете хеш-суммы кеша.

6. Какие еще особенности у begin и beginStub?
Важно понимать, что код между вызовами begin-beginStub и beginStub-end выполняется всегда. И на первом хите к странице (на котором создается кеш) и на аякс-хите. Эти методы занимаются буферизацией контента и не являются аналогами конструкции if-else.

7. В теге есть блок php, который проверяет специальный Cookie, и если он установлен, добавляет блок

Битрикс. Поваренная книга

Композитный сайт: tips & tricks