מדריך מלא להגדרת Blueprints ו-Fieldsets ב-Statamic

ארגון שדות תוכן עם Blueprints ו-Fieldsets

דמיינו שאתם מעבירים פרויקט מ-WordPress ל-Statamic ומתמודדים עם כאוס של שדות ACF. אתם צריכים להגדיר 50+ שדות עבור סוגי פוסטים שונים, שרבים מהם חוזרים על עצמם—כותרות SEO, תמונות OG, בלוקים מותאמים אישית. ב-Statamic, זה מטופל דרך Blueprints ו-Fieldsets. ללא סכמה ברורה, תבזבזו ימים בהעתקה ידנית, ושינוי של כלל אחד דורש עריכות בעשרות מקומות. נראה לכם כיצד להקים סכמת blueprint ללא כאב, עם שימוש חוזר ואימות מובנה.

בעיות שאנחנו פותרים

שכפול שדות ידני

ללא Fieldsets, כל שדה חייב להיכתב בכל Blueprint מחדש. זה מוביל לשגיאות: במקום אחד שוכחים את required, ובמקום אחר יש character_limit שגוי. Fieldset מרכז את הלוגיקה: שנה כלל והוא חל בכל מקום. בפרויקט עם 6 אוספים, זה מקצר את זמן עריכת התוכן ב-40%.

בלוקי תוכן מורכבים

עורך הטקסט הסטנדרטי לא עובד עבור דפי נחיתה עם מודולים: hero, יתרונות, תמחור. Bard עם סטים מותאמים אישית מאפשר מבנה גמיש מבלי לפנות לפתרונות דמויי ACF. אנו מגדירים סטים אופייניים: סליידר, רשת יתרונות, טבלת תמחור—כל אחד עם סכמת שדות משלו.

אימות שגוי ו-SEO

ללא סכמה ברורה, קל לפספס תמונה חובה או כתובת Canonical. אנו מטמיעים אימות (required, image, character_limit) בשלב ה-Fieldset—שגיאות נמנעות מראש. זה מפחית באגים בפרסום תוכן ב-60%.

איך לייבא Fieldset ללא התנגשויות?

קחו מקרה אמיתי: אתר מסחר אלקטרוני על Statamic. נדרשו אוספים: מוצרים, קטגוריות, ביקורות, דפים. כולם חולקים סט SEO משותף. צרו Fieldset בשם seo:

---
# resources/fieldsets/seo.yaml
title: SEO
fields:
  - handle: title
    field:
      type: text
      display: SEO Title
      instructions: Если пусто — используется основной заголовок
      character_limit: 70
  - handle: description
    field:
      type: textarea
      display: Meta Description
      character_limit: 160
  - handle: og_image
    field:
      type: assets
      container: assets
      max_files: 1
      display: OG Image
      instructions: 1200×630px
      validate: [image]
  - handle: canonical_url
    field:
      type: text
      display: Canonical URL
  - handle: noindex
    field:
      type: toggle
      display: Скрыть от поисковиков
      default: false
---

ייבאו אותו לתוך Blueprint המוצר עם הקידומת # resources/fieldsets/seo.yaml title: SEO fields: - handle: title field: type: text display: SEO Title instructions: Если пусто — используется основной заголовок character_limit: 70 - handle: description field: type: textarea display: Meta Description character_limit: 160 - handle: og_image field: type: assets container: assets max_files: 1 display: OG Image instructions: 1200×630px validate: [image] - handle: canonical_url field: type: text display: Canonical URL - handle: noindex field: type: toggle display: Скрыть от поисковиков default: false כדי למנוע התנגשויות עם seo_ ו-title של המוצר:

---
# resources/blueprints/collections/products/product.yaml sections:
main:
  fields:
    - handle: title
      field:
        type: text
        required: true
    - handle: price
      field:
        type: text
        validate: numeric
sidebar:
  fields:
    - import: seo
      prefix: seo_
---

עבור ביקורות, אותו סט SEO אך ללא קידומת כי יש רק שני שדות: description ו-# resources/blueprints/collections/products/product.yaml sections: main: fields: - handle: title field: type: text required: true - handle: price field: type: text validate: numeric sidebar: fields: - import: seo prefix: seo_ . ייבאו ללא קידומת:

- import: seo 

שינוי של Fieldset אחד מעדכן אוטומטית את כל ה-Blueprints שמייבאים אותו. הוסיפו שדה title והוא יופיע גם במוצרים וגם בביקורות. ב-WordPress, הייתם צריכים לערוך 5 תבניות ACF. Statamic עושה זאת בשניות.

למה להשתמש ב-Fieldsets מותאמים אישית במקום בהעתקה?

מלבד חיסכון בזמן, Fieldsets מספקים נקודת שליטה אחת. אפשר להרחיב סט, לשנות סוג שדה, או להוסיף אימות וזה משתקף מיד בכל הערכים. בפרויקטים עם 20+ סוגי תוכן, זו הדרך היחידה לשמור על סדר.

התהליך שלנו להקמת Blueprints

1. ניתוח תוכן—איסוף כל סוגי הערכים, השדות שלהם, בלוקים מקוננים, מאפיינים נדרשים.
2. עיצוב Fieldset—זיהוי קבוצות חוזרות (SEO, מטא-דאטה, אנשי קשר, סליידרים).
3. יישום—יצירת סכמות YAML, הגדרת סטים של Bard, אימות, ייבוא.
4. בדיקות—אימות התנהגות CP, שמירה נכונה, אימות.
5. פריסה ותיעוד—מסירת גישה והוראות להוספת שדות.

ציר זמן ומה כלול

הקמת 5–8 אוספים עם Fieldsets לשימוש חוזר אורכת 1 עד 2 ימים. כולל:

• יצירת Blueprint לכל סוג תוכן.
• פיתוח Fieldsets עבור SEO, בלוקים נפוצים (גלריה, קבצים, טאבים).
• הגדרת סטים מותאמים אישית של Bard (סליידר, יתרונות, תמחור).
• אימות שדות: חובה, פורמט, מגבלות.
• בדיקות ב-CP ובחזית.
• תיעוד לעריכת שדות.

השוואה: Statamic Fieldsets לעומת WordPress ACF

טעויות נפוצות והשלכותיהן

הניסיון שלנו: מעל 20 פרויקטים על Statamic, כולל אתרי מסחר אלקטרוני, פורטלי חדשות ואתרים תאגידיים. אנו מבטיחים שסכמת ה-blueprint תהיה גמישה וניתנת להרחבה.

---
sets:
  pricing:
    display: Тарифы
    fields:
      - handle: title
        field:
          type: text
        display: Название тарифа
      - handle: price
        field:
          type: text
        display: Цена
      - handle: features
        field:
          type: list
        display: Особенности
      - handle: highlighted
        field:
          type: toggle
        display: Выделить