Создание виджета

Что такое виджет Desk.uz

Виджет Desk.uz представляет собой самостоятельное Web приложение, расположенное в окне IFRAME. Окно может изменять размеры по высоте и ширине, может перезагружаться и сворачиваться, его можно перемещать из одной колонки в другую, а также между вкладкаи с помощью настроек. Загрузка содержимого виджета проходит через проксирущий скрипт на Desk.uz.

Виджет может иметь настройки, как общие ("Заголовок окна", "Высота окна", "Вкладка", где он размещён), так и специфические, определяемые разработчиком (например, для RSS виджета: "URL ленты", "Количество элементов" и т.п.). Значения специфических настроек передаётся источнику виджета в строке запроса методом GET.

Виды виджетов Desk.uz

На Desk.uz на данный момент существует несколько видов виджетов:

Для табличных и сложных виджетов существуют определённые функциональные особенности, которые нужно учитывать при разработке. Для их работы требуется использование API Desk.uz.

Внимание!
Все виджеты отличпются по архитектуре и обрабатываются разными модулями Desk.uz, поэтому если создан, например, табличный виджет, и он добавлен в каталог, то нельзя изменять скрипт источника виджета в соответствии с архитектурой другого вида виджета (к примеру, сложного). Для этого требуется создать новый источник виджета и отправить новую заявку на добавление в каталог в соответствующем разделе.

На текущий момент существует реализация API Desk.uz на языке программирования PHP:

PHP API Desk.uz

ver. 1.1

Как добавить виджет в каталог Desk.uz

Чтобы добавить виджет в каталог Desk.uz необходимо авторизоваться, зайти на страницу "Предложить виджет", выбрать определённый вид виджета, заполнить форму и нажать на кнопку "Отправить".

Для Табличных и Сложных виджетов существует режим тестирования (кнопка "Протестировать"), чтобы проверить работоспособность виджета до отправки заявки на добавление в каталог. При использовании этого режима сгенерированные значения Desk API Key и Desk API Secret необходимо указать в файле конфигурации PHP API Desk.uz.

Для Сложных виджетов в режиме тестирования, если используется JavaScript API Desk.uz и Ajax запросы, необходимо установить параметр Deskuz.debug в true. Подробнее об этом можно узнать в разделе "Сложный виджет".