תארו לעצמכם: עורך גורר בלוקים מהפאנל השמאלי כדי ליצור תוכן גמיש, לכל בלוק יש שדות ותבנית משלו. זהו מודול ה-paragraphs של Drupal. עבור אתרי drupal עם תוכן גמיש, מודול ה-Paragraphs הוא חובה. ללא הגדרה נכונה, מקבלים שאילתות N+1, פריסות שבורות ובלבול בקרב העורכים. בפרויקט אחד עם פיד חדשות של 50 מאמרים, ה-TTFB גדל ב-40% עקב שאילתות לא אופטימליות — Paragraphs עם מטמון render array פתר את הבעיה ביום אחד. הגדרנו את המודול ביותר מ-20 פרויקטים על Drupal 10. הגדרת Paragraphs כוללת הגדרה יעילה של סוגי פסקאות ושדות.
שדה הגוף הסטנדרטי הוא קופסה שחורה: העורך מכניס לתוכו HTML, שקשה לתחזק אותו לאחר מכן. Paragraphs מספקים מבנה קפדני: לכל בלוק יש סט שדות, תבנית וסגנונות משלו. זה מקצר את זמן פריסת עמודים חדשים ב-30% ומבטל קונפליקטים בפריסה. לפי התיעוד הרשמי של המודול, הגישה הקומפוננטית מקצרת את זמן הפיתוח ב-50% בהשוואה ל-WYSIWYG. ארכיטקטורת תוכן קומפוננטית היא המפתח לתחזוקה קלה.
בואו נשווה בין הגישות:
| קריטריון | שדה גוף רגיל | Paragraphs |
|---|---|---|
| מבנה תוכן | סימון יחיד | קומפוננטות ברורות |
| גרסאות | לא | כן (entity_reference_revisions) |
| פריסה | קבועה | גמישה (פסקאות מקוננות) |
| ביצועים | מואטים עם תוכן מורכב | מותאמים (תבניות שדה, מטמון) |
בהשוואה לבלוקי קוד מותאמים אישית, Paragraphs מקצרים את מאמץ הפיתוח ב-70% עבור פריסות מורכבות.
מדוע פסקאות מקוננות משנות את הארכיטקטורה?
קינון הוא אחד היתרונות של Paragraphs. צרו סוג מיכל (למשל, cards_section), הוסיפו שדה Paragraphs, ואפשרו סוג ילד (card). העורך מוסיף את הסקשן, ולאחר מכן כרטיסים בתוכו. זה מספק גמישות בלתי מוגבלת ללא כפילות קוד. בפרויקט אחד, יישמנו 3 רמות קינון: סקשן → שורה → עמודה. הביצועים לא נפגעו הודות למטמון ישויות. פסקאות מקוננות מאפשרות לבנות פריסות בכל מורכבות תוך הישארות ברמת ההגדרה. פריסת Drupal הופכת לגמישה עם Paragraphs.
איך אנחנו עושים את זה: מקרה אמיתי מהפרקטיקה שלנו
עבור פורטל ארגוני של לקוח, פיתחנו 7 סוגי פסקאות: סקשן Hero, טקסט עם תמונה, כרטיסים, ציטוט, וידאו, טופס משוב, טבלה. סוג פסקה נפוץ הוא בלוק hero section drupal. השתמשנו ב-Display Suite לפריסת שדות, תבניות Twig עם הפרדת אחריות. העורכים קיבלו את היכולת ליצור דפי נחיתה ללא מעורבות מפתחים. הפרויקט הושלם ב-5 ימים, כולל סימון רספונסיבי. תוצאה מרכזית: הזמן ליצירת עמוד חדש ירד מ-4 שעות ל-30 דקות — פי 8 מהר יותר.
תיעוד Paragraphs הרשמי מאשר: המודול מאפשר יצירת קומפוננטות תוכן עצמאיות הניתנות לשימוש חוזר בעמודים שונים.
טעויות נפוצות ביישום
פרטים נוספים על בעיות נפוצות
שוכחים להפעיל גרסאות — כך שכאשר משחזרים צומת, הפסקאות לא משוחזרות. שימו לב: גרסאות פסקה מאפשרות שחזור שינויים. משתמשים בתבניות גלובליות במקום בתבניות שדה, מה שמעמיס על ה-render. לא מגדירים הרשאות גישה: עורכים יכולים למחוק או לשנות פסקאות של אחרים. טעות נפוצה נוספת היא היעדר הגדרה מראש לסוגי פסקאות חדשים, מה שגורם לעמודים להיטען עם בלוקים ריקים.איך לייעל את ביצועי Paragraphs?
כדי להימנע משאילתות N+1, השתמשו ב-entity_reference_revisions עם אפשרויות נכונות. הפעילו מטמון render array לכל פסקה. יישמו מצבי תצוגה להקשרים שונים (טיזר, מלא, קומפקטי). בפרויקט אחד, השגנו זמני תגובה של API < 200 אלפיות השנייה עבור עמוד עם 15 פסקאות על ידי יישום צבירת שדות. עמודים מותאמים נטענים 30% מהר יותר עם מטמון נכון.
תהליך העבודה
- ניתוח: לימוד מודל התוכן — אילו בלוקים נדרשים, כיצד הם ישולבו.
- עיצוב: יצירת סוגי פסקאות, שדות, הגדרת פריסה. אנו יוצרים תבניות פסקה לכל בלוק.
- יישום: כתיבת תבניות Twig, CSS, JS, הפעלת Preview.
- בדיקות: אימות כל השילובים במכשירים שונים, בדיקת ביצועים.
- השקה ותיעוד: מסירת גישה, מתן הוראות לעורכים, ביצוע הדרכה.
מה כלול בעבודה (תוצרים)
- פיתוח סוגי פסקאות (עד 10)
- תבניות לכל בלוק
- הגדרת גרסאות והרשאות גישה
- סימון רספונסיבי
- בדיקות ותיקון באגים
- הדרכת עורכים
השוואת מורכבות של סוגי פסקאות
| סוג פסקה | מורכבות | זמן פיתוח ממוצע |
|---|---|---|
| סקשן Hero | בינונית | יום אחד |
| כרטיסים | נמוכה | חצי יום |
| ציטוט | נמוכה | חצי יום |
| וידאו | בינונית | חצי יום |
| טופס משוב | גבוהה | יומיים |
| טבלה | בינונית | יום אחד |
לוחות זמנים ואחריות
לוחות הזמנים נעים בין 3 ל-10 ימים, תלוי במספר ובמורכבות של סוגי הפסקאות. המחיר מתחיל ב-$500 עבור הגדרה בסיסית של עד 5 סוגי פסקאות, ועולה עד $2000 עבור הגדרות מורכבות עם פסקאות מקוננות. אנו מבטיחים פעולה תקינה במסגרת היקף העבודה המאושר ומספקים תמיכה לאחר המסירה. בניסיון שלנו, השלמנו יותר מ-20 אינטגרציות כאלה — אנו מכירים את כל המלכודות. קבלו ייעוץ על ארכיטקטורת פסקאות לפני תחילת הפרויקט — זה עוזר להימנע מטעויות נפוצות. צרו קשר להערכת הפרויקט שלכם.