Интеграция с Tilda

Использовать модуль возможно только на тарифном плане Tilda Business - API доступно только на нём.

1. Скачайте и установите модуль.
   
2. Перейдите в настройки модуля: Настройки → Настройки продукта → Настройки модулей → Интеграция с Tilda.
   
3. Введите публичный (public) и секретный (secret) ключи, сгенерированные в Tilda.
   
4. Нажмите Сохранить.
   
5. Нажмите Проверить подключение - модуль обратится к Tilda и покажет число найденных проектов либо текст ошибки.
   

Дополнительные настройки:

• Настройки соединения с Tilda - базовый URL API, общий предел времени запроса, таймаут соединения и срок кэширования списков проектов и страниц (по умолчанию 10 минут; определяет, через сколько новая страница Tilda появится в редакторе).
  
• Поведение при сбоях Tilda - число попыток запроса, детектор зависшей передачи и опция «При сбое Tilda отдавать устаревшую копию страницы». Опция выключена по умолчанию; при включении на транспортном сбое отдаётся последняя успешно загруженная версия страницы (копия хранится 30 дней), сотрудники видят пометку об устаревшей версии, посетители - сохранённую страницу без служебной плашки. Содержательный ответ API (ошибка, страница не найдена или пуста) копией не подменяется, поэтому снятая с публикации страница на сайте не остаётся.
  
• На вкладке Логирование включается журнал работы модуля, выбирается минимальный уровень записи и каталог для лог-файлов. Удалить логи можно кнопкой «Очистить логи».
  

• PHP 7.4 и выше.
  
• 1С-Битрикс с ядром D7, модуль main версии 21.900.0 и выше.
  
• Расширение cURL либо включённая директива PHP allow_url_fopen. Модуль работает через cURL, а file_get_contents использует только как запасной вариант, если расширение cURL на сервере недоступно.
  
• Разрешённые исходящие HTTPS-соединения к api.tildacdn.info: модуль обращается к API только по HTTPS, обычный HTTP блокируется.
  

Перед установкой модуля создайте в Tilda как минимум один проект и одну страницу и опубликуйте её.

• API-ключи генерируются в настройках сайта: Экспорт → API Integration → Ключи.
  
• Если в аккаунте Tilda несколько проектов, включите опцию Мастер-ключ, чтобы модуль имел доступ ко всем проектам.
  
• В специальных настройках экспорта пути для ресурсов должны остаться пустыми.
  
• На сайт попадает только опубликованная в Tilda версия страницы. Неопубликованная страница видна в списке выбора, но контента с неё модуль не получит — на сайте она не отобразится.
  

Рекомендуется использовать шаблоны, в которых активная область контента занимает всю ширину экрана.

Если нужно скрывать часть элементов шаблона сайта или компонента при показе страницы из Tilda, оберните их следующей конструкцией:

<!--UTilda-->...Скрываемый контент...<!--EndUTilda-->

Чтобы на сайте отображался контент Tilda, на странице нужно разместить специальный тег вида

[UPLABTILDA PROJECT=12345 PAGE=12345678]

Сделать это можно тремя способами.

1. В визуальном редакторе нажмите значок Tilda.
   
2. В открывшемся окне выберите нужный проект, страницу и опции подключения.
   
3. Нажмите Сохранить.
   
4. Проверьте, что тег Tilda вставился.
   
5. Сохраните изменения.
   

1. В списке компонентов Битрикс раскройте раздел Uplab.
   
2. Выберите компонент Интеграция с Tilda (uplab:tilda).
   
3. В настройках компонента выберите нужный проект, страницу и опции подключения.
   
4. Нажмите Сохранить.
   

Впишите тег в контент текстом, указав идентификаторы проекта и страницы, например:

[UPLABTILDA PROJECT=12345 PAGE=12345678 HIDEPAGETEMPLATE=Y]

• Не выводить шаблон сайта - страница отобразится на сайте точно так же, как в Tilda, без «шапки» и «подвала» шаблона сайта.
  
• Перемещать стили и скрипты Tilda - не перемещать, в конец области head или в конец области body.
  

Модуль кэширует информацию, получаемую из Tilda, чтобы не запрашивать её на каждом хите. Контент страниц хранится в кэше неделю, списки проектов и страниц - 10 минут (срок настраивается).

Если страница в Tilda изменилась, опубликуйте её в Tilda, а затем сбросьте кэш этой страницы в административном интерфейсе Битрикс: Контент → Uplab → Интеграция Tilda → Страницы, в меню строки - Сбросить кэш. В списке для каждой страницы показано состояние кэша: актуален, истёк, есть ли сохранённая копия.

В том же разделе меню доступны действия Обновить список страниц (сбрасывает кэш списков проектов и страниц - нужно, если новая страница Tilda ещё не появилась в редакторе) и Полностью очистить кэш.

В некоторых случаях стили или скрипты Tilda конфликтуют с ресурсами шаблона сайта - тогда контент на сайте отображается и работает не так, как в Tilda.

ℹ️ Решение в каждом случае индивидуально; попробуйте разные варианты опции Перемещать стили и скрипты Tilda при подключении контента.

Если страница не загружается или загружается через раз, включите логирование на вкладке Логирование и посмотрите записи об обращениях к Tilda. Для проблем с ключами или доступом к API используйте кнопку Проверить подключение в настройках модуля.