Разработка:storages/cov — различия между версиями
Ibragim (обсуждение | вклад) м (Новая страница: «===Таблица в базе данных=== ''cov'' - Custom Options Values - Значения Дополнительных Опций. Описание настр...») |
Konovalov (обсуждение | вклад) |
||
(не показано 8 промежуточных версий 1 участника) | |||
Строка 1: | Строка 1: | ||
+ | {{Infobox_Plugin | ||
+ | | name = cov | ||
+ | | type = storages | ||
+ | }} | ||
+ | |||
===Таблица в базе данных=== | ===Таблица в базе данных=== | ||
− | ''cov'' - Custom Options Values - Значения Дополнительных Опций. | + | ''cov'' - Custom Options Values - Значения Дополнительных Опций. В справочник сохраняются значения дополнительных полей для существующих плагинов. |
− | |||
====Подробный формат полей в таблице:==== | ====Подробный формат полей в таблице:==== | ||
− | * id | + | * id - уникальный идентификатор записи |
* plugintype - тип плагина, к объекту которого привязана дополнительная опция (почти всегда - storage) | * plugintype - тип плагина, к объекту которого привязана дополнительная опция (почти всегда - storage) | ||
* plugincode - код плагина, к объекту которого привязана дополнительная опция | * plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
Строка 12: | Строка 16: | ||
* code - код дополнительной переменной (имя поля). Пока подчиняется такому же правилу, как и имена полей в БД. Потом с помощью слешей добавим возможность добавлять вложенные поля (пока не реализуем). | * code - код дополнительной переменной (имя поля). Пока подчиняется такому же правилу, как и имена полей в БД. Потом с помощью слешей добавим возможность добавлять вложенные поля (пока не реализуем). | ||
* value - значение дополнительной опции | * value - значение дополнительной опции | ||
+ | |||
+ | ===Дополнительные методы:=== | ||
+ | ===='''save_option($plugintype, $plugincode, $objectid, $code, $value=null, $substorage=null)'''==== | ||
+ | Метод сохраняет настройку в справочник. | ||
+ | Создает запись, если с такими параметрами записи еще нет. | ||
+ | Обновляет запись, если она есть с такими параметрами, и переданный $value !== NULL | ||
+ | Если запись с переданными параметрами есть, а в качестве $value передали NULL, то запись будет удалена | ||
+ | |||
+ | ''Аргументы:'' | ||
+ | |||
+ | * $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | ||
+ | * $plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
+ | * $objectid - id объекта, к которому привязывается дополнительная опция | ||
+ | * $code - код дополнительной переменной (имя поля) | ||
+ | * $value - значение дополнительной опции | ||
+ | * $substorage - код подхранилища: не актуально для storage, поэтому почти всегда пустая строка, но в перспективе, может понадобится (аналогично похожему полю в реестре синхронизаций) | ||
+ | |||
+ | ===='''get_option($plugintype, $plugincode, $objectid, $code, $substorage=null)'''==== | ||
+ | Метод возвращает одно значение из таблицы настроек по переданным параметрам. | ||
+ | |||
+ | ''Аргументы:'' | ||
+ | |||
+ | * $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | ||
+ | * $plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
+ | * $objectid - id объекта, к которому привязывается дополнительная опция | ||
+ | * $code - код дополнительной переменной (имя поля) | ||
+ | * $substorage - код подхранилища: не актуально для storage, поэтому почти всегда пустая строка, но в перспективе, может понадобится (аналогично похожему полю в реестре синхронизаций) | ||
+ | ''Возвращаемые значения:'' | ||
+ | * mixed: NULL - если значение не найдено|string значение - если найдено | ||
+ | |||
+ | ===='''add_options_to_custom_object($plugintype, $plugincode, $objectid, stdClass $customobj=null, $substorage=null)'''==== | ||
+ | Метод получает из справочника опции по переданным параметрам и добавляет их в качестве свойств к переданному объекту $customobj. Если не передали объект $customobj, полученные значения будут присоединены к новому stdClass(). Метод возвращает получившийся $customobj. | ||
+ | |||
+ | ''Аргументы:'' | ||
+ | |||
+ | * $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | ||
+ | * $plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
+ | * $objectid - id объекта, к которому привязывается дополнительная опция | ||
+ | * $customobj - объект, к которому будут присоединены полученные из справочника опции. | ||
+ | * $substorage - код подхранилища: не актуально для storage, поэтому почти всегда пустая строка, но в перспективе, может понадобится (аналогично похожему полю в реестре синхронизаций) | ||
+ | ''Возвращаемые значения:'' | ||
+ | * stdClass - переданные в метод объект, дополненный дополнительными опциями из справочника |
Текущая версия на 13:15, 30 июня 2014
Плагин | |
Название | cov |
Тип | storages |
Содержание
Таблица в базе данных
cov - Custom Options Values - Значения Дополнительных Опций. В справочник сохраняются значения дополнительных полей для существующих плагинов.
Подробный формат полей в таблице:
- id - уникальный идентификатор записи
- plugintype - тип плагина, к объекту которого привязана дополнительная опция (почти всегда - storage)
- plugincode - код плагина, к объекту которого привязана дополнительная опция
- substorage - код подхранилища: не актуально для storage, поэтому почти всегда пустая строка, но в перспективе, может понадобится (аналогично похожему полю в реестре синхронизаций)
- objectid - id объекта, к которому привязывается дополнительная опция
- code - код дополнительной переменной (имя поля). Пока подчиняется такому же правилу, как и имена полей в БД. Потом с помощью слешей добавим возможность добавлять вложенные поля (пока не реализуем).
- value - значение дополнительной опции
Дополнительные методы:
save_option($plugintype, $plugincode, $objectid, $code, $value=null, $substorage=null)
Метод сохраняет настройку в справочник. Создает запись, если с такими параметрами записи еще нет. Обновляет запись, если она есть с такими параметрами, и переданный $value !== NULL Если запись с переданными параметрами есть, а в качестве $value передали NULL, то запись будет удалена
Аргументы:
- $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage)
- $plugincode - код плагина, к объекту которого привязана дополнительная опция
- $objectid - id объекта, к которому привязывается дополнительная опция
- $code - код дополнительной переменной (имя поля)
- $value - значение дополнительной опции
- $substorage - код подхранилища: не актуально для storage, поэтому почти всегда пустая строка, но в перспективе, может понадобится (аналогично похожему полю в реестре синхронизаций)
get_option($plugintype, $plugincode, $objectid, $code, $substorage=null)
Метод возвращает одно значение из таблицы настроек по переданным параметрам.
Аргументы:
- $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage)
- $plugincode - код плагина, к объекту которого привязана дополнительная опция
- $objectid - id объекта, к которому привязывается дополнительная опция
- $code - код дополнительной переменной (имя поля)
- $substorage - код подхранилища: не актуально для storage, поэтому почти всегда пустая строка, но в перспективе, может понадобится (аналогично похожему полю в реестре синхронизаций)
Возвращаемые значения:
- mixed: NULL - если значение не найдено|string значение - если найдено
add_options_to_custom_object($plugintype, $plugincode, $objectid, stdClass $customobj=null, $substorage=null)
Метод получает из справочника опции по переданным параметрам и добавляет их в качестве свойств к переданному объекту $customobj. Если не передали объект $customobj, полученные значения будут присоединены к новому stdClass(). Метод возвращает получившийся $customobj.
Аргументы:
- $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage)
- $plugincode - код плагина, к объекту которого привязана дополнительная опция
- $objectid - id объекта, к которому привязывается дополнительная опция
- $customobj - объект, к которому будут присоединены полученные из справочника опции.
- $substorage - код подхранилища: не актуально для storage, поэтому почти всегда пустая строка, но в перспективе, может понадобится (аналогично похожему полю в реестре синхронизаций)
Возвращаемые значения:
- stdClass - переданные в метод объект, дополненный дополнительными опциями из справочника