Скачать 264.1 Kb.
|
![]() 1С-Битрикс: Управление сайтом Руководство по работе с партнерскими модулями и решениями Содержание Введение 3 Глава I. Подготовка архивов модуля и обновлений 4 Создание модуля 4 Структура полной сборки модуля 4 Задание демо-режима для модулей 7 Обновления модулей 7 Структура обновления модуля 7 Глава II. Размещение модуля в партнерской системе обновлений 9 Загрузка модуля 9 Загрузка обновлений 12 Расшифровка ошибок 13 Глава III. Работа с клиентами модуля 14 Скрипт для автоматической работы с клиентами модуля 14 Глава IV. Решения типовых сайтов 16 Примерный порядок создания мастера установки решения 16 Особенности, которые необходимо учитывать 16 Переустановка сайта 16 Инфоблоки, каталоги, блоги и прочее 17 Многосайтовость 17 Включаемые области 17 Другие моменты 18 Некоторые константы 18 Глава V. Установка модуля 20 Установка модуля 21 Установка обновлений 22 Глава VI. Частые ошибки 24 Ошибки при создании модулей 24 Не запускается мастер после установки продукта 24 В состав модуля не добавляется файл с указанием версии 24 Ошибки при создании решений 24 Не импортируется часть свойств инфоблоков 24 Приложение 25 Пример класса для модуля alexey.mycar 25 Заключение 28 ВведениеРасширить функционал проектов на основе "1С-Битрикс: Управление сайтом" позволяют сторонние модули и решения. Руководство предназначено для партнеров «1С-Битрикс», которые хотят распространять (например, продавать) свои модули. В документе рассматриваются вопросы, связанные с созданием и загрузкой модулей и решений в систему Marketplaсe. Если у вас возникнут вопросы по продуктам компании "1С-Битрикс", вы можете обратиться в службу Технической поддержки (http://dev.1c-bitrix.ru/support/). Глава I.Подготовка архивов модуля и обновленийСистема "1С-Битрикс: Управление сайтом" поставляется в различных редакциях. Каждая редакция представляет собой комбинацию стандартных модулей. При этом у партнеров есть возможность создавать свои собственные модули и распространять их через партнерскую систему обновлений. Количество модулей в системе не ограничено. Глава содержит информацию о предварительных операциях со структурой файлов и папок, необходимых для сборки архивов модуля и обновлений. Создание модуляПартнерские модули отличаются от стандартных модулей следующим:
У клиента эта информация будет доступна в списке модулей.
Структура полной сборки модуляПолная сборка модуля предназначена для первоначальной установки модуля (когда этого модуля ещё нет у клиента или партнера). Полная сборка должна содержать следующую структуру обязательных файлов модуля:
Все остальные файлы могут быть включены в модуль (могут отсутствовать), если это необходимо.
Перед загрузкой модуля на сайт необходимо запаковать полную сборку модуля в архив. Для этого выполните следующее:
![]() Рис. 1.1 Пример структуры модуля При обнаружении и исправлении грубых ошибок партнерам следует обновить полную сборку модуля в системе обновлений. Причем это следует сделать в любом случае, вне зависимости от автоматической или не автоматической загрузки обновлений. Нужно всегда учитывать, что при любом типе установки обновления могут быть и не установлены. Полная сборка не влияет на обновление модуля и вообще не используется для этого. Она нужна только для первичного скачивания и установки нового модуля. Если в силу каких-то причин необходимо запретить загрузку обновлений для каких-то пользователей (через год, например, или при новой версии), то достаточно отвязать клиента от модуля. Модуль у него останется, но обновляться он не сможет. Полезные методы
Если метод используется более чем в одном месте выносите его в класс WizardServices. Сторонние библиотекиИспользование сторонних библиотек возможно если соблюдаются все лицензионные ограничения разработчиков библиотек. Если используется сторонняя библиотека, то необходимо проверить чтобы имена объектов/классов/функций не совпадали с системными. Библиотеку не стоит размещать в папке /bitrix/modules/ (См. Структура полной сборки модуля). Необходимые для работы модуля файлы лучше положить в ваш модуль, для удобства последующего обновления. Пользовательские же файлы с подобными файлами обычно кладутся в /bitrix/php_interface/. Пункт в меню админкиЕсли необходимо добавить в меню админки пункты вашего модуля, то необходимо использовать событие OnBuildGlobalMenu (http://dev.1c-bitrix.ru/api_help/main/events/onbuildglobalmenu.php). Пример использования события для добавления собственного пункта в «Список пользователей»: AddEventHandler("main", "OnBuildGlobalMenu", "MyOnBuildGlobalMenu"); function MyOnBuildGlobalMenu(&$aGlobalMenu, &$aModuleMenu) { foreach($aModuleMenu as $k => $v) { if($v["parent_menu"] == "global_menu_settings" && $v["items_id"] == "menu_users") { $aModuleMenu[$k]["items"][] = Array( "text" => "Кастомный пункт пользователей", "url" => "user_custom.php?lang=".LANG, "title" => "Своя страница пользователей" ); } } } Задание демо-режима для модулейПлатный модуль может быть представлен в демо-режиме для изучения пользователем его возможностей перед приобретением. В модуле могут быть заданы следующие ограничения:
Кроме этого, для подключения модулей теперь можно использовать новую функцию CModule::IncludeModuleEx($module_name). Отличие ее от стандартной CModule::IncludeModule() в том, что она в качестве результата может возвращать: MODULE_NOT_FOUND (0) - модуль не найден (например скопировали ваши компоненты из модуля, а модуль удалили); MODULE_INSTALLED (1) - модуль установлен и подключен; MODULE_DEMO (2) - модуль работает в демо-режиме (например можно вывести сообщение, что вы можете купить версию без ограничений); MODULE_DEMO_EXPIRED (3) - срок работы демо-режима модуля истек. Если ваш модуль содержит только компоненты, то рекомендуется часть их функционала вынести в include.php, для того чтобы компоненты не работали без модуля. |
![]() | Руководство менеджера организации по работе с функциональными модулями Портала 12. 03. 2009 | ![]() | Руководство менеджера организации по работе с функциональными модулями Портала 12. 03. 2009 |
![]() | Руководство менеджера организации по работе с функциональными модулями Портала 12. 03. 2009 | ![]() | Лабораторная работа №7 Работа с внутренними и внешними модулями Цель: Овладеть навыками работы сервером сценариев Windows nt/2000, изучить возможности сервера сценариев для работы с внутренними... |
![]() | Руководство «Приступая к работе» Руководство «Приступая к работе» для программы Microsoft Office Communicator 2007 R2 | ![]() | Руководство ользователя содержание >>> содержание содержание |
![]() | Руководство по установке системы Версия 4 14 Документ предназначен для изучения на этапе установки и начальной настройки системы. Документ не содержит руководства по дальнейшей... | ![]() | Руководство по установке системы версия от 03. 09. 2010 Документ предназначен для изучения на этапе установки и начальной настройки системы. Документ не содержит руководства по дальнейшей... |
![]() | Руководство по работе с пакетом динамического моделирования VisSim 0 Руководство по работе с пакетом динамического моделиgрования VisSim 0 «Программы». Если на компьютере установлена, например, версия 0 (fap) пакета VisSim, то, как правило, чтобы запустить основную программу,... | ![]() | Тесты и обзоры Браузеры Когда схлынула первая вол- пользовательскими скриптами, но с дополнительными модулями, не |