Предварительные настройки

Чтобы выполнить установку модуля через партнерскую систему обновлений необходимо:

• в карточке партнера указать Код партнера, который будет использоваться как код для собственных модулей, и Лицензионный ключ, который будет использоваться для тестирования альфа-версий обновлений, доступных только автору модуля по этому ключу.



• собрать и загрузить на сервер компании "1С-Битрикс" дистрибутив модуля и обновления.
• установить модуль (либо его обновление).

  Загрузка модуля

Для загрузки модуля выполните следующее:

• Перейдите на страницу Ваши решения.
• На странице перейдите по ссылке Добавить решение, и в открывшейся форме

  

  заполните следующие поля:
  • Код - в поле обязательно указывается полный код партнерского модуля в формате код_партнера.код_модуля. Часть код_партнера постоянна для партнера (задается в карточке партнера). Часть код_модуля вводится партнером при добавлении нового модуля. Эти коды должны быть алфавитно-цифровыми с первым алфавитным символом, и код неким образом должен соответствовать сути модуля. Например, для модуля можно задать код mycar. Тогда полный код будет alexey.mycar. Пример класса модуля, в котором этот код модуля используется, содержится в приложении.
  • Активность - при отмеченной опции модуль будет отображаться в списке модулей.
  • Бесплатное решение - при отмеченной опции модуль будут бесплатным, то есть доступным всем. При снятом флажке появятся дополнительные поля, в которых надо отобразить:
    • Наличие триального периода;
    • Срок действия триального периода;
    • Цену модуля.
      Примечание: Если необходимо сменить текущую цену, то, поменяв значение цены, вы фактически отправляете уведомление в Партнерский отдел «1C-Битрикс», который активирует новую цену.

    • Разрешить партнерские скидки. При установленной опции другим партнерам будет разрешено покупать ваш модуль со скидками соответствующими статусу партнера.
  • Логотип – с помощью кнопки Выберите файл укажите путь к изображению, которое будет отображаться в списке модулей. (В разных браузерах выглядит по разному.)
  • Редакции, с которыми работает решение (обязательный) – в списке выберите редакции для которых предназначено решение.
  • Решение включает в себя – в списке обязательно указываются сущности, которые имеются в модуле: Компоненты, Мастер создания, Модуль, Переводы или Шаблоны сайта.
  • Адаптивность – указывается поддерживает ли решение возможность работать на разных типах устройств.
  • Поддержка композита – устанавливается флажок, если решение поддерживает технологию Композитный сайт.
  • Совместимо с Сайты24 – содержит блоки или шаблоны для Сайтов24.
  • Совместимо с PHP8 – решение работает на актуальной версии языка, поддерживаемой платформой.
  • Категория – указывается категория, к которой относится решение. Если вам не хватает категорий, то вы можете написать в техподдержку компании «1С-Битрикс» с просьбой добавить необходимую категорию.
  • Архив с полной сборкой решения – сюда вы загружаете архив со своим решением.
    Примечание: система обновлений автоматически переводит языковые файлы из Win-1251 в UTF-8, если у клиента выбрана кодировка сайта UTF-8. Если разница в версиях только в кодировке языковых файлов, то размещать надо только Win-1251 версию. Если разница в коде, то рекомендуется вынести эту разницу в языковые файлы.

  • CRM-виджет Битрикс24 – скопируйте и вставьте URL из кода CRM-виджета в вашем Битрикс24, чтобы клиент мог бы вам написать прямо с витрины.
  • Описание решения на Русском языке – в данной секции задаются значения следующих полей:
  • Юридическое название продукта – юридически значимая часть лицензионного договора и сопутствующих бухгалтерских документов. Изменение названия происходит только через процедуру модерации.
  • Опциональное название лицензии – конкретная версия решения.
  • Маркетинговое название – оно выводится на витрине. Если не заполнено, то на витрине будет выводиться юридическое название.
  • Описание решения – описание решения;
  • Описание установки решения – описание установки решения;
  • Описание техподдержки и контактных данных – индивидуальные контактные данные для техподдержки решения. Если поле не заполнено, то пользователям будут показаны реквизиты из карточки партнера.
  • Ссылка на демо-версию – ссылка на сайт с демо-версией;
  • Пользовательское соглашение от разработчика – укажите собственный текст соглашения для клиентов, с которым он соглашается при установке. При пустом поле будет выводиться стандартное соглашение.
  • Видео – указывается путь к видеоролику Ссылки в формате https://www.youtube.com/embed/NX6d6v3U6cA .
  • Вебинары – ссылки на ваши вебинары по загружаемому решению.
  • Скриншоты – можно загрузить скриншоты решения. (5 скриншотов)
  • Счётчик Google Analytics – подключение счетчика в карточку своего решения, будут фиксироваться просмотры карточки.
  • Подключить Я.Метрику – можно подключить Яндекс.Метрика (Необходимо указание идентификатора.)
• Сортировка среди своих модулей – значение, установленное в этом поле, определит порядок приложения в списке ваших приложений.
• Сохраните внесенные изменения.

В результате модуль будет добавлен в список ваших персональных модулей.

  Загрузка обновлений

Для загрузки обновлений выполните следующее:

• Перейдите на страницу Ваши решения.
• Перейдите по ссылке Обновления в колонке действий. Откроется страница Версии решения:



• Чтобы загрузить обновление воспользуйтесь ссылкой Загрузить новую версию. На странице Загрузка обновления для решения «название_решения» с помощью кнопки Выберите файл укажите путь к архиву с обновлением.
• Нажмите кнопку Загрузить.
• После загрузки архива на странице Обновления модуля «название_модуля» в поле Тип укажите тип обновления:
  • Альфа – альфа-версия обновления, доступная для загрузки только копии продукта с ключом, который указан в карточке партнера, предназначена для тестирования обновления;
  • Бета - бета-версия обновления, которая может быть установлена, если включена соответствующая опция в настройках Главного модуля;
  • Стабильное - окончательная стабильная версия обновления:
• Нажмите кнопку Сохранить.

  Расшифровка ошибок

При загрузке модуля (или обновления) в Marketplace выдается сообщение: Неверное содержимое архива с обновлением. Возможные причины:

• В файле /install/version.php не задана версия модуля;
• В файле /install/index.php не указан $MODULE_ID;
• В файле /install/index.php не указан PARTNER_NAME (Название партнера, разработчика модуля);
• В файле /install/index.php не указан PARTNER_URI (Адрес партнера, разработчика модуля);
• В файле /install/index.php не верно указано имя класса.