Типы элементов форм: различия между версиями

Материал из CMS Sitebill Wiki
Перейти к навигации Перейти к поиску
 
Строка 109: Строка 109:
  
 
== parameter ==
 
== parameter ==
Коллекция данных-параметров.
+
Коллекция данных-параметров.<br>
 +
По-умолчанию данные хранятся в виде сериализованого массива. Для переключения способа хранения на json-строку используется параметр type
  
 
Параметры:
 
Параметры:

Текущая версия на 14:08, 12 января 2022

primary_key

safe_string

Текстовая строка произвольного содержания.

hidden

Тип скрытого поля. Данное поле следует использовать, если содержимое этого поля важно, но вы не хотите чтобы его видели пользователи. Например, с помощью данного поля можно делать метки для формы. Создадим поле utm_capmaing и будем туда передавать данные из переходов от поисковиков или различный рекламных компаний. В строке запроса это поле будет, значит оно автоматом появится в форме. Но при этом do параметр нужно поставить new_done, чтобы элементы инициализировались из запроса.

checkbox

Тип наличия выбора, чекбокс с двумя состояниями "выбрано" и "не выбрано"

select_box_structure

Структурный элемент, иерархический. Применим только к списку разделов\типов

select_by_query

Справочное значение. Поле хранит в себе ключ некоего значения из внешней таблицы.
Дополнительные параметры:
autocomplete = 1 // Включение ввода значений с помощью плагина поиска по первым буквам autocomplete
disable_autocomplete_on_search = 1 // Отключаем опцию autocomplete в поисковых формах

select_entity

select_box

Справочное значение. Хранит в себе ключ соответствующий одному из значений описанных как возможных вариантов этого поля
Набор опций выбора в формате пар {key~~value} - тут вам нужно вписать свои значения, которые будет видеть пользователь в форме. Key - будет храниться в базе.
Value - будет виден пользователям на сайте.
Например, {нет~~нет}{газ~~газ}{электро~~электро}

auto_add_value

Автодобавляемое значение

price

Поле цены.

textarea

Текстовый блок

uploadify_image

Коллекция медиаобъектов

uploadify_file

Коллекция медиаобъектов

mobilephone

Поле мобильного телефона

password

Поле пароля

photo

Поле хранения единичного изображения. Не используется и не поддерживается моделями, кроме модели user

geodata

Поле выбора географических координат

structure

textarea_editor

Текстовый блок с возможным html или иным форматированием

date

Поле хранения временных значений в виде TIMESTAMP

attachment

tlocation

captcha

dtdatetime

Поле хранения даты и времени в виде YYYY-MM-DD HH:II:SS

dtdate

Поле хранения даты в виде YYYY-MM-DD 00:00:00

dttime

Поле хранения времени в виде 0000-00-00 HH:II:SS

uploads

Коллекция медиаобъектов. Данный тип позволяет размещать на форме область для загрузки и прикрепления фотографий. Если вы назовете поле image, тогда в таблице данного объекта будет создано поле image с типом text. Картинки хранятся там в виде названий файлов в сериализованном массиве. Сами файлы картинок хранятся в каталоге /img/data/ Параметры:

Параметр Примечание
disableimagedesc отключение поля ввода описания фотографии
tagged подключение тега
max_img_count Максимальное число разрешенных к загрузке фото (указывается в виде целого числа)
max_img_count_ext Правила расширяющие параметр max_img_count. параметр расширяет действие max_img_count и не работает без него.


max_img_count_ext Указываются в виде строки N:rule1:rule2, где N - числовое значение max_img_count, rule1, rule2 - правила, при которых это значение вступает в действие. Правила указываются в виде field,operand,value, где field - системное имя поля, operand - условие сравнения (eq|neq|gt|lt), value - сравниваемое значение

gadres

client_id

Данный тип позволяет делать привязку к клиентам. Начальная функция CRM. Например, у вас некий клиент продает квартиру повторно или сдает несколько квартир. И чтобы не дублировать информацию об этом клиенте, мы создаем одну запись в таблице клиентов. И затем через поле client_id делаем привязку. Удобство реализуется через интерфейс поиска клиента по фамилии или по номеру телефона, прямо в форме ввода. Подробный видео-урок по использованию и настройки этой функции на странице форума

grade

docuploads

Коллекция медиаобъектов в виде присоединенных файлов

parameter

Коллекция данных-параметров.
По-умолчанию данные хранятся в виде сериализованого массива. Для переключения способа хранения на json-строку используется параметр type

Параметры:

Параметр Значения Примечание
type json Тип хранимых данных

compose

Это составной элемент. Используется только для отображения (нельзя редактировать напрямую значения, так как он состоит из значений других полей).
В parameters задается список колонок columns.
Пример, колонка address_composed содержит параметры:
columns = city_id,district_id,street_id,number
separator = / // не обязательный параметр
function = название функции обработчика из hooks // не обязательный параметр
При выводе этого поля будет составлен набор из значений колонок city_id,district_id,street_id,number
separator - будет служить для склейки значений. Например, через символ /. По-умолчанию ,

Дополнительные параметры элементов

У каждого поля можно создавать дополнительные параметры.

only_owner_access - если включить данную опцию для поля, тогда при генерации таблиц или выводе данных при просмотре объекта, данное поле будет иметь значение только, если его просматривает владелец данного объекта. Для всех остальных значение этого поля будет скрыто.