Перейти к содержанию

Гаджеты и их создание

Гаджет – особый программный элемент, выполняющий функцию вывода определенных данных.

Об имеющихся гаджетах, их настройке и управлении ими, вы можете прочитать в курсах:

Для отображения гаджетов используется компонент Рабочий стол (Desktop). Этот одностраничный компонент позволяет создать настраиваемый рабочий стол с использованием этих программных элементов. В компоненте гаджеты инсталлируются вместе с главным модулем системы. Разработчики могут создавать собственные гаджеты. Компонент их увидит, если они будут размещаться в папке /bitrix/gadgets/. (Название папки обязательно должно быть в нижнем регистре.) Системные гаджеты располагаются во вложенной папке /bitrix/.

Внимание! Категорически не рекомендуется без крайней необходимости трогать структуру системных гаджетов.

Структура гаджета

  • .description.php - файл описания, содержащий массив параметров;
  • .parameters.php - файл с настройками. В данном файле формируется массив $arParameters. Особое внимание стоит обратить на ключи PARAMETERS (общие настройки) и USER_PARAMETERS (уникальные настройки конкретного пользователя);
  • файл index.php, который содержит исполняемый код, реализующий задачу гаджета;
  • языковые файлы в папке /lang/.
  • другие служебные файлы и папки.

Гаджеты и компоненты имеют похожую структуру и назначение, однако гаджеты:

  • Не используют шаблоны. HTML код зашит в файле index.php, в отличие от компонентов, где представление и логика разнесены.
  • Могут запоминать настройки для каждого пользователя, в отличие от компонентов, которые могут только выводить или не выводить информацию в зависимости от прав доступа.
  • Их настройки разделены на 2 группы: общие настройки, для гаджетов одного типа (например, для всех гаджетов Новости в рамках одного Рабочего стола), а также настройки каждого конкретного гаджета. Общие настройки задаются в компоненте Рабочий стол. Индивидуальные настройки задаются в контекстном меню каждого конкретного гаджета.

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

Служебные параметры

Служебные параметры недоступны настройке через интерфейс.
--- --- Параметр Описание NAME Название DESCRIPTION Описание ICON Иконка (указать путь) GROUP Группа, к которой относится гаджет. Указание группы определяет где в выпадающем списке гаджетов он будет показан

Список ссылок по теме: