התקנה והגדרה של מודולים מ-1C-Bitrix Marketplace

רכשתם מודול מהמרקטפלייס של 1C-Bitrix, לחצתם על "התקנה", אבל במקום אינטגרציה עובדת, קיבלתם שגיאה 500 או מסך ריק. זהו תרחיש סטנדרטי שאנו נתקלים בו מדי יום. מודולים חינמיים מכילים לעתים קרובות תלויות מיושנות או באגים לא מתועדים. מודולים בתשלום דורשים הגדרה של מפתחות API, webhooks ומיפוי שדות לפי התיעוד של הספק. התקנת מודולי Bitrix מהמרקטפלייס ללא ניסיון בפיתוח מובילה לבזבוז של 2 עד 8 שעות רק כדי למצוא את הגורמים לתקלה. ואם המודול נוגע בליבה, ההשלכות של שגיאה עשויות לדרוש שחזור מגיבוי.

הגדרנו למעלה מ-50 מודולים מסחריים—מוידג'טים פשוטים של SEO ועד מחברי CRM מורכבים עם סנכרון דו-כיווני. הגדרה עצמית אורכת פי שניים זמן מהעבודה שלנו ומביאה ל-60% יותר שגיאות. במאמר זה, נפרק מלכודות טיפוסיות ונראה כיצד אנו מגדירים מודולים מאפס ועד לסביבת production.

מדוע מודולים נכשלים לאחר ההתקנה?

לפי הנתונים שלנו, 60% מהבעיות לאחר ההתקנה קשורות לחוסר תאימות של גרסת PHP. המודול נכתב עבור PHP 8.1, אבל האחסון שלכם משתמש ב-7.4—זה נותן שגיאת תחביר. בדקו דרך phpinfo() או /bitrix/admin/sysinfo.php. סיבה נפוצה נוספת היא התנגשויות של מטפלי אירועים. שני מודולים נרשמים על אותו אירוע בטבלת b_module_to_module, והמטפל הלא נכון נקרא. או שהמודול לא יכול ליצור את הטבלאות שלו בגלל חוסר בהרשאות MySQL עבור CREATE ו-ALTER. לפעמים המודול נכשל בגלל composer.json שגוי—תלויות לא מותקנות, מחלקות לא נטענות אוטומטית. פתרון: הרצת composer install בתיקיית המודול. יכולה להיות גם בעיה עם מטמון מתויג: המודול לא מבטל את המטמון, כך שמשתמשים רואים נתונים ישנים. הגדרת API של Bitrix דורשת כתובות webhook נכונות, אחרת המודול לא יכול להחליף נתונים עם שירותים חיצוניים.

כיצד להגדיר מודול תשלום: דוגמה עם YooKassa

נבחן הגדרה של מודול תשלום דרך YooKassa. לאחר ההתקנה דרך לוח הניהול (Marketplace → פתרונות מותקנים), אנו:

1. רושמים webhook בחשבון YooKassa לכתובת ה-URL של המודול (בדרך כלל /bitrix/tools/sale_ps_result.php).
2. מזינים shopId ו-secretKey בהגדרות המודול: COption::SetOptionString('yukassa', 'shop_id', ...).
3. עוברים למצב בדיקה כדי לאמת עסקאות בסביבת sandbox.
4. יוצרים הזמנת בדיקה, מבצעים תשלום, בודקים את סטטוס ה-callback success/fail/cancel.
5. במצב production, משנים את המפתח הסודי ומשביתים את דגל הבדיקה.

מודולי שילוח מורכבים (CDEK, דואר רוסי) דורשים הגדרה נוספת: טבלאות מיפוי נקודות איסוף, תעריפים, הגדרות מידות. אנו תמיד בודקים את חישוב העלות עבור ערים ומשקלים שונים. הגדרת מודול דרך תמיכת הספק אורכת בממוצע פי שניים מהעבודה שלנו—בגלל תורים וחוסר הבנה של הארכיטקטורה של האתר שלכם. אנו מבצעים עד 80% מהעבודה מרחוק, ללא השבתה של האתר שלכם.

// Пример регистрации обработчика события
RegisterModuleDependences(
    "sale",
    "OnSalePayOrder",
    "vendor.module",
    "\Vendor\Module\Event",
    "onPayOrder"
);

מדוע להפקיד את ההגדרה בידי אנשי מקצוע?

לצוות שלנו יש ניסיון רב עם Bitrix ו-Bitrix24. התקנו והגדרנו למעלה מ-50 מודולים עם אינטגרציות חיצוניות. אנו עובדים עם CommerceML ו-REST API. אנו מבטיחים שלאחר ההגדרה, המודול לא ישבור פונקציונליות קיימת—אנו משתמשים במטמון מתויג וכותבים בדיקות יחידה. חיסכון בזמן על דיבוג—עד 8 שעות למודול. לפי תיעוד Bitrix, המודול חייב להיות רשום בטבלת b_module. אנו עוקבים אחר כך ובודקים את תקינות הרשומות.

מה כלול בעבודה

• בדיקת תאימות לגרסאות Bitrix ו-PHP שלכם.
• התקנה דרך לוח הניהול או ידנית (אם אין גישה).
• הגדרת כל הפרמטרים: מפתחות API, webhooks, מיפוי.
• בדיקת כל התרחישים (הצלחה/שגיאה/ביטול) בסביבת sandbox.
• פתרון התנגשויות פוטנציאליות עם מודולים אחרים.
• תיעוד קצר על ההגדרות עבור הצוות שלכם.
• תמיכה לאחר ההשקה—אחריות של שבועיים לפעולה תקינה של האינטגרציה.

כיצד להימנע מטעויות אינטגרציה טיפוסיות?

הכינו מראש את פרטי הגישה לשירותים חיצוניים (מפתחות API, אסימוני OAuth). ודאו גישה ללוח הניהול של Bitrix עם הרשאות מנהל. בדקו את גרסאות ה-PHP וה-Bitrix הנוכחיות דרך // Пример регистрации обработчика события RegisterModuleDependences("sale", "OnSalePayOrder", "vendor.module", "\Vendor\Module\Event", "onPayOrder"); . אם המודול משתמש באירועים או ב-agents, ודאו שהם לא מתנגשים עם פתרונות שכבר מותקנים. הבדיקות שלנו כוללות בדיקה של כל הסטטוסים האפשריים ובקשות callback כדי למנוע כשלים ב-production.

השוואה בין הגדרה עצמית להגדרה מקצועית

השוואת מורכבות מודולים

צרו קשר לייעוץ לגבי המודול שלכם. הזמינו הגדרה—ונשיק ביום הפנייה. נגיב תוך שעה ונציע פתרון.