Типы элементов форм: различия между версиями
Kondin (обсуждение | вклад) (описание hidden поля) |
Abushyk (обсуждение | вклад) |
||
(не показано 16 промежуточных версий 2 участников) | |||
Строка 14: | Строка 14: | ||
== select_by_query == | == select_by_query == | ||
− | Справочное значение. Поле хранит в себе ключ некоего значения из внешней таблицы. | + | Справочное значение. Поле хранит в себе ключ некоего значения из внешней таблицы.<br> |
+ | ''Дополнительные параметры:''<br> | ||
+ | '''autocomplete''' = 1 // Включение ввода значений с помощью плагина поиска по первым буквам autocomplete<br> | ||
+ | '''disable_autocomplete_on_search''' = 1 // Отключаем опцию autocomplete в поисковых формах<br> | ||
== select_entity == | == select_entity == | ||
== select_box == | == select_box == | ||
− | Справочное значение. Хранит в себе ключ соответствующий одному из значений описанных как возможных вариантов этого поля | + | Справочное значение. Хранит в себе ключ соответствующий одному из значений описанных как возможных вариантов этого поля<br> |
+ | Набор опций выбора в формате пар {key~~value} - тут вам нужно вписать свои значения, которые будет видеть пользователь в форме. | ||
+ | Key - будет храниться в базе.<br> | ||
+ | Value - будет виден пользователям на сайте.<br> | ||
+ | Например, '''{нет~~нет}{газ~~газ}{электро~~электро}''' | ||
== auto_add_value == | == auto_add_value == | ||
Строка 73: | Строка 80: | ||
== uploads == | == uploads == | ||
Коллекция медиаобъектов. Данный тип позволяет размещать на форме область для загрузки и прикрепления фотографий. Если вы назовете поле image, тогда в таблице данного объекта будет создано поле image с типом text. Картинки хранятся там в виде названий файлов в сериализованном массиве. Сами файлы картинок хранятся в каталоге /img/data/ | Коллекция медиаобъектов. Данный тип позволяет размещать на форме область для загрузки и прикрепления фотографий. Если вы назовете поле image, тогда в таблице данного объекта будет создано поле image с типом text. Картинки хранятся там в виде названий файлов в сериализованном массиве. Сами файлы картинок хранятся в каталоге /img/data/ | ||
+ | Параметры: | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Параметр !! Примечание | ||
+ | |- | ||
+ | | 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 == | == gadres == | ||
Строка 84: | Строка 107: | ||
== docuploads == | == docuploads == | ||
Коллекция медиаобъектов в виде присоединенных файлов | Коллекция медиаобъектов в виде присоединенных файлов | ||
+ | |||
+ | == parameter == | ||
+ | Коллекция данных-параметров.<br> | ||
+ | По-умолчанию данные хранятся в виде сериализованого массива. Для переключения способа хранения на json-строку используется параметр type | ||
+ | |||
+ | Параметры: | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Параметр !! Значения !! Примечание | ||
+ | |- | ||
+ | | type || json || Тип хранимых данных | ||
+ | |} | ||
+ | |||
+ | == compose == | ||
+ | Это составной элемент. Используется только для отображения (нельзя редактировать напрямую значения, так как он состоит из значений других полей). <br> | ||
+ | В parameters задается список колонок columns.<br> | ||
+ | Пример, колонка '''address_composed''' содержит параметры: <br> | ||
+ | '''columns''' = '''city_id,district_id,street_id,number'''<br> | ||
+ | '''separator''' = '''/''' // не обязательный параметр<br> | ||
+ | '''function''' = '''название функции обработчика''' [[Hooks#square_composed|из hooks]] // не обязательный параметр<br> | ||
+ | При выводе этого поля будет составлен набор из значений колонок city_id,district_id,street_id,number<br> | ||
+ | separator - будет служить для склейки значений. Например, через символ /. По-умолчанию , | ||
+ | |||
+ | == Дополнительные параметры элементов == | ||
+ | У каждого поля можно создавать дополнительные параметры.<br /> | ||
+ | <br /> | ||
+ | |||
+ | '''only_owner_access''' - если включить данную опцию для поля, тогда при генерации таблиц или выводе данных при просмотре объекта, данное поле будет иметь значение только, если его просматривает владелец данного объекта. Для всех остальных значение этого поля будет скрыто. |
Текущая версия на 14:08, 12 января 2022
primary_key
Содержание
- 1 safe_string
- 2 hidden
- 3 checkbox
- 4 select_box_structure
- 5 select_by_query
- 6 select_entity
- 7 select_box
- 8 auto_add_value
- 9 price
- 10 textarea
- 11 uploadify_image
- 12 uploadify_file
- 13 mobilephone
- 14 password
- 15 photo
- 16 geodata
- 17 structure
- 18 textarea_editor
- 19 date
- 20 attachment
- 21 tlocation
- 22 captcha
- 23 dtdatetime
- 24 dtdate
- 25 dttime
- 26 uploads
- 27 gadres
- 28 client_id
- 29 grade
- 30 docuploads
- 31 parameter
- 32 compose
- 33 Дополнительные параметры элементов
safe_string
Текстовая строка произвольного содержания.
Тип скрытого поля. Данное поле следует использовать, если содержимое этого поля важно, но вы не хотите чтобы его видели пользователи. Например, с помощью данного поля можно делать метки для формы. Создадим поле 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 - если включить данную опцию для поля, тогда при генерации таблиц или выводе данных при просмотре объекта, данное поле будет иметь значение только, если его просматривает владелец данного объекта. Для всех остальных значение этого поля будет скрыто.