Разработка:storages/taglinks

Плагин
Название	taglinks
Тип	storages

Таблица в базе данных

taglinks - Ссылки(Линковки) тегов, связь объектов Деканата и тегов.

Подробный формат полей в таблице:

• id - ID линка.
• tagid - ID тега, к которому относится данная линковка
• plugintype - Тип плагина, которому принадлежит прилинкованный объект
• plugincode - Код плагина, которому принадлежит прилинкованный объект
• objectid - ID прилинкованного объекта
• sortname - ПОле для сортировки записей
• departmentid - ID подразделения, к которому принадлежит линковка
• infotext - Информация о линке
• infoserial - Сериализованный объект с опциями объекта линка
• date - Дата создания линковки
• updatemark - Метка актуальности линковки
• status - Статус линковки

API

link_tag($tagid, $plugintype, $plugincode, $objectid, $departmenid = 0, $manualoptions = null,$updatemark = null)

Метод для линковки объекта к тегу. Вызывает map функцию класса тега и в зависимости от результата работы этой функции производит действия над линком, удаляя, обновляя или создавая его.

Аргументы:

• $tagid(object) - ID тега
• $plugintype(string) - тип плагина, которому принадлежит объект
• $plugincode(string) - код плагина, которому принадлежит объект
• $objectid(int) - id объекта для линка
• $departmenid(int) - id подразделения
• $manualoptions(object) - опции для ручного линка
• $updatemark(int) - время начала процедуры линковки

Возвращаемые значения:

• string - сообщение о выполненных действиях

unlink_tag_manual($taglinkid)

Принудительная отлинковка объекта от тега.

Аргументы:

• $taglinkid(int) - ID линка

Возвращаемые значения:

• boolean - false в случае ошибки, true в случае успеха

rescan_taglinks($tagid, $depid = 0, $updatemark = null, $limit = 0, $continue = null)

Самостоятельное сканирование справочников для тега и обновление выборки

Аргументы:

• id $tagid - ID тега, для которого будет проведено обновление
• id $depid - ID подразделения
• int $updatemark - время начала обновления для отбора устаревших линков
• int $limit - лимит записей для сканирования
• object $continue - объект с данными для продолжения прерванного сканирования

Возвращаемые значения:

• @return bool - false в случае ошибки, true в случае успешного завершения

get_list_taglinks($filters, $order = 0, $limitfrom = 0, $limitnum = 0)

Получить отфильтрованный список линковок. Метод предназначен для получения массива линковок.Значения фильтров берутся из ключей массива

Аргументы:

• $filters(object) - объект с параметрами, по которым идет отбор линковок
• -> tagid(int|array) - маcсив ID тегов (или один ID), к которым принадлежат возвращаемые линковки
• -> departmentid(int|array) - маcсив подразделений(или одно подразделение), к которым принадлежат возвращаемые линковки
• -> status(str|array) - маcсив статусов(или один статус), которые могут иметь возвращаемые линковки
• $order(int) - сортировка, 0 - прямая, 1 - обратная
• $from(int) - смещение выборки
• $limit(int) - чосло строк (0 - все строки)

Возвращаемые значения:

• array - массив линковок, хранящихся в БД, отфильтрованный и отсортированный

События

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