Кастомные поля

Общее описание кастомных полей

В версии 3.2.0 добавлена возможность создания собственных полей в профиле пользователя. 
Поля могут быть 2-ух типов числовые и строковые(максимальное ограничение строки 65535 символов). Количество полей в системе ограничено до 50 шт.

Для каких целей могут использоваться кастомные поля:

• внесение дополнительной информации пользователем

• внесение дополнительной информации админом, 2-варианта, когда пользователь видит это поле и не может его редактировать, а так-же пользователь может не видеть это поле, если там служебная информация.

• использовать в АПИ, можно применять для хранения различных ID-пользователя в других систем, где необходима синхронизация по этому ID.

• все значения кастомных полей доступны в CSV выгрузке

• так-же можно вывести значения кастомных полей в виджетах и некоторых письмах(уведомлениях).

Создание кастомных полей

В списке всех пользователей, в выпадающем списке по кнопке "Добавить пользователя", появилась ссылка на кастомные поля.

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

Далее для добавления первого поля нажмите "Добавить поле", откроется форма добавления кастомного поля.

Все поля максимально интуитивно названы, пройдемся по каждому полю отдельно.

Название поля - отображается в админке в профиля пользователя, а так-же в ЛК пользователя, если стоит функция "Пользователь видит поле в профиле"

Тип поля - Здесь имеется несколько вариантов, в зависимости от варианта, у поля могут быть предопределенные значения либо строковое. Первые четыре варианта(Чек боксы, Радио кнопки, Выпадающий список, Мультисписок - они предполагают список значений. Список этих значений задается в поле "Заголовки списка (через запятую)". Чуть ниже будет более подробно рассмотрены примеры как это работает.

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

Значение поля по умолчанию - здесь указывается значение которое будет выводится при условии, что нет в данном поле нет никакого значение введенного пользователем(в случае если разрешено) или админом. 

Статус - Отключённое поле не выводится и не используется в АПИ.

Пользователь видит поле в профиле - данное поле задает отображение поля в ЛК пользователя.

Пользователь может редактировать - дает возможность заполнения поля или выбора значения из списка. 

Разрешить парсинг поля в Api - включает возможность использовать это поле в нашем небольшом API(создание заказа по ссылке) или же использовать в POST форме как параметр запроса.

Заголовки списка (через запятую) - в этом поле перечисляются предустановленные значения для первых четырех полей(Чек боксы, Радио кнопки, выпадающий список, мультисписок). 

для примера

Вывод кастомных полей в профиле пользователя

Для вывода поля в профиле пользователя, необходимо включить параметр:

Пример как кастомные поля выглядят в профиле пользователя

В данном примере кастомное поле без возможности редактирования пользователем, а так-же имеет сортировку 9

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

И уже сам пользователь сможет записать туда любое значение. Имейте ввиду значение поля хранится одномоментно(статично) и никакой истории изменения значений нет. 

Вывод кастомных полей в HTML виджете

Значение любого кастомного поля можно выводить в HTML виджетах. В отличии от профиля пользователя в виджете у вас будет свобода кастомизации внешнего вида. 

Давайте создадим кастомное поле в котором будет ссылка на личную папку пользователя в облаке. То есть мы создадим для пользователя уникальную ссылку на его персональную папку и выведем этот линк в виде кнопки в виджете в ЛК.

Создаем новое кастомное поле 

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

Далее пропишем какому ни будь пользователю адрес на папку в облаке.

Сохраняем и далее создаем виджет HTML. В настройках виджета указываем, базовые настройки какие считаете нужными. Для того что бы он показывался в личном кабинете нужно указать показывать на страницах и там выбрать "Личный кабинет", так-же рекомендуем установить поставить параметр показывать только для зарегистрированных пользователей, так как кастомные поля будут заменятся только при авторизованном пользователе. 

Далее в содержимое виджета вставляете вот такой код(это пример) <a href="[CUSTOM_FIELD_1]" target="_blank">ссылка</a> Переменная берется из системного поля. Это имя присваевается каждому кастомному полю автоматически. Его можно увидеть в списке кастомных полей. 

Переменная прописывается обязательно большими буквами с нижними подчеркиваниями. 

Вот пример виджета где кастомное поле будет выглядеть ссылкой

После сохранения виджета, зайдя под пользователем. Увидим такой виджет 

Если хотите сделать ссылку в виде кнопки, тогда просто добавьте например такой класс этой ссылке.

После этого виджет будет выглядеть так 

Можете создать свои стили и прописать их. 

Что будет если у пользователя не будет прописан линк в кастомном поле ? Ну большой беды не произойдет. Виджет и кнопка у него естественно будет, но не будет ссылки внутри. По этому ничего особо не произойдет. Но для того что бы пользователь не писал Вам лишний раз, что у него не рабочая кнопка. Вы можете в кастомном поле прописать значение по умолчанию и сделать ссылку на какую-то информационную страницу и всё у кого пока нет персональной ссылки, будут попадать на неё. 

Вывод кастомных полей в письмах 

В письмах по аналогии с виджетами так-же можно использовать переменные кастомных полей. В настоящий момент реализован реплейсинг в письмах заказа и в рассылке.

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

Запись значение кастомных полей через API 

Кастомные поля можно использовать в нашем скромном АПИ, обновленная информация здесь.