Просмотров: 50453
Дата последнего изменения: 22.02.2024
Сложность урока:
2 уровень - несложные понятия и действия, но не расслабляйтесь.
3
4
5
Недоступно в лицензиях:
Ограничений нет
Гаджет – особый программный элемент, выполняющий функцию вывода определенных данных.
Об имеющихся гаджетах, их настройке и управлении ими, вы можете прочитать в курсах:
Для отображения гаджетов используется компонент Рабочий стол (Desktop). Этот одностраничный компонент позволяет создать настраиваемый рабочий стол с использованием этих программных элементов. В компоненте гаджеты инсталлируются вместе с главным модулем системы. Разработчики могут создавать собственные гаджеты. Компонент их увидит, если они будут размещаться в папке /bitrix/gadgets/. (Название папки обязательно должно быть в нижнем регистре.) Системные гаджеты располагаются во вложенной папке /bitrix/.
Внимание! Категорически не рекомендуется без крайней необходимости трогать структуру системных гаджетов.
Структура гаджета
- .description.php - файл описания, содержащий массив параметров;
- .parameters.php - файл с настройками. В данном файле формируется массив
$arParameters. Особое внимание стоит обратить на ключи PARAMETERS (общие настройки) и USER_PARAMETERS (уникальные настройки конкретного пользователя);
- файл index.php, который содержит исполняемый код, реализующий задачу гаджета;
- языковые файлы в папке
/lang/.
- другие служебные файлы и папки.
Гаджеты и компоненты имеют похожую структуру и назначение, однако гаджеты:
- Не используют шаблоны. HTML код зашит в файле index.php, в отличие от компонентов, где представление и логика разнесены.
- Могут запоминать настройки для каждого пользователя, в отличие от компонентов, которые могут только выводить или не выводить информацию в зависимости от прав доступа.
- Их настройки разделены на 2 группы: общие настройки, для гаджетов одного типа (например, для всех гаджетов Новости в рамках одного Рабочего стола), а также настройки каждого конкретного гаджета. Общие настройки задаются в компоненте Рабочий стол. Индивидуальные настройки задаются в контекстном меню каждого конкретного гаджета.
Превосходя визуальные компоненты в мобильности, гаджеты являются очень интересным инструментом как для разработчиков, так и для пользователей сайтов.
Служебные параметры
Служебные параметры недоступны настройке через интерфейс.
| Параметр | Описание |
| NAME | Название |
| DESCRIPTION | Описание |
| ICON | Иконка (указать путь) |
| GROUP | Группа, к которой относится гаджет. Указание группы определяет где в выпадающем списке гаджетов он будет показан |
| SU_ONLY | Только для подключения у пользователя. |
| SG_ONLY | Только для подключения в группах. |
| BLOG_ONLY | Только для подключения в блогах. |
| AI_ONLY | Только для подключения в административном разделе. |
| NOPARAMS | Нет параметров |
|
Список ссылок по теме: