הגדרת פרמטרי TV (משתני תבנית) ב-MODX
פרמטרי TV הם שדות נוספים למשאבי MODX. הם מאפשרים הוספת נתונים שרירותיים לדפים: תמונות, מחירים, תאריכים, תפריטים נפתחים, גלריות, בלוקי טקסט. כל TV מקושר לתבנית אחת או יותר. לפי התיעוד הרשמי, פרמטרי TV מרחיבים את פונקציונליות המשאב, ומפשטים את ניהול התוכן (ויקיפדיה).
לעתים קרובות אנו נתקלים בתרחיש הבא: הלקוח מוסיף מוצרים ידנית, וכדי להציג מחיר ותמונה הוא צריך לערוך את התבנית בכל פעם. TV פותר זאת — הגדר את השדות פעם אחת, והעורך ממלא את הנתונים הדרושים. אחד הלקוחות שלנו, חנות מקוונת עם 500+ מוצרים, דרש שדות: מחיר, מק"ט, משקל, קטגוריה, תמונות מרובות. ללא TV, העורך בילה 10 דקות על מוצר; עם TV, 30 שניות. חיסכון בזמן של 95%, ויצירת התוכן הואצה ב-40%. עם הגדרת TV נכונה, עורכים עובדים פי 3–10 מהר יותר מאשר בלעדיו. זה קריטי במיוחד לפרויקטים עם מאות מוצרים, שבהם כל לחיצה נוספת היא בזבוז זמן. הלקוחות שלנו חוסכים בממוצע 2,000 דולר בשנה בזמן עריכה. עלות הגדרה עבור 15 TV היא 750 דולר, ושירות הגדרת ה-TV המפתח שלנו מתחיל ב-500 דולר.
בחירת סוג ה-TV הנכון
לכל משימה יש סוג מתאים. ישנם 15 סוגי TV בסיסיים ב-MODX, אבל עבור 80% מהפרויקטים מספיקים 5–7. לטקסט קצר — Text, לטקסט רב-שורתי — Textarea, לבחירה מרשימה — Listbox. למחירים השתמש ב-Number, לתאריכים — Date, לתמונות — Image. אם אתה צריך גלריה — עדיף להשתמש ב-MIGX או ב-TV מבוסס JSON. סוגי TV נבדלים לא רק בקלט אלא גם בפלט: Checkbox יכול לאחסן ערכים מופרדים בפסיקים, בעוד שלבחירה מרובה Listbox Multi נוח יותר. חשוב להגדיר נכון את פרמטרי הקלט והפלט — אחרת העורך רואה משהו בלתי צפוי. נפרק זאת בפועל.
טעויות אופייניות בהגדרת TV
| טעות | תוצאה | פתרון |
|---|---|---|
| TV לא מקושר לתבנית | השדה לא מוצג במשאב | בדוק את הכרטיסייה 'גישה' |
| סוג קלט שגוי | נתונים שגויים (מחיר כטקסט) | השתמש ב-Number לערכים מספריים |
| פלט לא מוגדר | נתונים גולמיים ללא עיצוב | החל מפרטים (למשל, number_format) |
| שימוש ב-RichText ללא סינון | פגיעויות XSS | הפעל סינון תגים |
סוגי TV ומקרי השימוש שלהם
| סוג | מקרה שימוש |
|---|---|
| Text | שדה טקסט קצר |
| Textarea | טקסט רב-שורתי |
| RichText | עורך WYSIWYG |
| Number | שדה מספרי (מחיר, כמות) |
| Date | תאריך עם לוח שנה |
| Image | בחירת תמונה מדפדפן המדיה |
| File | העלאת קובץ או בחירה |
| URL | קישור |
| אימייל עם אימות | |
| Checkbox | תיבת סימון יחידה (כן/לא) |
| Listbox (יחיד) | רשימה נפתחת |
| Listbox (מרובה) | בחירה מרובה |
| Radio Options | לחצני רדיו |
| Tag | תגים מופרדים בפסיקים |
| autotag | השלמה אוטומטית של תגים מקיימים |
| migxdb | מבנה מורכב (MIGX) |
כיצד אנו מגדירים TV: מקרה אמיתי
שקול חנות מקוונת. שדות נדרשים: מחיר, מק"ט, משקל, קטגוריה (תפריט נפתח), תמונות (גלריה). אנו משתמשים ב-FastTab לקיבוץ לכרטיסיות. הכרטיסייה 'מוצר' מכילה מחיר (Number), מק"ט (Text), משקל (Number). הכרטיסייה 'קטגוריה' — קטגוריה (Listbox יחיד, מקור ממסד נתונים). הכרטיסייה 'גלריה' — MIGX עם שדות תמונה (Image), alt (Text). ההגדרה אורכת 3–5 שעות, כולל בדיקת פלט בתבנית. התהליך שלנו שלב אחר שלב:
- ניתוח מבנה התוכן וקביעת שדות ה-TV הנדרשים.
- בחירת סוגי קלט מתאימים לכל שדה.
- יצירת TV וקישורם לתבניות הנכונות.
- קיבוץ TV באמצעות FastTab לכרטיסיות לוגיות.
- הגדרת פלט בתבניות באמצעות מפרטים וסניפטים.
- בדיקת כל השדות ותיעוד לעורכים.
תוצאה: העורך ממלא מוצר בדקה אחת במקום שעה.
מדוע להפקיד את הגדרת ה-TV בידי מקצוענים?
TV הוא כלי עוצמתי, אבל טעויות בהגדרה מובילות לעבודה חוזרת מיותרת. אנו מבטיחים: הגדרה מותאמת לתבנית שלך, אופטימיזציית פלט (LCP, CLS), גישות מודרניות (סניפטים, placeholders). ניסיון של למעלה מ-5 שנים, 30+ פרויקטים על MODX. אחריות ל-3 חודשים על תיקונים.דוגמאות פלט 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, ניתן להשתמש ב-Chunks כ-tpl לעיצוב. לדוגמה, [[- Базовый вывод ]] [[*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>`]] עם placeholder לערך ה-TV. השתמש ב-tpl MODX TV chunk לעיצוב עקבי.
גישה תכנותית ל-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 לכרטיסיות
- הגדרת פלט (מפרטים, סניפטים)
- בדיקות והתאמות
- תיעוד לעורכים
- אחריות ל-3 חודשים על תיקונים
לוחות זמנים ומחירים
יצירה והגדרה של 10–20 TV לפרויקט, עם קישור לתבניות וקיבוץ FastTab — 3–5 שעות. מחזור מפתח מלא — בין 2 ל-5 ימים. התמחור אישי — נעריך את הפרויקט שלך לאחר היכרות עם המשימה. השקעה אופיינית לפרויקט עם 15 TV היא 750 דולר.
צור קשר לייעוץ על הפרויקט שלך. הזמן הגדרת TV והאץ את עבודת העורכים שלך.