Product fields cookbook

Product fields control layout of the Data tab on the product card. Create DB columns via extra fields.

Reference: Product fields.

Goal

Group article, price, and extra fields into sections, hide noise, change order. The Data tab Vue component reads GET /api/mgr/config/page-fields/product_data.

page_key

page_key	Screen
product_data	Product “Data” tab

No other page_key for this utility in 1.13.x.

Relation to extra fields

1. POST in Extra fields for MiniShop3\Model\msProductData creates a column and a ms3_product_fields row.
2. Product fields change section, label, xtype, visible, sort_order. Do not create columns here.

Full walkthrough: Wholesale price.

Case: Prices section

1. Utilities → Product fields → Add section.
2. Key prices, label Prices, sort_order after Main data.
3. Move price, old_price, extra wholesale_price into Prices.
4. Save, reload the product card.

Case: hide color and size

When size and color use options:

1. Open field color → disable Visibility.
2. Same for size.
3. Fields stay in DB, hidden on the tab.

Case: SEO block

1. Section seo, label SEO.
2. Move tags or custom metadata extra fields.
3. Reorder sections via drag-and-drop.

API appendix

GET /api/mgr/config/page-fields/product_data
GET /api/mgr/config/sections/product_data
PUT /api/mgr/config/page-fields/product_data
PUT /api/mgr/config/sections/product_data
DELETE /api/mgr/config/sections/product_data/{section_key}

GET is available to any manager session. Writes require mssetting_save. There is no POST /config/sections/... in 1.13.x.

Example PUT fields (fields array):

{
  "fields": [
    {
      "name": "wholesale_price",
      "label": "Wholesale price",
      "section": 2,
      "visible": true,
      "sort_order": 10
    }
  ]
}

Example PUT sections:

{
  "sections": [
    {
      "section_key": "prices",
      "label": "Prices",
      "hidden": false,
      "sort_order": 10
    }
  ]
}

Troubleshooting

Symptom	Action
Changes not visible	Hard reload product card
Field missing from list	Create extra field for msProductData first
Confused with model fields	Model fields — order, vendor. Product fields — Data tab only
Wrong xtype	Edit field in utility or PUT page-fields

See Manager cookbooks, model fields.