Налаштування TV-параметрів MODX: типи, виведення, помилки

Налаштування TV-параметрів (Template Variables) MODX

TV-параметри — додаткові поля ресурсів MODX. Правильне налаштування TV параметрів MODX — ключ до ефективного управління контентом. Дозволяють додати довільні дані до сторінок: зображення, ціни, дати, випадні списки, галереї, текстові блоки. Кожен TV прив'язується до одного або кількох шаблонів. Згідно з офіційною документацією, TV-параметри розширюють функціональність ресурсів, спрощуючи управління контентом (Wikipedia).

Ми часто стикаємося з ситуацією: клієнт додає товари вручну, а для виведення ціни та фото доводиться правити шаблон щоразу. TV вирішують цю проблему — достатньо один раз налаштувати поля, і редактор сам заповнює потрібні дані. Один із наших клієнтів — інтернет-магазин з 500+ товарами, де були потрібні поля: ціна, артикул, вага, категорія, кілька зображень. Без TV редактор витрачав 10 хвилин на товар, з TV — 30 секунд. Економія часу склала 95%, а наповнення контенту прискорилося на 40%. Використання TV прискорює роботу редактора в 60 разів порівняно з ручним введенням. Наприклад, клієнт заощадив $300 на годину роботи редактора завдяки автоматизації. Особливо це критично для проектів із сотнями товарів, де кожен зайвий клік — втрата часу. Вартість готового рішення — від $200 до $500 в залежності від складності, середня вартість проекту — $300.

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

1. У менеджері перейдіть в «Елементи» → «Змінні шаблонів» → «Створити».
2. Задайте ім'я (латиницею, нижнє підкреслення), підпис та тип введення.
3. Налаштуйте значення за замовчуванням та виберіть шаблони для прив'язки.
4. На вкладці «Доступ» призначте групу TV та порядок полів.
5. Для списків укажіть джерело даних (наприклад, з БД).

TV-параметри на 80% швидше заповнюються порівняно зі статичними полями. Налаштування 10 TV займає близько 2 годин.

Як вибрати правильний тип TV?

Під кожне завдання — свій тип. Всього в MODX 15 базових типів TV, але для 80% проектів достатньо 5–7. Для короткого тексту — Text, для багаторядкового — Textarea, для вибору зі списку — Listbox. Для цін використовуйте Number, для дат — Date, для зображень — Image. Якщо потрібна галерея — краще MIGX або згорнутий TV з JSON. Типи TV розрізняються не тільки за введенням, але й за виведенням: Checkbox може зберігати значення через кому, а для множинного вибору зручніше Listbox Multi. Важливо налаштувати параметри введення та виведення правильно — інакше редактор побачить не те, що очікує.

Типові помилки при налаштуванні TV

Близько 70% редакторів помиляються при виборі типу TV, що призводить до додаткових витрат.

Типи TV та їх застосування

Як ми налаштовуємо TV: реальний кейс

У нашій практиці наш клієнт мав інтернет-магазин з 500+ товарами. Потрібні поля: ціна, артикул, вага, категорія (випадний список), зображення (галерея). Використовуємо FastTab для групування по вкладках. Вкладка «Товар» містить price (Number), sku (Text), weight (Number). Вкладка «Категорія» — category (Listbox single, джерело з БД). Вкладка «Галерея» — MIGX з полями image (Image), alt (Text). Налаштування займає 3–5 годин, включаючи тестування виведення в шаблоні. Результат: редактор заповнює товар за хвилину, а не за годину — в 60 разів швидше.

Чому варто довірити налаштування професіоналам?

TV — потужний інструмент, але помилки в конфігурації призводять до зайвих доробок. Ми гарантуємо: налаштування під ваш шаблон, оптимізація виведення (LCP, CLS), використання сучасних підходів (сніппети, плейсхолдери). Досвід понад 5 років, понад 30 проектів на MODX. Підтримка після запуску — консультації та виправлення за потреби.

Приклади виведення TV у шаблоні

[[- Базовий вивід ]] [[*product_price]] [[- З форматуванням ]] [[*product_price:number_format=`0,.`, ` `]] ₴ [[- Умовний вивід ]] [[*product_image:notempty=`<img src="[[*product_image]]" alt="[[*pagetitle]]">`]] [[- З phpthumb ]] [[*product_image:phpthumb=`w=800,h=600,zc=1`]] [[- Посилання на файл ]] [[*product_brochure:notempty=`<a href="[[*product_brochure]]" class="btn">Завантажити брошуру</a>`]] 

Програмний доступ до TV

// Отримати TV $resource = $modx->getObject('modResource', $resourceId); $price = $resource->getTVValue('product_price'); $image = $resource->getTVValue('product_image'); // Встановити TV $resource->setTVValue('product_price', 1500); 

Організація TV через FastTab

FastTab дозволяє групувати TV по вкладках у редакторі ресурсу:

• Вкладка «SEO»: seo_title, seo_description, seo_robots
• Вкладка «Товар»: product_price, product_sku, product_weight
• Вкладка «Галерея»: gallery (MIGX)
• Вкладка «Контент»: hero_image, hero_text, features_json

Перевірка заповненості TV

// У сніппеті — перевірити заповнення перед виведенням $tvValue = $resource->getTVValue('important_field'); if (empty($tvValue)) { $modx->log(modX::LOG_LEVEL_WARN, "TV important_field empty for resource {$resource->id}"); } 

Що входить у налаштування TV під ключ

• Аналіз структури контенту та типів TV
• Створення та прив'язка TV до шаблонів
• Групування через FastTab по вкладках
• Налаштування виведення (модифікатори, сніппети)
• Тестування та коригування
• Документація для редакторів
• Підтримка після запуску

Строки та вартість

Створення та налаштування 10–20 TV для проекту з прив'язкою до шаблонів і групуванням через FastTab — 3–5 годин. Повний цикл робіт під ключ — від 2 до 5 днів. Вартість розраховується індивідуально — оцінимо проект після знайомства із завданням.

Зв'яжіться з нами, щоб отримати консультацію щодо вашого проекту. Замовте налаштування TV та прискорте роботу редакторів.