Документация для разработчиков

Введение по шаблонам

Партнерские шаблоны дают возможность добавить свой шаблон в мастер создания сайта или страницы. Для разработчика не составит труда создать свой сайт и распространять его среди клиентов. Вот как это можно сделать.

  1. В начале конечно же нужно создать сайт и страницы (или сайт из одной страницы), настроить ссылки как внутри страниц, так и между страницами. Вы можете создать с нуля или на основании одного из готовых шаблонов в штатной поставке продукта.

    Обратите внимание! Ряд шаблонов собран еще на старой версии API и их экспорт может сработать неадекватно. Мы уже работаем над исправлением ошибок, но потребуется время.

  2. У себя на портале вызвать метод landing.site.fullExport, результат работы которого сохранить в некоем хранилище. Например, json-файл.
  3. В своем приложении при его установке вызвать landing.demos.register, которому передать данный массив. Формат массива не описывается, его изменение остается на совести разработчика.
  4. Если вам не хватает блоков, вы можете заказать верстку у специалистов, или воспользоваться предложенными дополнительными блоками вендора.

Важные моменты:

  • Если сайт содержит одну страницу, то при установке (п.3) шаблон добавится как в мастер создания сайта, так и в мастер создания страницы. В ином случае будет добавлен только шаблон в мастер создания сайта.
  • Если вы экспортировали магазин, то и шаблон появится только в магазинах. Если сайт, то только в сайтах. Исключение составляют одностраничные сайты, которые также появляются среди шаблонов мастера создания страницы в рамках магазина.
  • Если на созданной вами странице размещен партнерский блок вы должны позаботиться заранее, что при вызове landing.demos.register необходимые партнерские блоки уже будут зарегистрированы в системе.
  • При удалении приложения, шаблоны и блоки приложения также удаляются, за исключением страниц, которые были созданы на основании шаблонов.

URL предварительного просмотра

Данная ссылка показывается в предварительном просмотре шаблона, когда пользователь его выбирает. Получить ссылку для регистрации шаблона можно следующим образом:

  1. Создать сайт/страницу в облачном Битрикс24 по данному шаблону. Страница может лишь минимально отличаться от регистрируемого вами шаблона, чтобы у пользователя, создающего сайты и страницы, не возникало вопросов.
  2. Если это сайт многостраничный, достаточно главной страницы.
  3. Опубликовать сайт и указать полученную ссылку в поле "URL предпросмотра".

Обратите внимание! Следите за активностью вашего портала, чтобы он не был автоматически удален, что повлечет за собой удаление и ссылок предпросмотра. А это в свою очередь деактивацию ваших решений.


Изображения

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


Цветовая палитра

Если сайт многостраничный, крайне рекомендуется создавать все страницы сайта в одной из тем.



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2020, «1С-Битрикс», 2020
Наверх