Разработка:storages/cov — различия между версиями
Ibragim (обсуждение | вклад) м (→Таблица в базе данных) |
Konovalov (обсуждение | вклад) |
||
| (не показано 5 промежуточных версий 1 участника) | |||
| Строка 1: | Строка 1: | ||
| + | {{Infobox_Plugin | ||
| + | | name = cov | ||
| + | | type = storages | ||
| + | }} | ||
| + | |||
===Таблица в базе данных=== | ===Таблица в базе данных=== | ||
''cov'' - Custom Options Values - Значения Дополнительных Опций. В справочник сохраняются значения дополнительных полей для существующих плагинов. | ''cov'' - Custom Options Values - Значения Дополнительных Опций. В справочник сохраняются значения дополнительных полей для существующих плагинов. | ||
| Строка 4: | Строка 9: | ||
====Подробный формат полей в таблице:==== | ====Подробный формат полей в таблице:==== | ||
| − | * id | + | * id - уникальный идентификатор записи |
* plugintype - тип плагина, к объекту которого привязана дополнительная опция (почти всегда - storage) | * plugintype - тип плагина, к объекту которого привязана дополнительная опция (почти всегда - storage) | ||
* plugincode - код плагина, к объекту которого привязана дополнительная опция | * plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
| Строка 18: | Строка 23: | ||
Обновляет запись, если она есть с такими параметрами, и переданный $value !== NULL | Обновляет запись, если она есть с такими параметрами, и переданный $value !== NULL | ||
Если запись с переданными параметрами есть, а в качестве $value передали NULL, то запись будет удалена | Если запись с переданными параметрами есть, а в качестве $value передали NULL, то запись будет удалена | ||
| + | |||
''Аргументы:'' | ''Аргументы:'' | ||
| + | |||
* $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | * $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | ||
* $plugincode - код плагина, к объекту которого привязана дополнительная опция | * $plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
| Строка 28: | Строка 35: | ||
===='''get_option($plugintype, $plugincode, $objectid, $code, $substorage=null)'''==== | ===='''get_option($plugintype, $plugincode, $objectid, $code, $substorage=null)'''==== | ||
Метод возвращает одно значение из таблицы настроек по переданным параметрам. | Метод возвращает одно значение из таблицы настроек по переданным параметрам. | ||
| + | |||
''Аргументы:'' | ''Аргументы:'' | ||
| + | |||
* $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | * $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | ||
* $plugincode - код плагина, к объекту которого привязана дополнительная опция | * $plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
| Строка 39: | Строка 48: | ||
===='''add_options_to_custom_object($plugintype, $plugincode, $objectid, stdClass $customobj=null, $substorage=null)'''==== | ===='''add_options_to_custom_object($plugintype, $plugincode, $objectid, stdClass $customobj=null, $substorage=null)'''==== | ||
Метод получает из справочника опции по переданным параметрам и добавляет их в качестве свойств к переданному объекту $customobj. Если не передали объект $customobj, полученные значения будут присоединены к новому stdClass(). Метод возвращает получившийся $customobj. | Метод получает из справочника опции по переданным параметрам и добавляет их в качестве свойств к переданному объекту $customobj. Если не передали объект $customobj, полученные значения будут присоединены к новому stdClass(). Метод возвращает получившийся $customobj. | ||
| + | |||
''Аргументы:'' | ''Аргументы:'' | ||
| + | |||
* $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | * $plugintype - тип плагина, к объекту которого привязана дополнительная опция(почти всегда - storage) | ||
* $plugincode - код плагина, к объекту которого привязана дополнительная опция | * $plugincode - код плагина, к объекту которого привязана дополнительная опция | ||
| Строка 47: | Строка 58: | ||
''Возвращаемые значения:'' | ''Возвращаемые значения:'' | ||
* stdClass - переданные в метод объект, дополненный дополнительными опциями из справочника | * 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 - переданные в метод объект, дополненный дополнительными опциями из справочника
