Як розширити контакти таблиці Клієнтів через Custom Data?

Якщо потрібно додати до картки клієнта поля, яких немає в стандартній таблиці (дата народження, додатковий телефон, мітка VIP), можна використати Custom Data з опцією «Використовувати для розширення полів контактів». Дані з Custom Data з'являться в таблиці Клієнтів для відповідного клієнта.

Для нових проєктів: Краще використовувати Client Fields (Меню → Налаштування → Поля клієнта). Client Fields — стандартний спосіб додавання кастомних полів. Custom Data з розширенням контактів — варіант для існуючих проєктів, які вже його використовують.

Коли знадобиться

• Потрібно додати додаткові поля до таблиці Клієнтів (наприклад, дата народження, додаткові контакти, спеціальні мітки).
• Треба відображати кастомні дані безпосередньо в таблиці Клієнтів.
• Потрібно інтегрувати додаткову інформацію про клієнтів з Custom Data.

Що важливо знати

• Розширення контактів — опція в моделі Custom Data, яка дозволяє додати поля до таблиці Клієнтів.
• Потрібно додати поле reg_user_id типу INTEGER з параметром unique: true.
• ID користувача не відображається в інтерфейсі — його можна дізнатися через консоль браузера.
• Дані з таблиці Custom Data з'являться в таблиці Клієнтів для відповідного клієнта.

Перед початком

• Ви увійшли в систему з правами адміністратора.
• Ви перейшли в модуль Custom Data через Меню -> Custom Data.
• Ви знаєте, які додаткові поля потрібно додати до таблиці Клієнтів.

Покрокова інструкція

1. У модулі Custom Data перейдіть до вкладки "Створити/Оновити".
2. Створіть нову модель або відредагуйте існуючу.
3. Увімкніть опцію "Використовувати для розширення полів контактів".
4. Додайте обов'язкове поле:
   • Назва поля: reg_user_id
   • Тип поля: INTEGER
   • Унікальність: увімкніть опцію unique: true
5. Додайте інші поля, які потрібно відобразити в таблиці Клієнтів:
   • Назва поля (наприклад, "Дата народження", "Додатковий телефон")
   • Тип поля (TEXT, DATE, INTEGER тощо)
   • Налаштування відображення (назва, іконка, колір)
6. Збережіть модель.

Заповнення даних

Після збереження моделі:

1. Перейдіть у вкладку "Дані" в модулі Custom Data.
2. Створіть записи для клієнтів:
   • У полі reg_user_id вкажіть ID клієнта (його можна дізнатися через консоль браузера)
   • Заповніть інші додаткові поля
3. Збережіть записи.

💡 Підказка: ID користувача не відображається в інтерфейсі. Його можна дізнатися через консоль браузера (F12 → Console → знайти ID клієнта).

Що відбувається після

Після збереження моделі з увімкненою опцією "Використовувати для розширення полів контактів" додані поля відобразяться в меню "Клієнти". У записах Custom Data потрібно вказати ID клієнта в полі reg_user_id. Дані з таблиці Custom Data з'являться в таблиці Клієнтів для відповідного клієнта.

Як переконатися, що все вдалось

• Перевірте, що опція "Використовувати для розширення полів контактів" увімкнена.
• Переконайтеся, що поле reg_user_id додано з типом INTEGER та унікальністю.
• Перевірте, що додані поля відображаються в таблиці Клієнтів.
• Створіть тестовий запис з правильним reg_user_id та перевірте, що дані відображаються в таблиці Клієнтів.

Пов'язані матеріали

• Патерни та приклади Custom Data — коли використовувати Custom Data, а коли Client Fields
• Створити модель
• Додати поле до моделі
• Налаштувати тип поля