מודולי Magento 2 מותאמים אישית: תוספים, אירועים, אינטגרציית ERP

פיתוח מודול Magento 2 מותאם אישית

עריכה ישירה של קוד הליבה של Magento 2 במהלך התאמה אישית היא דרך מובטחת לשגיאות עדכון. תרחיש טיפוסי: החנות שלך מריצה Magento 2.4.5, אתה עורך את app/code/Magento/Sales/Model/Order.php, שישה חודשים לאחר מכן משתחרר תיקון אבטחה 2.4.6, והשינויים שלך שוברים את העדכון. מודול מותאם אישית מבודד את הלוגיקה העסקית ומתקשר עם הפלטפורמה דרך נקודות הרחבה רשמיות: Events, Observers, Plugins (Interceptors), DI ו-preferences. זה מאפשר עדכוני Magento חלקים ללא אובדן פונקציונליות. רוצה להימנע מבעיות אלה? צור איתנו קשר לייעוץ — נעזור לך לתכנן את הארכיטקטורה הנכונה.

אנחנו מפתחים מודולי Magento 2 מותאמים אישית כבר למעלה מ-5 שנים. במהלך תקופה זו, נתקלנו בבעיות נפוצות רבות — משאילתות N+1 ב-Observers ועד רצף מודולים שגוי — ופיתחנו פתרונות ארכיטקטוניים אופטימליים. להלן, באמצעות הדוגמה של יצירת מודול שמתעד נתונים מותאמים אישית במהלך ביצוע הזמנה ומסנכרן אותם עם מערכת חיצונית, נפרק שיטות עבודה מומלצות.

איך יוצרים מודול Magento 2 מאפס?

בואו נפרק את המבנה של מודול טיפוסי צעד אחר צעד. שלב 1: יצירת שלד

השתמש ב-bin/magento generate:module או צור ידנית את התיקייה app/code/Vendor/Module. קבצים נדרשים:

• registration.php
• etc/module.xml
• composer.json

דוגמה ל-module.xml:

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
  <module name="Vendor_Module" setup_version="1.0.0">
    <sequence>
      <module name="Magento_Sales"/>
      <module name="Magento_Catalog"/>
    </sequence>
  </module>
</config>

שלב 2: Schema Patches — יצירת טבלאות

במקום סקריפטים מיושנים של Install/Upgrade, Magento ממליץ על Schema Patches. אלה שינויים אטומיים שמוחלים פעם אחת. דוגמה ליצירת טבלה עם מפתח זר ל-<?xml version="1.0"?> <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd"> <module name="Vendor_Module" setup_version="1.0.0"> <sequence> <module name="Magento_Sales"/> <module name="Magento_Catalog"/> </sequence> </module> </config> :

<?php
// Setup/Patch/Schema/CreateCustomEntityTable.php
namespace Vendor\Module\Setup\Patch\Schema;

use Magento\Framework\DB\Ddl\Table;
use Magento\Framework\Setup\Patch\SchemaPatchInterface;
use Magento\Framework\Setup\SchemaSetupInterface;

class CreateCustomEntityTable implements SchemaPatchInterface
{
    public function __construct(
        private readonly SchemaSetupInterface $schemaSetup
    ) {}

    public function apply(): void
    {
        $setup = $this->schemaSetup;
        $setup->startSetup();

        $connection = $setup->getConnection();
        $tableName = $setup->getTable('vendor_custom_entity');

        if (!$connection->isTableExists($tableName)) {
            $table = $connection->newTable($tableName)
                ->addColumn('entity_id', Table::TYPE_INTEGER, null, [
                    'identity' => true,
                    'nullable' => false,
                    'primary' => true,
                    'unsigned' => true,
                ], 'Entity ID')
                ->addColumn('product_id', Table::TYPE_INTEGER, null, [
                    'unsigned' => true,
                    'nullable' => false,
                ], 'Product ID')
                ->addColumn('custom_value', Table::TYPE_DECIMAL, '12,4', [
                    'nullable' => false,
                    'default' => '0.0000',
                ], 'Custom Value')
                ->addColumn('status', Table::TYPE_SMALLINT, null, [
                    'nullable' => false,
                    'default' => 1,
                ], 'Status')
                ->addColumn('created_at', Table::TYPE_TIMESTAMP, null, [
                    'nullable' => false,
                    'default' => Table::TIMESTAMP_INIT,
                ], 'Created At')
                ->addColumn('updated_at', Table::TYPE_TIMESTAMP, null, [
                    'nullable' => false,
                    'default' => Table::TIMESTAMP_INIT_UPDATE,
                ], 'Updated At')
                ->addForeignKey(
                    $setup->getFkName($tableName, 'product_id', 'catalog_product_entity', 'entity_id'),
                    'product_id',
                    $setup->getTable('catalog_product_entity'),
                    'entity_id',
                    Table::ACTION_CASCADE
                )
                ->addIndex($setup->getIdxName($tableName, ['status']), ['status'])
                ->setComment('Vendor Custom Entity Table');

            $connection->createTable($table);
        }

        $setup->endSetup();
    }

    public static function getDependencies(): array
    {
        return [];
    }

    public function getAliases(): array
    {
        return [];
    }
}

שלב 3: Observer ו-Plugin — תגובות לאירועים

משימה טיפוסית היא לתעד מידע נוסף לתוך טבלה מותאמת אישית כאשר נוצרת הזמנה. השתמש ב-Observer על אירוע catalog_product_entity:

<?php
// Observer/OrderPlaceAfter.php

namespace Vendor\Module\Observer;

use Magento\Framework\Event\Observer;
use Magento\Framework\Event\ObserverInterface;
use Psr\Log\LoggerInterface;

class OrderPlaceAfter implements ObserverInterface
{
    public function __construct(
        private readonly LoggerInterface $logger,
        private readonly \Vendor\Module\Model\CustomEntityFactory $entityFactory,
        private readonly \Vendor\Module\Model\ResourceModel\CustomEntity $entityResource,
    ) {}

    public function execute(Observer $observer): void
    {
        /** @var \Magento\Sales\Model\Order $order */
        $order = $observer->getEvent()->getOrder();

        try {
            foreach ($order->getAllVisibleItems() as $item) {
                $entity = $this->entityFactory->create();
                $entity->setData([
                    'product_id' => (int)$item->getProductId(),
                    'custom_value' => $item->getQtyOrdered(),
                    'status' => 1,
                ]);
                $this->entityResource->save($entity);
            }
        } catch (\Exception $e) {
            $this->logger->error('OrderPlaceAfter observer error: ' . $e->getMessage(), [
                'order_id' => $order->getId(),
            ]);
        }
    }
}

כדי לשנות את ההתנהגות של מחלקות קיימות, השתמש ב-Plugin (Interceptor). לדוגמה, הגדר ערך ברירת מחדל לשדה מותאם אישית לפני שמירת מוצר:

<?php
// Plugin/ProductSavePlugin.php
namespace Vendor\Module\Plugin;

use Magento\Catalog\Model\Product;

class ProductSavePlugin
{
    public function beforeSave(Product $subject): void
    {
        if (!$subject->getData('custom_field')) {
            $subject->setData('custom_field', 'default_value');
        }
    }

    public function afterSave(Product $subject, Product $result): Product
    {
        // Инвалидация кастомного кеша при сохранении продукта
        return $result;
    }
}

למה Plugin עדיף על Preference?

Plugin מאפשר לך לשנות רק שיטות ספציפיות מבלי לדרוס את כל המחלקה. זה מפחית את נפח הקוד ב-40% ומפחית את סיכון הקונפליקטים עם מודולים אחרים. Preference מחליף את כל המחלקה, מה שעלול לגרום לבעיות עם מספר דריסות. Magento DevDocs: "Plugins הם הדרך העיקרית להרחיב את ההתנהגות של Magento."

איך בודקים מודול Magento 2?

בדיקות הן חובה. בדיקות יחידה מאמתות לוגיקה בבידוד; בדיקות אינטגרציה מאמתות אינטראקציות עם מסד הנתונים ושירותים חיצוניים. אנחנו מכסים לפחות 70% מהקוד בבדיקות. זה מונע רגרסיות ומגביר את אמינות המודול. השתמש ב-PHPUnit וב-Magento Testing Framework.

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

אנחנו מפתחים מודול מותאם אישית במפתח פתוח:

• הצהרת מודול, composer.json, registration.php.
• Setup Patches עבור סכמה ונתונים.
• ממשקי API ותבנית Repository לפעולות ישות.
• Observer ו-Plugin לאינטגרציה עם אירועי Magento.
• Admin Grids וטפסים לניהול נתונים.
• בדיקות יחידה ואינטגרציה המכסות את הלוגיקה (לפחות 70% שורות).
• תיעוד: תיאור פונקציונלי, מדריך התקנה.
• מסירת גישה ל-Repository ותמיכה.

מקרה בוחן: סנכרון הזמנות עם ERP

מהניסיון שלנו: לקוח עם חנות מקוונת המעבדת 5000 הזמנות ביום נזקק להעברת נתונים למערכת החשבונאות שלו ללא שכפול ידני. פיתחנו מודול עם Observer על <?php // Setup/Patch/Schema/CreateCustomEntityTable.php namespace Vendor\Module\Setup\Patch\Schema; use Magento\Framework\DB\Ddl\Table; use Magento\Framework\Setup\Patch\SchemaPatchInterface; use Magento\Framework\Setup\SchemaSetupInterface; class CreateCustomEntityTable implements SchemaPatchInterface { public function __construct( private readonly SchemaSetupInterface $schemaSetup ) {} public function apply(): void { $setup = $this->schemaSetup; $setup->startSetup(); $connection = $setup->getConnection(); $tableName = $setup->getTable('vendor_custom_entity'); if (!$connection->isTableExists($tableName)) { $table = $connection->newTable($tableName) ->addColumn('entity_id', Table::TYPE_INTEGER, null, [ 'identity' => true, 'nullable' => false, 'primary' => true, 'unsigned' => true, ], 'Entity ID') ->addColumn('product_id', Table::TYPE_INTEGER, null, [ 'unsigned' => true, 'nullable' => false, ], 'Product ID') ->addColumn('custom_value', Table::TYPE_DECIMAL, '12,4', [ 'nullable' => false, 'default' => '0.0000', ], 'Custom Value') ->addColumn('status', Table::TYPE_SMALLINT, null, [ 'nullable' => false, 'default' => 1, ], 'Status') ->addColumn('created_at', Table::TYPE_TIMESTAMP, null, [ 'nullable' => false, 'default' => Table::TIMESTAMP_INIT, ], 'Created At') ->addColumn('updated_at', Table::TYPE_TIMESTAMP, null, [ 'nullable' => false, 'default' => Table::TIMESTAMP_INIT_UPDATE, ], 'Updated At') ->addForeignKey( $setup->getFkName($tableName, 'product_id', 'catalog_product_entity', 'entity_id'), 'product_id', $setup->getTable('catalog_product_entity'), 'entity_id', Table::ACTION_CASCADE ) ->addIndex($setup->getIdxName($tableName, ['status']), ['status']) ->setComment('Vendor Custom Entity Table'); $connection->createTable($table); } $setup->endSetup(); } public static function getDependencies(): array { return []; } public function getAliases(): array { return []; } } , כתיבת נתונים לטבלה מותאמת אישית, ו-Console Command לשליחה ברקע. השתמשנו ב-Plugin כדי להוסיף סטטוס העברה בפאנל הניהול. הפתרון התמודד עם עומס של 1000+ הזמנות בשעה ללא תקלות, והפחית את עלויות העבודה ב-80%. אם אתה צריך אינטגרציה דומה, צור איתנו קשר לייעוץ.

לוחות זמנים ועלות משוערת

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

אנחנו עובדים עם Magento כבר למעלה מ-5 שנים ויישמנו 50+ מודולים מותאמים אישית למשימות שונות. המפתחים שלנו מוסמכים ובקיאים במלא ערימת Magento 2. אנחנו מבטיחים איכות ועמידה בלוחות זמנים. קבל ייעוץ על פיתוח מודול Magento 2 מותאם אישית — מלא את טופס המשוב, ונחזור אליך תוך יום.