Fork me on GitHub

Типы данных

Число

Числовой тип служащий для хранения целых чисел. Имеется дополнительное поле Диапазон в котором вы можете указать нужный вам диапазон значений. Вы можете указывать максимально возможные значения, но если у вас будет очень много записей, то лучше выбирать минимальный диапазон. Например, вы хотите добавить поле Год, в этом случае достаточно выбрать диапазон 0..65535 или -32768..32767. В этом случае, будет занято всего 2 байта на каждую запись, вместо четырех в максимальном варианте. При выборе варианта -128..127 или 0..255, число будет занимать всего 1 байт.

Строка

Строка является еще одним широко используемым типом. Он служит для хранения короткого текста, как правило до 255 символов. В параметре Длина укажите максимальное требуемое количество символов. Если вы попытаетесь сохранить строку длиннее этого значения, то она обрежется по указанной длине. Например, для названий городов или улиц вполне может хватить 48 символов. С другой стороны, вы всегда в дальнейшем можете изменить этот параметр.

Дата, время

Этот тип служит для хранения даты и времени и имеет два дополнительных параметра.

Конкретнее - уточните, что вы будете хранить.
Дата и время - дата и время
Дата - только дата
Timestamp - дата и время. Этот тип занимает меньше места чем первый вариант, но отчет можно вести только с 1970 года.
Календарь - только дата. В отличии от второго варианта имеет дополнительные возможности по установке циклических событий (напоминания, дни рождения).

Текущее время если пусто - если вы отметите эту опцию, то при сохранении записи, если значение не указано, будет автоматически ставится текущие дата и время.

Текст

Если вам нужно хранить текстовую информацию большого объема, то используйте тип данных Текст. Дополнительно вы можете указать следующие опции:

WYSIWYG редактор
---- - текст будет редактироваться и сохраняться как есть.
HTML редактор - текст можно будет редактировать с помощью HTML редактора. Он имеет дополнительное меню для указания основных HTML тегов.
Markdown - В этом случае, вы можете использовать Markdown разметку. Текст будет автоматически преобразовываться при просмотре в режиме карточки.

Большой текст (>65000) - Отметьте эту опцию, если вы планируйте размещать тексты больше 65000 символов. В случае использования HTML учитываются все символы (включая теги), а не только видимый текст.

Связь с таблицей

Это поле позволяет вам связать друг с другом две таблицы. Предположим у вас есть таблица с городами и хотите создать таблицу с улицами, но привязать каждую улицу к конкретному городу. В этом случае, вы сможете при добавлении или редактировании улицы выбрать соответствующий город из списка городов. И при просмотре улиц вы будете видеть город, которому принадлежит данная улица.

Таблица - Выберите таблицу, которую будете использовать. В нашем примере, это будет таблица городов.
Колонка - Укажите поле из прикрепленной таблицы, которое будет отображаться в качестве значение. Например, наименование города. Вы можете указать несколько полей, которые будут отображаться через разделитель.
Множественный выбор - по умолчанию, поле Связь с таблицей устанавливает отношение один-к-одному, то есть можно выбрать только одну запись из другой таблицы. Опция Множественный выбор позволяет устанавливать отношение один-ко-многим при котором вы можете выбирать нужное количество элементов из другой таблицы. Для использования данной возможности вам достаточно включить этот параметр.
Показывать как ссылку - Отметьте эту опцию, если вы хотите отображать значение в виде ссылки. При нажатии на эту ссылку вы будете переходить на карточку соответствующей записи. В нашем примере, это будет карточка города где находится данная улица.
Показывать идентификатор - Отметьте эту опцию, если вы хотите также видеть идентификатор записи. В нашем случае, будет показываться не только название города, но и его уникальный код из таблицы городов.
Фильтр - Разберем для чего нужна эта продвинутая опция. Предположим у вас уже есть таблицы городов и улиц, но вы хотите также добавить таблицу с домами. В таблице с домами мы добавим два поля - одно будет связывать дом с городом, а другое с улицей. Если мы сделаем связь с улицей без фильтра, то нам будут показываться улицы всех городов и непонятно какая улица какому городу принадлежит. Но если мы укажем в качестве фильтра таблицу города, то при выборе улицы для дома, система вначале посмотрит какой город вы выбрали для вашего дома и покажет только улицы данного города.

Да/Нет

Да/Нет - очень простой тип данных, который позволяет выбрать только один из двух вариантов - Да или Нет. При редактировании представляет собой переключатель, а при просмотре списка записи с вариантом Да отображаются с галочкой.

Десятичное число

Тип Десятичное число служит для хранения десятичных чисел.

Тип
C плавающей точкой - обычное десятичное число, которое подходит в большинстве случаев.
Двойной точности - выберите этот тип, если хотите использовать десятичные числа с двойной точностью.

Длина
Вам необходимо указать сколько разрядов вы отводите под число и сколько из них отводится под десятичную часть. Например, 6,2 означает что вы отводите под число шесть разрядов, из них два разряда отводится под десятичную часть. Если вы оставите это поле пустым, то, по умолчанию, будет использоваться представление 9,2.

Один из множества

Тип Один из множества позволяет выбирать и привязывать элемент множества к записям ваше таблицы. Множества не являются таблицами, это простые списки не более 32 элементов.

Множество - укажите множество, которое будет связано с данным полем вашей таблицы.

Множество

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

Множество - укажите множество, которое будет связано с данным полем вашей таблицы.

Файлы/Документы

Тип данных Файлы/Документы служит для хранения файлов (документов) любого формата. Причем данное поле не имеет ограничений на количество хранимых документов. То есть вы можете определить только одно поле данного типа, но каждая запись может хранить в этом поле много файлов разных форматов.

Хранить в базе данных - Файлы могут хранится как в виде отдельных файлов на диске, так и в базе данных. Вы можете выбрать любой вариант. Следует заметить, что если вы указали хранение файлов на диске, то вы должны дать права на запись для директории хранения, в противном случае, если система не сможет записать файл на диск, она сохранит его в базе данных.

Изображения

Тип данных Изображения подобен типу Файлы/Документы, но предназначен для хранения изображений и фотографий.

Хранить в базе данных - Как и файлы, изображения могут хранится или в базе данных или на диске в виде отдельных файлов.

Максимальный размер - Вы можете указать максимальный размер изображения в пикселях. Если основная сторона больше этого размера, то изображения автоматически будет уменьшено.

Минимальный размер - Вы также можете указать минимальный размер изображения в пикселях. Если основная сторона будет меньше этого размера, то изображения автоматически будет увеличено.

Отношение сторон - Вы можете указать отношение сторон. В этом случае изображение будет обрезано в указанной пропорции. Пропорция указывается по отношению к основной стороне. Например, 1 - это квадрат, 2 - основная сторона будет длиннее в два раза, 0.5 - основная сторона меньше в 2 раза.

Главная сторона - Определите основную сторону, по которой будут считаться все изменения фотографии.
Большая сторона - Большая сторона является основной стороной.
Ширина - Ширина всегда является основной стороной
Высота - Высота всегда является основной стороной

Размер превью - Если вы хотите автоматически создавать миниатюры к вашим фотографиям, то укажите здесь размер миниатюры в пикселях по основной стороне.

Превью - Отношение сторон - Укажите отношение сторон в миниатюре. Например, если вы укажите здесь 1, то у вас будут квадратные миниатюры. Если отношение не указано, то фотография просто пропорционально уменьшится.

Превью - Главная сторона - Определите основную сторону, по которой будет создаваться миниатюра.
Большая сторона - Большая сторона является основной стороной.
Ширина - Ширина всегда является основной стороной
Высота - Высота всегда является основной стороной

Дополнительные опции - Вы можете указать дополнительные настройки в виде параметр = значение.
watermark - наложение водяного знака или текстового изображения с прозрачным фоном на загружаемую картинку. Укажите в качестве значения путь к png файлу, который вы хотите накладывать. Путь должен быть указан относительно корневой папки домена. По умолчанию, водяной знак будет располагаться в центре изображения. Чтобы задать другое место определите параметры waterleft и watertop.
waterleft - вы можете указать смещение водяного знака в пикселах относительно левого или правого края загружаемого изображения. Если значение больше нуля, то смещение будет относительно левого края изображения, если меньше нуля, то данное смещение будет относительно правого края картинки. Если параметр равен нулю или не указан, то водяной знак будет посередине.
watertop - аналогично параметру waterleft, но смещение указывается относительно верхнего или нижнего края исходного изображения.

Например, данный водяной знак будет в правом нижнем углу с отступом в 5 пикселей.

watermark = /images/mywatermark.png
waterleft = -5
watertop = -5

Специальный

Тип данных Специальный включает в себя несколько специальных типов.

Конкретнее
Вебсайт - значения этого типа будут отображаться в виде ссылки на указанный адрес.
E-mail - служит для хранения email адресов. Также отображается в виде ссылки по которой открывается почтовый клиент.
Телефон - тип служит для хранения телефонных номеров. Отображается в виде специальной ссылки для звонка с мобильных телефонов.
Хэш-значение - данный тип служит для хранения хеш-значений с использованием алгоритма md5. Если вы при редактировании введете в поле какую-нибудь строку, то в таблицу запишется вычисленное хеш-значение. Может использоваться, к примеру, для хранения хеш-значений паролей.
IPv4 адрес - данный тип служит для хранения IP-адресов v4 и показывает их в привычном формате.
Ссылка на изображение - этот тип служит для хранения ссылок на изображения. Например, вы можете указать ссылку на изображение с другого сайта и будете видеть это изображение в таблице и карточке записи. Вы можете указать следующие дополнительные параметры (имя=значение) в поле Дополнительные опции:
url - если все картинки расположены в одном месте, то вы можете указать этот адрес здесь, а в записях указывать только имена файлов.
ext - если все картинки имеют одинаковое расширение, то вы можете указать его здесь, а в записях указывать имена файлов без расширений.
Например,

url = /images/flags/
ext = png

Вычисляемый

Тип Вычисляемый служит для создания вычисляемых полей. Например, вы хотите сразу видеть сумму или произведение каких-то числовых полей у каждой записи в таблице. В таблицах не отводится места под данный тип столбцов, все значения вычисляются в момент запроса данных.

Формула - Укажите формулу, по которой будет вычисляться данное поле. Смотрите документацию по вычисляемым полям.
Округление - При желании, вы можете применять округление получаемых значений. Для этого, укажите в этом поле количество цифр после запятой.

SQL поле

Описанные выше типы не охватывают всех возможных типов SQL. Продвинутые пользователи могут определить свой собственный тип данных, который поддерживается SQL.

SQL поле - укажите ваш тип в формате SQL запроса.
Например, float(6.2).