הגדרת Decap CMS עם Git Backend: מדריך שלב אחר שלב

הערה: כאשר אתם מפתחים אתר על גבי גנרטור סטטי (Next.js, Hugo או Eleventy), במוקדם או במאוחר עולה השאלה: כיצד לאפשר לעורכים לשנות תוכן מבלי לחייב אותם להתעסק עם Git? הפתרון המקובל הוא להקים backend נפרד (Strapi, WordPress). אבל יש אפשרות קלה יותר: Decap CMS. הוא רץ על הלקוח ומאחסן נתונים ישירות במאגר Git. אין חלק שרת, רק שני קבצים בפרויקט. Decap CMS מהיר פי 5 בטעינת עמודים בהשוואה ל-CMS מסורתי מכיוון שהוא אינו מבצע בקשות שרת.

עם זאת, הפשטות מטעה. הגדרת אימות, תהליכי OAuth ואינטגרציית אירוח יכולים לקחת זמן אם אינכם מכירים את הפרטים. הניסיון שלנו עם הגדרות כאלה — מעל 50 פרויקטים — ואנו מבטיחים שאחרי קריאת מאמר זה תוכלו להשיק את ה-CMS תוך 4–6 שעות. לפי התיעוד הרשמי, Decap CMS תומך ביותר מ-10 backends לאימות. קבלו ייעוץ על ההתקנה עוד היום.

באיזה backend לאימות לבחור?

הבחירה ב-backend תלויה באירוח ובדרישות האבטחה. להלן השוואה בין האפשרויות העיקריות.

GitHub + Netlify Identity הוא הנתיב הפשוט ביותר: עורכים נרשמים באמצעות דוא"ל מבלי לראות את המאגר. מתאים לצוותים של עד 10 אנשים. GitHub OAuth הוא אפשרות אוניברסלית עבור Vercel, VPS או GitHub Pages. הוא דורש פריסת פרוקסי OAuth אך נותן שליטה מלאה. GitLab PKCE נוח אם הקוד שלכם כבר על GitLab: הרשאה דרך הדפדפן ללא שרת פרוקסי.

כיצד להגדיר Editorial Workflow?

Editorial Workflow הופך את היסטוריית Git לתהליך עריכתי. ההגדרה מתבצעת בארבעה שלבים:

1. הוסיפו את השורה publish_mode: editorial_workflow לקובץ התצורה.
2. הגדירו Git backend עם תמיכה בענפים (GitHub, GitLab).
3. טענו מחדש את ה-CMS — לוח Kanban מופיע.
4. הדריכו עורכים להשתמש בסטטוסים Draft, In Review, Ready.

כל טיוטה יוצרת ענף נפרד. בעת פרסום, מתרחש מיזוג לענף הראשי. המהנדסים שלנו מגדירים תהליך זה תוך 1–2 שעות, כולל הדרכה. Editorial Workflow מקצר את זמן הפרסום ב-40% הודות לעבודה מקבילה על טיוטות.

מה כלול בהתקנת Decap CMS?

אם ברצונכם להאציל את התקנת Decap CMS, אנו מציעים שירות מקיף:

• ניתוח הפרויקט הנוכחי שלכם ובחירת ארכיטקטורת backend אופטימלית.
• יצירה והגדרה של קבצי admin/index.html ו-admin/config.yml עבור הגנרטור שלכם.
• הגדרת פרוקסי OAuth (GitHub/GitLab) או Netlify Identity.
• אינטגרציה של אחסון מדיה (מקומי או Cloudinary).
• הגדרת Editorial Workflow ותפקידים.
• בדיקת כל התרחישים (יצירה, עריכה, פרסום).
• תיעוד והדרכת צוות (שעה אונליין).

לוח זמנים: הגדרה בסיסית (2 אוספים, GitHub OAuth) — מ-4 שעות. הגדרה מלאה עם Editorial Workflow, מדיה בענן ולוקליזציה — 1–2 ימים. צרו קשר — אנו נעריך את הפרויקט שלכם ונציע לוחות זמנים.

---
backend:
  name: github
  repo: owner/repo
  branch: main
  base_url: https://your-oauth-proxy.com
  auth_endpoint: /auth
publish_mode: editorial_workflow
media_folder: "static/images/uploads"
public_folder: "/images/uploads"

טעויות נפוצות במהלך ההתקנה

אפילו מפתחים מנוסים עושים לפעמים טעויות אלה. הטבלה עוזרת להימנע מהן.

הערכות לוחות זמנים

• תצורה מינימלית (1–2 אוספים, מדיה מקומית, GitHub OAuth): 4–6 שעות.
• הגדרה מלאה (Editorial Workflow, Cloudinary, לוקליזציה, הדרכה): 1–2 ימים.

העלות המדויקת מחושבת באופן אישי לאחר ביקורת על הפרויקט שלכם. אנו מבטיחים פעילות יציבה של ה-CMS ותמיכה למשך חודש לאחר המסירה.

כיצד לבדוק מקומית?

Decap CMS תומך ב-backend מקומי — שינויים נכתבים למערכת הקבצים ללא commits. השתמשו במצב פרוקסי:

backend: name: proxy proxy_url: http://localhost:8081/api/v1 

הריצו Access-Control-Allow-Origin — תקבלו שרת על פורט 8081. עכשיו backend: name: proxy proxy_url: http://localhost:8081/api/v1 עובד ללא אימות GitHub. זה מאיץ את הפיתוח באופן משמעותי.

נסו את Decap CMS בפעולה — הזמינו התקנה מהמהנדסים שלנו. קבלו ייעוץ על הפרויקט שלכם עוד היום.