제품 속성을 동적으로 추가

마지막 업데이트: 2026년 5월 11일

작성 대상:

{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

제품 특성을 Adobe Commerce에 등록하지 않고 데이터 동기화 프로세스 중에 특성을 추가하는 플러그인을 만들어 제품 특성을 확장할 수 있습니다.

NOTE

제품 특성을 확장하는 가장 좋은 방법은 Catalog Service GraphQL 스키마를 확장하기 위해 을(를) 사용하여 Adobe Commerce where you can configure and manage them from the Commerce Admin. Only add them dynamically if you need them solely for Commerce storefront services and do not want to register them in Adobe Commerce. You also have the option to manage custom attributes using API Mesh 을(를) 추가하는 것입니다. Catalog Service

제품 속성 추가

Magento\CatalogDataExporter\Model\Provider\Product\Attributes 클래스에 customer_attribute을(를) 추가하는 플러그인을 만듭니다.

플러그인을 정의하려면 종속성 삽입 구성 파일(di.xml)을(를) 업데이트하십시오.

code language-xml
`<type name="Magento\CatalogDataExporter\Model\Provider\Product\Attributes"> <plugin name="product_customer_attributes" type="Vendor\CatalogDataExporter\Model\Plugin\AddAttribute"/> </type>`

플러그인을 만듭니다.

code language-php

 <?php
 declare(strict_types=1);

 namespace Vendor\CatalogDataExporter\Model\Plugin;

 use Magento\CatalogDataExporter\Model\Provider\Product\Attributes;

 class AddAttribute {

      /**
       * @param Attributes $subject
       * @param array $result
       * @param $arguments
       * @return array
       * @throws \Zend_Db_Statement_Exception
       */
       public function afterGet(Attributes $subject, array $result, $arguments): array
       {
           $additionalAttributes = [];
           $attributeCode = 'customer_attribute';
           foreach ($result as $product) {
               if (!isset($product['productId']) || !isset($product['storeViewCode'])) {
                   continue;
               }
               // HINT: if needed, do filtration by "storeViewCode" and or "productId"

               $productId = $product['productId'];
               $storeViewCode = $product['storeViewCode'];

               $newKey = \implode('-', [$product['storeViewCode'], $product['productId'], $attributeCode]);
               if (isset($additionalAttributes[$newKey])) {
                   continue;
               }
               $additionalAttributes[$newKey] = [
                   'productId' => $productId,
                   'storeViewCode' => $storeViewCode,
                   'attributes' => [
                       'attributeCode' => $attributeCode,
                       // provide single or multiple values for the attribute
                       'value' => [
                           rand(1, 42)
                       ]
                   ]
               ];

           }

           return array_merge($result, $additionalAttributes);
       }
 }

플러그인을 추가하면 변경 사항이 다음에 예약된 동기화 동안 연결된 상점 서비스에 동기화됩니다. 업데이트를 즉시 보내려면 다음 CLI 명령을 사용하여 동기화 프로세스를 수동으로 시작하십시오.

code language-shell
`bin/magento saas:resync --feed=products`

사용자 지정 제품 특성 메타데이터 선언

사용자 지정 제품 특성을 동적으로 만들고, 이 특성을 Storefront 서비스의 표시, 검색 또는 필터링에 사용하려면 제품 특성 메타데이터를 추가하여 Storefront 동작을 구성하십시오.

종속성 삽입 구성 파일(di.xml)을(를) 업데이트하여 제품 특성 메타데이터에 대한 플러그인을 정의합니다.

code language-xml

<type name="Magento\CatalogDataExporter\Model\Provider\ProductMetadata">
  <plugin name="product_customer_attributes_metadata" type="Vendor\CatalogDataExporter\Model\Plugin\AddAttributeMetadata"/>
</type>

다음 공급자 Magento\CatalogDataExporter\Model\Provider\ProductMetadata에 대한 플러그인을 만드십시오.

필수 필드가 필요하면 vendor/magento/module-catalog-data-exporter/etc/et_schema.xml의 ProductAttributeMetadata을(를) 확인하십시오.

code language-php

 <?php
 declare(strict_types=1);

 namespace Vendor\CatalogDataExporter\Model\Plugin;

 use Magento\CatalogDataExporter\Model\Provider\ProductMetadata;

 class AddAttributeMetadata {

      /**
       * @param ProductMetadata $subject
       * @param array $result
       * @param $arguments
       * @return array
       * @throws \Zend_Db_Statement_Exception
       */
      public function afterGet(ProductMetadata $subject, array $result, $arguments): array
      {
           $result[] = [
             'id' => '123',
             // provide storeCode, websiteCode and storeViewCode applicable for your AC instance
             'storeCode' => 'default',
             'websiteCode' => 'base',
             'storeViewCode' => 'default',
             // specify the customer attribute code - should be the same as used in the products attributes plugin
             'attributeCode' => 'customer_attribute',
             // only product attributes are supported
             'attributeType' => 'catalog_product',
             // specify the data type
             'dataType' => 'int',
             'multi' => false,
             'label' => 'Customer Attribute',
             'frontendInput' => 'select',
             'required' => false,
             'unique' => false,
             'global' => true,
             'visible' => true,
             'searchable' => true,
             'filterable' => true,
             // This value must be set to true to export it to the storefront services
             'visibleInCompareList' => true,
             'visibleInListing' => true,
             'sortable' => true,
             'visibleInSearch' => true,
             'filterableInSearch' => true,
             'searchWeight' => 1.0,
             'usedForRules' => true,
             'boolean' => false,
             'systemAttribute' => false,
             'numeric' => false,
             // specify the list of attribute options
             'attributeOptions' => [
                 'option1',
                 'option2',
                 'option3'
             ]
          ];

           return $result;
      }
   }

code language-shell
`bin/magento saas:resync --feed=productAttributes`

recommendation-more-help

commerce-help-data-export