פיתוח תוספים מותאמים אישית ל-October CMS – הנדסה מומחית

פיתוח תוסף מותאם אישית ל-October CMS

תארו לעצמכם: תוסף מוכן מהמרקטפלייס לא מציע את הגמישות שאתם צריכים — הטופס לא אוסף שדות מותאמים אישית, הסינון לפי מודלים קשורים נכשל, או שהאינטגרציה עם ה-API נתקעת. הפתרון הוא לפתח תוסף המותאם לצרכים שלכם. במשך יותר מ-5 שנים, סיפקנו יותר מ-50 פתרונות מותאמים אישית ל-October CMS, והניסיון הזה מאפשר לנו לבנות אותם במהירות, ללא הפתעות.

כיצד תוסף מותאם אישית פותר משימות עסקיות?

תוסף ב-October CMS הוא חבילת Laravel מלאה הרושמת רכיבים, מודלים, נתיבים ובקרי backend. הוא יכול להחליף מיקרוסרוויס שלם: לנהל ביקורות, להתחבר ל-1C או ל-CRM, להציג פילטרים מותאמים אישית. בניגוד לשינויים באמצעות העתקה-הדבקה בתוך התמה, תוסף קל לעדכון, לא פוגע בליבה, וניתן לשימוש חוזר בין פרויקטים.

למה הרחבה מותאמת אישית עדיפה על שינוי תוסף קיים?

שינוי קוד של מישהו אחר פירושו סיכון ליציבות. בכל פעם שהתוסף מתעדכן, השינויים שלכם נמחקים. תוסף מותאם אישית נכתב מאפס עבור הארכיטקטורה שלכם: אנחנו שולטים בכל טבלה, בכל אירוע. הרחבה מותאמת אישית מהירה פי 3 לעדכון ואמינה פי 2 מאשר שינוי תוסף קיים. השוו: שינוי תוסף קיים לוקח 2–3 ימים, אבל אז צריך עוד שבוע כדי לתפוס באגים. תוסף חדש — 5 ימים וסיימנו, עם אחריות ותיעוד.

אילו בעיות אנחנו פותרים?

לרוב, לקוחות נתקלים בשדות חסרים בטפסים, שאילתות SQL לא אופטימליות (N+1), וחוסר יכולת להגדיר בצורה גמישה הרשאות גישה. אנחנו מטפלים בבעיות אלה בשלב התכנון: משתמשים ב-eager loading, קאשינג באמצעות Cache::remember, וולידטורים מותאמים אישית.

תהליך פיתוח התוסף

תהליך הפיתוח שלנו

1. אנליזה — אנחנו מקבלים את המפרטים שלכם או מגדירים דרישות יחד. אנחנו מגדירים מודלים, קשרים, רכיבים, הרשאות גישה.
2. עיצוב — אנחנו יוצרים דיאגרמת ER, סכמת רכיבים, ניווט backend.
3. יישום — אנחנו כותבים מיגרציות, מודלים, רכיבים, בקרים ואירועים. הקוד מכוסה בבדיקות (Pest/PHPUnit, כיסוי של 95%).
4. אינטגרציה — אנחנו מחברים את התוסף לאתר שלכם, מגדירים קאשינג, מייעלים שאילתות.
5. פריסה ותיעוד — אנחנו מספקים ארכיון עם composer.json, README, קונפיגורציות, plus הדרכה לצוות שלכם.

מה כלול בהרחבה

• קוד מקור תחת רישיון MIT (או שלכם)
• composer.json עם autoloading
• מיגרציות ונתוני seed
• בקרי backend ותפריט ניווט
• רכיבי frontend (Twig/Partial)
• אירועים ו-hooks להרחבה
• בדיקות (אם נדרש)
• README עם הוראות התקנה ושימוש
• 30 ימי תמיכה לאחר המסירה

טעויות נפוצות וכיצד למנוע אותן

טעויות נפוצות

• שאילתות N+1 ברכיבים — שוכחים את with() ו-load(). אנחנו משתמשים ב-eager loading וקאשינג באמצעות Cache::remember.
• מזהים קשיחים בניווט — נשבר במעבר לשרת אחר. אנחנו בונים ניווט אוטומטית באמצעות Backend::url().
• חוסר ולידציה — משתמשים מכניסים כל דבר. אנחנו משתמשים ב-trait של Validation עם חוקים.
• התעלמות מאירועים — לא נרשמים ל-cms.page.beforeDisplay, כך שהתאמות אישיות לא מופעלות. אנחנו תמיד משתמשים במודל האירועים.

דוגמה אמיתית: אינטגרציית CRM ביומיים. פרויקט אחד דרש סנכרון הזמנות עם AmoCRM. הבעיה הייתה שתוספים סטנדרטיים לא תמכו בשדות עסקה מותאמים אישית. פיתחנו תוסף עם רכיב ששלח נתונים דרך REST API בעת יצירת הזמנה. כל העבודה לקחה יומיים, בדיקות כיסו 95% מהקוד.

השוואה: תוסף מותאם אישית לעומת שינוי תוסף קיים

דוגמת קוד

להלן שלד תוסף מינימלי. קבוצה מלאה של קבצים מוצגת באמצעות מודל ביקורות כדוגמה.

Plugin.php — רישום רכיבים וניווט

// Plugin.php
namespace MyCompany\MySite;

use Backend;
use System\Classes\PluginBase;

class Plugin extends PluginBase
{
    public function pluginDetails(): array
    {
        return [
            'name' => 'My Site',
            'description' => 'Site-specific functionality',
            'author' => 'My Company',
            'icon' => 'icon-leaf',
        ];
    }

    public function registerComponents(): array
    {
        return [
            \MyCompany\MySite\Components\ReviewList::class => 'reviewList',
            \MyCompany\MySite\Components\ReviewForm::class => 'reviewForm',
        ];
    }

    public function registerNavigation(): array
    {
        return [
            'mysite' => [
                'label' => 'My Site',
                'url' => Backend::url('mycompany/mysite/reviews'),
                'icon' => 'icon-star',
                'permissions' => ['mycompany.mysite.*'],
                'order' => 500,
                'sideMenu' => [
                    'reviews' => [
                        'label' => 'Reviews',
                        'icon' => 'icon-comments',
                        'url' => Backend::url('mycompany/mysite/reviews'),
                        'permissions' => ['mycompany.mysite.reviews'],
                    ],
                ],
            ],
        ];
    }

    public function registerSettings(): array
    {
        return [
            'settings' => [
                'label' => 'My Site Settings',
                'description' => 'Configure My Site plugin',
                'icon' => 'icon-cog',
                'class' => \MyCompany\MySite\Models\Settings::class,
                'order' => 500,
            ],
        ];
    }

    public function boot(): void
    {
        \Event::listen('cms.page.beforeDisplay', function ($controller, $url, $page) {
            // Логика перед рендером страницы
        });
    }
}

מודל Eloquent

// models/Review.php
namespace MyCompany\MySite\Models;

use Model;

class Review extends Model
{
    use \October\Rain\Database\Traits\Validation;
    use \October\Rain\Database\Traits\SoftDelete;

    public $table = 'mycompany_mysite_reviews';

    public $rules = [
        'author_name' => 'required|string|max:255',
        'email' => 'required|email',
        'rating' => 'required|integer|between:1,5',
        'body' => 'required|string|min:10',
    ];

    protected $fillable = ['author_name', 'email', 'rating', 'body', 'is_approved'];

    protected $casts = [
        'is_approved' => 'boolean',
        'rating' => 'integer',
    ];

    public $attachOne = [
        'avatar' => \System\Models\File::class,
    ];

    public $belongsTo = [
        'product' => [\MyCompany\MySite\Models\Product::class],
    ];

    public function scopeApproved($query)
    {
        return $query->where('is_approved', true);
    }

    public function scopeByProduct($query, int $productId)
    {
        return $query->where('product_id', $productId);
    }
}

רכיב

// components/ReviewList.php
namespace MyCompany\MySite\Components;

use Cms\Classes\ComponentBase;
use MyCompany\MySite\Models\Review;

class ReviewList extends ComponentBase
{
    public function componentDetails(): array
    {
        return [
            'name' => 'Review List',
            'description' => 'Displays product reviews',
        ];
    }

    public function defineProperties(): array
    {
        return [
            'productId' => ['title' => 'Product ID', 'type' => 'string'],
            'limit' => ['title' => 'Limit', 'type' => 'string', 'default' => '10'],
        ];
    }

    public function onRun(): void
    {
        $this->page['reviews'] = Review::approved()
            ->byProduct((int) $this->property('productId'))
            ->with('avatar')
            ->orderBy('created_at', 'desc')
            ->limit((int) $this->property('limit'))
            ->get();

        $this->page['avgRating'] = Review::approved()
            ->byProduct((int) $this->property('productId'))
            ->avg('rating');
    }

    public function onSubmitReview(): array
    {
        $data = post();
        $review = new Review($data);
        $review->product_id = $this->property('productId');

        if (!$review->save()) {
            throw new \ValidationException($review);
        }

        return ['success' => true];
    }
}

מיגרציה

// updates/1_0_1_create_reviews_table.php
use October\Rain\Database\Schema\Blueprint;
use October\Rain\Database\Updates\Migration;

class CreateReviewsTable extends Migration
{
    public function up(): void
    {
        Schema::create('mycompany_mysite_reviews', function (Blueprint $table) {
            $table->increments('id');
            $table->integer('product_id')->unsigned()->index();
            $table->string('author_name');
            $table->string('email');
            $table->tinyInteger('rating');
            $table->text('body');
            $table->boolean('is_approved')->default(false);
            $table->timestamps();
            $table->softDeletes();
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('mycompany_mysite_reviews');
    }
}

ציר זמן ושלבים

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

• מסמך דרישות מפורט ודיאגרמת ER
• הרחבה פונקציונלית מלאה עם קוד מקור (רישיון MIT)
• composer.json והגדרת autoloading
• מיגרציות מסד נתונים ונתוני seed
• בקרי backend ותפריט ניווט
• רכיבי frontend (Twig/Partial)
• אירועים ו-hooks להרחבה
• בדיקות מקיפות (Pest/PHPUnit)
• README עם הוראות התקנה ושימוש
• 30 ימי תמיכה ותיקוני באגים לאחר המסירה
• אופציונלי: הדרכת צוות וחוזה תחזוקה

איך להזמין פיתוח?

תארו את המשימה שלכם — נכין הערכת עלות תוך יום אחד. צרו קשר, ונעזור לכם לקבוע איזו גישה מתאימה ביותר לפרויקט שלכם. המחירים מתחילים ב-$500 להרחבה פשוטה, ופרויקטים טיפוסיים נעים בין $500 ל-$2,000.

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

5+ שנות ניסיון ו-50+ תוספים שנמסרו הם לא רק מספרים. כל פרויקט מתחיל בסקירה ארכיטקטונית: אנחנו נמנעים מטעויות נפוצות (אינדקסים חסרים במסד נתונים, שאילתות לא מיועלות, כפילות קוד). כל התוספים עוברים סקירת קוד פנימית. אנחנו מספקים אחריות של 30 יום על הקוד — אם משהו משתבש, אנחנו מתקנים ללא עלות.