@endora-commerce/mod-catalog 0.108.0 → 0.110.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/admin/components/CopyToChannelsDialog.d.ts +37 -0
- package/dist/admin/components/CopyToChannelsDialog.d.ts.map +1 -0
- package/dist/admin/components/CopyToChannelsDialog.js +83 -0
- package/dist/admin/components/CopyToChannelsDialog.js.map +1 -0
- package/dist/admin/components/PackagingUnitsEditor.d.ts +16 -1
- package/dist/admin/components/PackagingUnitsEditor.d.ts.map +1 -1
- package/dist/admin/components/PackagingUnitsEditor.js +20 -14
- package/dist/admin/components/PackagingUnitsEditor.js.map +1 -1
- package/dist/admin/components/ProductAttachmentsSection.d.ts +3 -0
- package/dist/admin/components/ProductAttachmentsSection.d.ts.map +1 -0
- package/dist/admin/components/ProductAttachmentsSection.js +98 -0
- package/dist/admin/components/ProductAttachmentsSection.js.map +1 -0
- package/dist/admin/components/ProductAttributesTab.d.ts +1 -11
- package/dist/admin/components/ProductAttributesTab.d.ts.map +1 -1
- package/dist/admin/components/ProductAttributesTab.js +128 -119
- package/dist/admin/components/ProductAttributesTab.js.map +1 -1
- package/dist/admin/components/ProductContentCard.d.ts +41 -0
- package/dist/admin/components/ProductContentCard.d.ts.map +1 -0
- package/dist/admin/components/ProductContentCard.js +28 -0
- package/dist/admin/components/ProductContentCard.js.map +1 -0
- package/dist/admin/components/ProductGallerySection.d.ts +3 -0
- package/dist/admin/components/ProductGallerySection.d.ts.map +1 -0
- package/dist/admin/components/ProductGallerySection.js +129 -0
- package/dist/admin/components/ProductGallerySection.js.map +1 -0
- package/dist/admin/components/ProductOrderRulesCard.d.ts +11 -15
- package/dist/admin/components/ProductOrderRulesCard.d.ts.map +1 -1
- package/dist/admin/components/ProductOrderRulesCard.js +15 -140
- package/dist/admin/components/ProductOrderRulesCard.js.map +1 -1
- package/dist/admin/components/ProductScopeBar.d.ts +28 -0
- package/dist/admin/components/ProductScopeBar.d.ts.map +1 -0
- package/dist/admin/components/ProductScopeBar.js +70 -0
- package/dist/admin/components/ProductScopeBar.js.map +1 -0
- package/dist/admin/components/ProductScopeOverview.d.ts +38 -0
- package/dist/admin/components/ProductScopeOverview.d.ts.map +1 -0
- package/dist/admin/components/ProductScopeOverview.js +222 -0
- package/dist/admin/components/ProductScopeOverview.js.map +1 -0
- package/dist/admin/components/ProductStatusPills.d.ts +17 -0
- package/dist/admin/components/ProductStatusPills.d.ts.map +1 -0
- package/dist/admin/components/ProductStatusPills.js +23 -0
- package/dist/admin/components/ProductStatusPills.js.map +1 -0
- package/dist/admin/components/ProductUrlRedirects.d.ts +15 -0
- package/dist/admin/components/ProductUrlRedirects.d.ts.map +1 -0
- package/dist/admin/components/ProductUrlRedirects.js +70 -0
- package/dist/admin/components/ProductUrlRedirects.js.map +1 -0
- package/dist/admin/components/ProductsBulkEditDialog.d.ts +30 -0
- package/dist/admin/components/ProductsBulkEditDialog.d.ts.map +1 -1
- package/dist/admin/components/ProductsBulkEditDialog.js +288 -133
- package/dist/admin/components/ProductsBulkEditDialog.js.map +1 -1
- package/dist/admin/components/editor/DetailsTab.d.ts +30 -0
- package/dist/admin/components/editor/DetailsTab.d.ts.map +1 -0
- package/dist/admin/components/editor/DetailsTab.js +59 -0
- package/dist/admin/components/editor/DetailsTab.js.map +1 -0
- package/dist/admin/components/editor/ImmediateBadge.d.ts +21 -0
- package/dist/admin/components/editor/ImmediateBadge.d.ts.map +1 -0
- package/dist/admin/components/editor/ImmediateBadge.js +21 -0
- package/dist/admin/components/editor/ImmediateBadge.js.map +1 -0
- package/dist/admin/components/editor/confirm-removal.d.ts +13 -0
- package/dist/admin/components/editor/confirm-removal.d.ts.map +1 -0
- package/dist/admin/components/editor/confirm-removal.js +33 -0
- package/dist/admin/components/editor/confirm-removal.js.map +1 -0
- package/dist/admin/components/editor/editor-context.d.ts +53 -0
- package/dist/admin/components/editor/editor-context.d.ts.map +1 -0
- package/dist/admin/components/editor/editor-context.js +88 -0
- package/dist/admin/components/editor/editor-context.js.map +1 -0
- package/dist/admin/components/editor/scoped-controls.d.ts +46 -0
- package/dist/admin/components/editor/scoped-controls.d.ts.map +1 -0
- package/dist/admin/components/editor/scoped-controls.js +64 -0
- package/dist/admin/components/editor/scoped-controls.js.map +1 -0
- package/dist/admin/index.d.ts +2 -2
- package/dist/admin/index.d.ts.map +1 -1
- package/dist/admin/index.js +20 -0
- package/dist/admin/index.js.map +1 -1
- package/dist/admin/lib/attribute-scope.d.ts +23 -0
- package/dist/admin/lib/attribute-scope.d.ts.map +1 -0
- package/dist/admin/lib/attribute-scope.js +21 -0
- package/dist/admin/lib/attribute-scope.js.map +1 -0
- package/dist/admin/lib/bulk-operation-log-text.d.ts +9 -0
- package/dist/admin/lib/bulk-operation-log-text.d.ts.map +1 -0
- package/dist/admin/lib/bulk-operation-log-text.js +13 -0
- package/dist/admin/lib/bulk-operation-log-text.js.map +1 -0
- package/dist/admin/lib/editor-scope.d.ts +35 -0
- package/dist/admin/lib/editor-scope.d.ts.map +1 -0
- package/dist/admin/lib/editor-scope.js +114 -0
- package/dist/admin/lib/editor-scope.js.map +1 -0
- package/dist/admin/lib/order-minimum-input.d.ts +13 -0
- package/dist/admin/lib/order-minimum-input.d.ts.map +1 -0
- package/dist/admin/lib/order-minimum-input.js +16 -0
- package/dist/admin/lib/order-minimum-input.js.map +1 -0
- package/dist/admin/lib/product-labels.d.ts +12 -0
- package/dist/admin/lib/product-labels.d.ts.map +1 -0
- package/dist/admin/lib/product-labels.js +23 -0
- package/dist/admin/lib/product-labels.js.map +1 -0
- package/dist/admin/lib/product-scopes-api.d.ts +23 -0
- package/dist/admin/lib/product-scopes-api.d.ts.map +1 -0
- package/dist/admin/lib/product-scopes-api.js +57 -0
- package/dist/admin/lib/product-scopes-api.js.map +1 -0
- package/dist/admin/lib/product-url-keys-api.d.ts +23 -0
- package/dist/admin/lib/product-url-keys-api.d.ts.map +1 -0
- package/dist/admin/lib/product-url-keys-api.js +61 -0
- package/dist/admin/lib/product-url-keys-api.js.map +1 -0
- package/dist/admin/lib/resolve-product-selection.d.ts +29 -1
- package/dist/admin/lib/resolve-product-selection.d.ts.map +1 -1
- package/dist/admin/lib/resolve-product-selection.js +42 -6
- package/dist/admin/lib/resolve-product-selection.js.map +1 -1
- package/dist/admin/lib/scope-overview.d.ts +73 -0
- package/dist/admin/lib/scope-overview.d.ts.map +1 -0
- package/dist/admin/lib/scope-overview.js +178 -0
- package/dist/admin/lib/scope-overview.js.map +1 -0
- package/dist/admin/lib/scoped-editor-store.d.ts +81 -0
- package/dist/admin/lib/scoped-editor-store.d.ts.map +1 -0
- package/dist/admin/lib/scoped-editor-store.js +198 -0
- package/dist/admin/lib/scoped-editor-store.js.map +1 -0
- package/dist/admin/lib/scoped-values-api.d.ts +14 -0
- package/dist/admin/lib/scoped-values-api.d.ts.map +1 -0
- package/dist/admin/lib/scoped-values-api.js +55 -0
- package/dist/admin/lib/scoped-values-api.js.map +1 -0
- package/dist/admin/pages/AttributesManager.d.ts.map +1 -1
- package/dist/admin/pages/AttributesManager.js +186 -28
- package/dist/admin/pages/AttributesManager.js.map +1 -1
- package/dist/admin/pages/BulkOperationDetailPage.d.ts.map +1 -1
- package/dist/admin/pages/BulkOperationDetailPage.js +4 -19
- package/dist/admin/pages/BulkOperationDetailPage.js.map +1 -1
- package/dist/admin/pages/ProductContentPage.d.ts +27 -0
- package/dist/admin/pages/ProductContentPage.d.ts.map +1 -0
- package/dist/admin/pages/ProductContentPage.js +161 -0
- package/dist/admin/pages/ProductContentPage.js.map +1 -0
- package/dist/admin/pages/ProductCreateForm.d.ts +3 -0
- package/dist/admin/pages/ProductCreateForm.d.ts.map +1 -0
- package/dist/admin/pages/ProductCreateForm.js +87 -0
- package/dist/admin/pages/ProductCreateForm.js.map +1 -0
- package/dist/admin/pages/ProductEditor.d.ts +0 -4
- package/dist/admin/pages/ProductEditor.d.ts.map +1 -1
- package/dist/admin/pages/ProductEditor.js +878 -627
- package/dist/admin/pages/ProductEditor.js.map +1 -1
- package/dist/admin/pages/ProductsList.d.ts +12 -0
- package/dist/admin/pages/ProductsList.d.ts.map +1 -1
- package/dist/admin/pages/ProductsList.js +111 -54
- package/dist/admin/pages/ProductsList.js.map +1 -1
- package/dist/backend/admin-search-provider.d.ts +3 -2
- package/dist/backend/admin-search-provider.d.ts.map +1 -1
- package/dist/backend/admin-search-provider.js +2 -3
- package/dist/backend/admin-search-provider.js.map +1 -1
- package/dist/backend/commands/attribute-commands.d.ts +4 -3
- package/dist/backend/commands/attribute-commands.d.ts.map +1 -1
- package/dist/backend/commands/attribute-commands.js +82 -21
- package/dist/backend/commands/attribute-commands.js.map +1 -1
- package/dist/backend/commands/product-content-commands.d.ts +31 -0
- package/dist/backend/commands/product-content-commands.d.ts.map +1 -0
- package/dist/backend/commands/product-content-commands.js +70 -0
- package/dist/backend/commands/product-content-commands.js.map +1 -0
- package/dist/backend/commands/scoped-values.commands.d.ts +95 -0
- package/dist/backend/commands/scoped-values.commands.d.ts.map +1 -0
- package/dist/backend/commands/scoped-values.commands.js +235 -0
- package/dist/backend/commands/scoped-values.commands.js.map +1 -0
- package/dist/backend/demo/reset.d.ts.map +1 -1
- package/dist/backend/demo/reset.js +2 -1
- package/dist/backend/demo/reset.js.map +1 -1
- package/dist/backend/demo/rows.d.ts +25 -0
- package/dist/backend/demo/rows.d.ts.map +1 -1
- package/dist/backend/demo/rows.js +35 -12
- package/dist/backend/demo/rows.js.map +1 -1
- package/dist/backend/demo/seed.d.ts +2 -1
- package/dist/backend/demo/seed.d.ts.map +1 -1
- package/dist/backend/demo/seed.js +22 -8
- package/dist/backend/demo/seed.js.map +1 -1
- package/dist/backend/entities/bulk-operation.entity.d.ts +10 -0
- package/dist/backend/entities/bulk-operation.entity.d.ts.map +1 -1
- package/dist/backend/entities/bulk-operation.entity.js.map +1 -1
- package/dist/backend/entities/gallery-item-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.d.ts.map +1 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.js +80 -0
- package/dist/backend/entities/gallery-item-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/gallery-item.entity.d.ts +9 -1
- package/dist/backend/entities/gallery-item.entity.d.ts.map +1 -1
- package/dist/backend/entities/gallery-item.entity.js +16 -0
- package/dist/backend/entities/gallery-item.entity.js.map +1 -1
- package/dist/backend/entities/gallery-role-scope-override.entity.d.ts +28 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.d.ts.map +1 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.js +75 -0
- package/dist/backend/entities/gallery-role-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-attachment-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/product-attachment.entity.d.ts +6 -1
- package/dist/backend/entities/product-attachment.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-attachment.entity.js +9 -0
- package/dist/backend/entities/product-attachment.entity.js.map +1 -1
- package/dist/backend/entities/product-attribute.entity.d.ts +5 -9
- package/dist/backend/entities/product-attribute.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-attribute.entity.js +5 -13
- package/dist/backend/entities/product-attribute.entity.js.map +1 -1
- package/dist/backend/entities/product-channel-language-scope.entity.d.ts +23 -0
- package/dist/backend/entities/product-channel-language-scope.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-channel-language-scope.entity.js +61 -0
- package/dist/backend/entities/product-channel-language-scope.entity.js.map +1 -0
- package/dist/backend/entities/product-channel-scope.entity.d.ts +47 -0
- package/dist/backend/entities/product-channel-scope.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-channel-scope.entity.js +113 -0
- package/dist/backend/entities/product-channel-scope.entity.js.map +1 -0
- package/dist/backend/entities/product-content-value.entity.d.ts +39 -0
- package/dist/backend/entities/product-content-value.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-content-value.entity.js +81 -0
- package/dist/backend/entities/product-content-value.entity.js.map +1 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts +30 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.js +80 -0
- package/dist/backend/entities/product-packaging-unit-scope-override.entity.js.map +1 -0
- package/dist/backend/entities/product-url-key.entity.d.ts +27 -0
- package/dist/backend/entities/product-url-key.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-url-key.entity.js +70 -0
- package/dist/backend/entities/product-url-key.entity.js.map +1 -0
- package/dist/backend/entities/product-url-redirect.entity.d.ts +18 -0
- package/dist/backend/entities/product-url-redirect.entity.d.ts.map +1 -0
- package/dist/backend/entities/product-url-redirect.entity.js +57 -0
- package/dist/backend/entities/product-url-redirect.entity.js.map +1 -0
- package/dist/backend/entities/product-variant.entity.d.ts +8 -1
- package/dist/backend/entities/product-variant.entity.d.ts.map +1 -1
- package/dist/backend/entities/product-variant.entity.js +13 -2
- package/dist/backend/entities/product-variant.entity.js.map +1 -1
- package/dist/backend/entities/product.entity.d.ts +48 -16
- package/dist/backend/entities/product.entity.d.ts.map +1 -1
- package/dist/backend/entities/product.entity.js +65 -35
- package/dist/backend/entities/product.entity.js.map +1 -1
- package/dist/backend/index.d.ts +29 -2
- package/dist/backend/index.d.ts.map +1 -1
- package/dist/backend/index.js +311 -29
- package/dist/backend/index.js.map +1 -1
- package/dist/backend/plugin.d.ts +79 -8
- package/dist/backend/plugin.d.ts.map +1 -1
- package/dist/backend/plugin.js +98 -17
- package/dist/backend/plugin.js.map +1 -1
- package/dist/backend/prompt-tools.d.ts +11 -0
- package/dist/backend/prompt-tools.d.ts.map +1 -1
- package/dist/backend/prompt-tools.js +124 -9
- package/dist/backend/prompt-tools.js.map +1 -1
- package/dist/backend/routes.admin.d.ts +42 -14
- package/dist/backend/routes.admin.d.ts.map +1 -1
- package/dist/backend/routes.admin.js +214 -134
- package/dist/backend/routes.admin.js.map +1 -1
- package/dist/backend/routes.admin.url-keys.d.ts +23 -0
- package/dist/backend/routes.admin.url-keys.d.ts.map +1 -0
- package/dist/backend/routes.admin.url-keys.js +14 -0
- package/dist/backend/routes.admin.url-keys.js.map +1 -0
- package/dist/backend/routes.api-key.d.ts.map +1 -1
- package/dist/backend/routes.api-key.js +18 -3
- package/dist/backend/routes.api-key.js.map +1 -1
- package/dist/backend/routes.external.d.ts.map +1 -1
- package/dist/backend/routes.external.js +6 -1
- package/dist/backend/routes.external.js.map +1 -1
- package/dist/backend/routes.public.d.ts +31 -7
- package/dist/backend/routes.public.d.ts.map +1 -1
- package/dist/backend/routes.public.js +114 -33
- package/dist/backend/routes.public.js.map +1 -1
- package/dist/backend/routes.public.url-keys.d.ts +26 -0
- package/dist/backend/routes.public.url-keys.d.ts.map +1 -0
- package/dist/backend/routes.public.url-keys.js +17 -0
- package/dist/backend/routes.public.url-keys.js.map +1 -0
- package/dist/backend/services/asset-references.d.ts +12 -1
- package/dist/backend/services/asset-references.d.ts.map +1 -1
- package/dist/backend/services/asset-references.js +85 -32
- package/dist/backend/services/asset-references.js.map +1 -1
- package/dist/backend/services/attachment-packaging-scopes.d.ts +61 -0
- package/dist/backend/services/attachment-packaging-scopes.d.ts.map +1 -0
- package/dist/backend/services/attachment-packaging-scopes.js +98 -0
- package/dist/backend/services/attachment-packaging-scopes.js.map +1 -0
- package/dist/backend/services/attachment.service.d.ts +8 -1
- package/dist/backend/services/attachment.service.d.ts.map +1 -1
- package/dist/backend/services/attachment.service.js +105 -21
- package/dist/backend/services/attachment.service.js.map +1 -1
- package/dist/backend/services/attribute-filter-match.d.ts +14 -0
- package/dist/backend/services/attribute-filter-match.d.ts.map +1 -0
- package/dist/backend/services/attribute-filter-match.js +19 -0
- package/dist/backend/services/attribute-filter-match.js.map +1 -0
- package/dist/backend/services/attribute-scope-preview.d.ts +48 -0
- package/dist/backend/services/attribute-scope-preview.d.ts.map +1 -0
- package/dist/backend/services/attribute-scope-preview.js +76 -0
- package/dist/backend/services/attribute-scope-preview.js.map +1 -0
- package/dist/backend/services/attribute-set.service.d.ts +10 -1
- package/dist/backend/services/attribute-set.service.d.ts.map +1 -1
- package/dist/backend/services/attribute-set.service.js +30 -4
- package/dist/backend/services/attribute-set.service.js.map +1 -1
- package/dist/backend/services/attribute-type-mapping.d.ts +2 -2
- package/dist/backend/services/attribute-type-mapping.d.ts.map +1 -1
- package/dist/backend/services/attribute-type-mapping.js +6 -0
- package/dist/backend/services/attribute-type-mapping.js.map +1 -1
- package/dist/backend/services/attribute-usage.d.ts +31 -0
- package/dist/backend/services/attribute-usage.d.ts.map +1 -0
- package/dist/backend/services/attribute-usage.js +29 -0
- package/dist/backend/services/attribute-usage.js.map +1 -0
- package/dist/backend/services/bulk-operation.service.d.ts +36 -0
- package/dist/backend/services/bulk-operation.service.d.ts.map +1 -1
- package/dist/backend/services/bulk-operation.service.js +210 -37
- package/dist/backend/services/bulk-operation.service.js.map +1 -1
- package/dist/backend/services/bundle.service.d.ts +9 -1
- package/dist/backend/services/bundle.service.d.ts.map +1 -1
- package/dist/backend/services/bundle.service.js +31 -3
- package/dist/backend/services/bundle.service.js.map +1 -1
- package/dist/backend/services/catalog-admin-search.service.d.ts +4 -3
- package/dist/backend/services/catalog-admin-search.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-admin-search.service.js +7 -7
- package/dist/backend/services/catalog-admin-search.service.js.map +1 -1
- package/dist/backend/services/catalog-admin.service.d.ts +171 -27
- package/dist/backend/services/catalog-admin.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-admin.service.js +634 -315
- package/dist/backend/services/catalog-admin.service.js.map +1 -1
- package/dist/backend/services/catalog-attribute-read.service.d.ts +14 -0
- package/dist/backend/services/catalog-attribute-read.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-attribute-read.service.js +7 -19
- package/dist/backend/services/catalog-attribute-read.service.js.map +1 -1
- package/dist/backend/services/catalog-bulk-import.service.d.ts +72 -3
- package/dist/backend/services/catalog-bulk-import.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-bulk-import.service.js +212 -38
- package/dist/backend/services/catalog-bulk-import.service.js.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.d.ts +35 -5
- package/dist/backend/services/catalog-bulk-update.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-bulk-update.service.js +123 -14
- package/dist/backend/services/catalog-bulk-update.service.js.map +1 -1
- package/dist/backend/services/catalog-org-price-decorator.d.ts +12 -25
- package/dist/backend/services/catalog-org-price-decorator.d.ts.map +1 -1
- package/dist/backend/services/catalog-org-price-decorator.js +48 -13
- package/dist/backend/services/catalog-org-price-decorator.js.map +1 -1
- package/dist/backend/services/catalog-product-filter.service.d.ts +16 -2
- package/dist/backend/services/catalog-product-filter.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-product-filter.service.js +80 -3
- package/dist/backend/services/catalog-product-filter.service.js.map +1 -1
- package/dist/backend/services/catalog-product-read.service.d.ts +11 -1
- package/dist/backend/services/catalog-product-read.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-product-read.service.js +40 -23
- package/dist/backend/services/catalog-product-read.service.js.map +1 -1
- package/dist/backend/services/catalog-query.service.d.ts +170 -42
- package/dist/backend/services/catalog-query.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-query.service.js +797 -430
- package/dist/backend/services/catalog-query.service.js.map +1 -1
- package/dist/backend/services/catalog-quick-search.service.d.ts +18 -2
- package/dist/backend/services/catalog-quick-search.service.d.ts.map +1 -1
- package/dist/backend/services/catalog-quick-search.service.js +53 -21
- package/dist/backend/services/catalog-quick-search.service.js.map +1 -1
- package/dist/backend/services/catalog-write-ports.d.ts +16 -1
- package/dist/backend/services/catalog-write-ports.d.ts.map +1 -1
- package/dist/backend/services/catalog-write-ports.js +18 -0
- package/dist/backend/services/catalog-write-ports.js.map +1 -1
- package/dist/backend/services/category-admin.service.d.ts +12 -1
- package/dist/backend/services/category-admin.service.d.ts.map +1 -1
- package/dist/backend/services/category-admin.service.js +32 -3
- package/dist/backend/services/category-admin.service.js.map +1 -1
- package/dist/backend/services/channel-url-facts.d.ts +17 -0
- package/dist/backend/services/channel-url-facts.d.ts.map +1 -0
- package/dist/backend/services/channel-url-facts.js +20 -0
- package/dist/backend/services/channel-url-facts.js.map +1 -0
- package/dist/backend/services/content-attribute-rules.d.ts +49 -0
- package/dist/backend/services/content-attribute-rules.d.ts.map +1 -0
- package/dist/backend/services/content-attribute-rules.js +89 -0
- package/dist/backend/services/content-attribute-rules.js.map +1 -0
- package/dist/backend/services/effective-value.sql.d.ts +42 -0
- package/dist/backend/services/effective-value.sql.d.ts.map +1 -0
- package/dist/backend/services/effective-value.sql.js +61 -0
- package/dist/backend/services/effective-value.sql.js.map +1 -0
- package/dist/backend/services/gallery-scopes.d.ts +63 -0
- package/dist/backend/services/gallery-scopes.d.ts.map +1 -0
- package/dist/backend/services/gallery-scopes.js +158 -0
- package/dist/backend/services/gallery-scopes.js.map +1 -0
- package/dist/backend/services/gallery.service.d.ts +32 -4
- package/dist/backend/services/gallery.service.d.ts.map +1 -1
- package/dist/backend/services/gallery.service.js +182 -44
- package/dist/backend/services/gallery.service.js.map +1 -1
- package/dist/backend/services/grouped.service.d.ts.map +1 -1
- package/dist/backend/services/grouped.service.js +13 -1
- package/dist/backend/services/grouped.service.js.map +1 -1
- package/dist/backend/services/linkable-asset.d.ts +21 -0
- package/dist/backend/services/linkable-asset.d.ts.map +1 -0
- package/dist/backend/services/linkable-asset.js +31 -0
- package/dist/backend/services/linkable-asset.js.map +1 -0
- package/dist/backend/services/packaging-unit.service.d.ts.map +1 -1
- package/dist/backend/services/packaging-unit.service.js +73 -47
- package/dist/backend/services/packaging-unit.service.js.map +1 -1
- package/dist/backend/services/page-builder-content.d.ts +64 -0
- package/dist/backend/services/page-builder-content.d.ts.map +1 -0
- package/dist/backend/services/page-builder-content.js +113 -0
- package/dist/backend/services/page-builder-content.js.map +1 -0
- package/dist/backend/services/primary-asset-url.d.ts +12 -1
- package/dist/backend/services/primary-asset-url.d.ts.map +1 -1
- package/dist/backend/services/primary-asset-url.js +50 -14
- package/dist/backend/services/primary-asset-url.js.map +1 -1
- package/dist/backend/services/product-availability.service.d.ts +92 -0
- package/dist/backend/services/product-availability.service.d.ts.map +1 -0
- package/dist/backend/services/product-availability.service.js +260 -0
- package/dist/backend/services/product-availability.service.js.map +1 -0
- package/dist/backend/services/product-availability.sql.d.ts +71 -0
- package/dist/backend/services/product-availability.sql.d.ts.map +1 -0
- package/dist/backend/services/product-availability.sql.js +77 -0
- package/dist/backend/services/product-availability.sql.js.map +1 -0
- package/dist/backend/services/product-content.service.d.ts +62 -0
- package/dist/backend/services/product-content.service.d.ts.map +1 -0
- package/dist/backend/services/product-content.service.js +122 -0
- package/dist/backend/services/product-content.service.js.map +1 -0
- package/dist/backend/services/product-editor-preferences.service.d.ts +6 -0
- package/dist/backend/services/product-editor-preferences.service.d.ts.map +1 -1
- package/dist/backend/services/product-editor-preferences.service.js +12 -0
- package/dist/backend/services/product-editor-preferences.service.js.map +1 -1
- package/dist/backend/services/product-global-field-rules.d.ts +39 -0
- package/dist/backend/services/product-global-field-rules.d.ts.map +1 -0
- package/dist/backend/services/product-global-field-rules.js +84 -0
- package/dist/backend/services/product-global-field-rules.js.map +1 -0
- package/dist/backend/services/product-link.service.d.ts +10 -9
- package/dist/backend/services/product-link.service.d.ts.map +1 -1
- package/dist/backend/services/product-link.service.js +44 -36
- package/dist/backend/services/product-link.service.js.map +1 -1
- package/dist/backend/services/product-list-view-service.d.ts.map +1 -1
- package/dist/backend/services/product-list-view-service.js +5 -8
- package/dist/backend/services/product-list-view-service.js.map +1 -1
- package/dist/backend/services/product-page-revalidation.d.ts +60 -0
- package/dist/backend/services/product-page-revalidation.d.ts.map +1 -0
- package/dist/backend/services/product-page-revalidation.js +165 -0
- package/dist/backend/services/product-page-revalidation.js.map +1 -0
- package/dist/backend/services/product-scopes.service.d.ts +221 -0
- package/dist/backend/services/product-scopes.service.d.ts.map +1 -0
- package/dist/backend/services/product-scopes.service.js +692 -0
- package/dist/backend/services/product-scopes.service.js.map +1 -0
- package/dist/backend/services/product-summary-text.d.ts +8 -0
- package/dist/backend/services/product-summary-text.d.ts.map +1 -0
- package/dist/backend/services/product-summary-text.js +8 -0
- package/dist/backend/services/product-summary-text.js.map +1 -0
- package/dist/backend/services/product-value-resolver.service.d.ts +2 -2
- package/dist/backend/services/product-value-resolver.service.d.ts.map +1 -1
- package/dist/backend/services/product-value-resolver.service.js +4 -7
- package/dist/backend/services/product-value-resolver.service.js.map +1 -1
- package/dist/backend/services/publication-window-sweep.d.ts +131 -0
- package/dist/backend/services/publication-window-sweep.d.ts.map +1 -0
- package/dist/backend/services/publication-window-sweep.js +204 -0
- package/dist/backend/services/publication-window-sweep.js.map +1 -0
- package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
- package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
- package/dist/backend/services/scheduled-work-probe.js +30 -0
- package/dist/backend/services/scheduled-work-probe.js.map +1 -0
- package/dist/backend/services/scope-completeness.d.ts +107 -0
- package/dist/backend/services/scope-completeness.d.ts.map +1 -0
- package/dist/backend/services/scope-completeness.js +173 -0
- package/dist/backend/services/scope-completeness.js.map +1 -0
- package/dist/backend/services/scope-overview.service.d.ts +112 -0
- package/dist/backend/services/scope-overview.service.d.ts.map +1 -0
- package/dist/backend/services/scope-overview.service.js +329 -0
- package/dist/backend/services/scope-overview.service.js.map +1 -0
- package/dist/backend/services/scoped-store-adapters.d.ts +58 -0
- package/dist/backend/services/scoped-store-adapters.d.ts.map +1 -0
- package/dist/backend/services/scoped-store-adapters.js +92 -0
- package/dist/backend/services/scoped-store-adapters.js.map +1 -0
- package/dist/backend/services/scoped-values-global-only.d.ts +36 -0
- package/dist/backend/services/scoped-values-global-only.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-global-only.js +92 -0
- package/dist/backend/services/scoped-values-global-only.js.map +1 -0
- package/dist/backend/services/scoped-values-import.d.ts +86 -0
- package/dist/backend/services/scoped-values-import.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-import.js +320 -0
- package/dist/backend/services/scoped-values-import.js.map +1 -0
- package/dist/backend/services/scoped-values-read.service.d.ts +56 -0
- package/dist/backend/services/scoped-values-read.service.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-read.service.js +289 -0
- package/dist/backend/services/scoped-values-read.service.js.map +1 -0
- package/dist/backend/services/scoped-values-save.service.d.ts +79 -0
- package/dist/backend/services/scoped-values-save.service.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-save.service.js +675 -0
- package/dist/backend/services/scoped-values-save.service.js.map +1 -0
- package/dist/backend/services/scoped-values-state.d.ts +94 -0
- package/dist/backend/services/scoped-values-state.d.ts.map +1 -0
- package/dist/backend/services/scoped-values-state.js +159 -0
- package/dist/backend/services/scoped-values-state.js.map +1 -0
- package/dist/backend/services/scoped-values.service.d.ts +36 -0
- package/dist/backend/services/scoped-values.service.d.ts.map +1 -0
- package/dist/backend/services/scoped-values.service.js +92 -0
- package/dist/backend/services/scoped-values.service.js.map +1 -0
- package/dist/backend/services/sql-id-arrays.d.ts +16 -0
- package/dist/backend/services/sql-id-arrays.d.ts.map +1 -0
- package/dist/backend/services/sql-id-arrays.js +24 -0
- package/dist/backend/services/sql-id-arrays.js.map +1 -0
- package/dist/backend/services/storefront-value-overrides.d.ts +7 -8
- package/dist/backend/services/storefront-value-overrides.d.ts.map +1 -1
- package/dist/backend/services/storefront-value-overrides.js +11 -14
- package/dist/backend/services/storefront-value-overrides.js.map +1 -1
- package/dist/backend/services/url-key-resolution.service.d.ts +70 -0
- package/dist/backend/services/url-key-resolution.service.d.ts.map +1 -0
- package/dist/backend/services/url-key-resolution.service.js +179 -0
- package/dist/backend/services/url-key-resolution.service.js.map +1 -0
- package/dist/backend/services/url-key.service.d.ts +123 -0
- package/dist/backend/services/url-key.service.d.ts.map +1 -0
- package/dist/backend/services/url-key.service.js +566 -0
- package/dist/backend/services/url-key.service.js.map +1 -0
- package/dist/manifest.d.ts +9 -1
- package/dist/manifest.d.ts.map +1 -1
- package/dist/manifest.js +204 -10
- package/dist/manifest.js.map +1 -1
- package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts +28 -0
- package/dist/migrations/20261022T035133_catalog_product_scopes.d.ts.map +1 -0
- package/dist/migrations/20261022T035133_catalog_product_scopes.js +92 -0
- package/dist/migrations/20261022T035133_catalog_product_scopes.js.map +1 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts +32 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.d.ts.map +1 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.js +81 -0
- package/dist/migrations/20261022T054223_catalog_product_url_keys.js.map +1 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts +34 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.d.ts.map +1 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js +57 -0
- package/dist/migrations/20261025T222634_catalog_product_status_drop_draft.js.map +1 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts +26 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.d.ts.map +1 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.js +54 -0
- package/dist/migrations/20261026T033453_catalog_product_media_scopes.js.map +1 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts +27 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.d.ts.map +1 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js +45 -0
- package/dist/migrations/20261026T084533_catalog_attachment_packaging_translations.js.map +1 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts +36 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.d.ts.map +1 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.js +225 -0
- package/dist/migrations/20261030T113855_catalog_scope_model_texts.js.map +1 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts +18 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.d.ts.map +1 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js +39 -0
- package/dist/migrations/20261030T113859_catalog_scope_model_order_rules.js.map +1 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts +6 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.d.ts.map +1 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js +119 -0
- package/dist/migrations/20261030T113904_catalog_scope_model_url_keys.js.map +1 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts +6 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.d.ts.map +1 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.js +185 -0
- package/dist/migrations/20261030T113908_catalog_scope_model_media.js.map +1 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts +36 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.d.ts.map +1 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.js +53 -0
- package/dist/migrations/20261104T121504_catalog_product_content_values.js.map +1 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts +33 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.d.ts.map +1 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js +58 -0
- package/dist/migrations/20261107T093126_catalog_sku_unique_among_live.js.map +1 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts +36 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.d.ts.map +1 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js +40 -0
- package/dist/migrations/20261107T120008_catalog_product_created_at_milliseconds.js.map +1 -0
- package/dist/migrations/index.d.ts +13 -1
- package/dist/migrations/index.d.ts.map +1 -1
- package/dist/migrations/index.js +25 -1
- package/dist/migrations/index.js.map +1 -1
- package/docs/catalog/attachments.md +60 -8
- package/docs/catalog/attribute-sets.md +2 -2
- package/docs/catalog/attributes.md +68 -8
- package/docs/catalog/category-content.md +3 -0
- package/docs/catalog/composite-products.md +2 -2
- package/docs/catalog/editing-a-product-at-a-scope.md +95 -0
- package/docs/catalog/gallery-and-labels.md +68 -8
- package/docs/catalog/packaging-units.md +56 -10
- package/docs/catalog/per-channel-per-language-overrides.md +68 -237
- package/docs/catalog/product-content.md +180 -0
- package/docs/catalog/product-links.md +2 -2
- package/docs/catalog/url-keys-and-redirects.md +142 -0
- package/docs/catalog.md +241 -20
- package/i18n/en.json +977 -123
- package/i18n/pl.json +976 -122
- package/package.json +12 -12
- package/dist/admin/components/ProductScopeEditor.d.ts +0 -94
- package/dist/admin/components/ProductScopeEditor.d.ts.map +0 -1
- package/dist/admin/components/ProductScopeEditor.js +0 -395
- package/dist/admin/components/ProductScopeEditor.js.map +0 -1
- package/dist/backend/services/product-overrides.service.d.ts +0 -77
- package/dist/backend/services/product-overrides.service.d.ts.map +0 -1
- package/dist/backend/services/product-overrides.service.js +0 -204
- package/dist/backend/services/product-overrides.service.js.map +0 -1
- package/dist/backend/services/product-scope-context.service.d.ts +0 -36
- package/dist/backend/services/product-scope-context.service.d.ts.map +0 -1
- package/dist/backend/services/product-scope-context.service.js +0 -106
- package/dist/backend/services/product-scope-context.service.js.map +0 -1
|
@@ -1,261 +1,92 @@
|
|
|
1
1
|
---
|
|
2
|
-
title:
|
|
2
|
+
title: Product scopes — Global, channel and channel × language
|
|
3
|
+
description: How a product value is set once for every channel and overridden per sales channel or per sales channel and language.
|
|
3
4
|
---
|
|
4
5
|
|
|
5
|
-
#
|
|
6
|
+
# Product scopes — Global, channel and channel × language
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
values. The same attribute key can hold up to four addressable slots
|
|
9
|
-
per product:
|
|
8
|
+
Every scoped product value lives at one of **three levels**:
|
|
10
9
|
|
|
11
|
-
-
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
- `channel+language` — one value per `(channel, language)` pair.
|
|
10
|
+
- **Global** — one value for every sales channel and every language;
|
|
11
|
+
- **Channel** — one value for one sales channel, in every language that channel offers;
|
|
12
|
+
- **Channel × language** — one value for one sales channel in one of its languages.
|
|
15
13
|
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
language-scoped via a backend constant
|
|
20
|
-
(`SYSTEM_ATTRIBUTE_SCOPES`). User-defined attributes default to
|
|
21
|
-
global-only and opt in via the attribute editor.
|
|
14
|
+
There is no language-only level. A translation is a Channel × language value, or a Channel value when the channel
|
|
15
|
+
sells in one language. A value is resolved from the narrowest level that holds one:
|
|
16
|
+
**Channel × language → Channel → Global**.
|
|
22
17
|
|
|
23
|
-
##
|
|
18
|
+
## Which fields live where
|
|
24
19
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
20
|
+
| Field | Global | Channel | Channel × language |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| Name, description | yes | yes | yes |
|
|
23
|
+
| Text attributes marked *scopable* | yes | yes | yes |
|
|
24
|
+
| Other scopable attributes (numbers, selects, booleans) | yes | yes | — |
|
|
25
|
+
| Attributes not marked scopable | yes | — | — |
|
|
26
|
+
| Status | yes | yes | yes |
|
|
27
|
+
| Publication window, audience, minimum order quantity, returnable | yes | yes | — |
|
|
28
|
+
| URL key | yes | yes | yes |
|
|
29
|
+
| Gallery alt text, hide image, gallery roles | yes | yes | yes |
|
|
30
|
+
| Attachment name, description, hidden | yes | yes | yes |
|
|
31
|
+
| Packaging-unit name | yes | yes | yes |
|
|
32
|
+
| SEO title, description, Open Graph fields (owned by the `seo` module) | yes | yes | yes |
|
|
33
33
|
|
|
34
|
-
|
|
34
|
+
SKU, type, attribute set, categories, stock settings and the download file have one value for the whole product and
|
|
35
|
+
are edited at Global only. Writing one of them at another scope is refused with `GLOBAL_ONLY_FIELD`; writing a field
|
|
36
|
+
at a level it does not support is refused with `FIELD_NOT_AT_SCOPE`.
|
|
35
37
|
|
|
36
|
-
|
|
38
|
+
## Inherit, a value, or deliberately empty
|
|
37
39
|
|
|
38
|
-
|
|
39
|
-
- `products.description` (`Record<lang, string>` JSONB) — language-scoped.
|
|
40
|
-
- `products.attribute_values` (`Record<key, value>` JSONB) — global by
|
|
41
|
-
default. When the attribute's `languageScoped` flag is `true`, the
|
|
42
|
-
inner value is itself keyed by language: `Record<key, Record<lang,
|
|
43
|
-
value>>`.
|
|
40
|
+
At Channel and Channel × language each field is in one of three states:
|
|
44
41
|
|
|
45
|
-
|
|
42
|
+
- **Inherits** — the editor shows "Use value from *parent scope*" and the effective value comes from the level above;
|
|
43
|
+
- **Own value** — the value stored at this scope;
|
|
44
|
+
- **Deliberately empty** — an override that is empty on purpose. It stops the chain: a description emptied for one
|
|
45
|
+
channel stays empty there even though Global has one. A required field (the name, a required attribute) cannot be
|
|
46
|
+
emptied.
|
|
46
47
|
|
|
47
|
-
|
|
48
|
-
create table "product_value_overrides" (
|
|
49
|
-
"id" uuid primary key default gen_random_uuid(),
|
|
50
|
-
"product_id" uuid not null references "products"("id") on delete cascade,
|
|
51
|
-
"attribute_key" varchar(64) not null,
|
|
52
|
-
"channel_id" uuid not null references "sales_channels"("id") on delete cascade,
|
|
53
|
-
"language_code" varchar(16) null,
|
|
54
|
-
"value" jsonb not null, -- always wrapped { "v": <scalar | object> }
|
|
55
|
-
"created_at" timestamptz not null default now(),
|
|
56
|
-
"updated_at" timestamptz not null default now()
|
|
57
|
-
);
|
|
58
|
-
```
|
|
48
|
+
## The write encoding
|
|
59
49
|
|
|
60
|
-
|
|
61
|
-
**two partial indexes**:
|
|
50
|
+
Every writer — the editor's save, the import files and the PIM connector port — uses one encoding:
|
|
62
51
|
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
52
|
+
| Intent | JSON | CSV cell |
|
|
53
|
+
| --- | --- | --- |
|
|
54
|
+
| No change | the field absent, or `""` | an empty cell |
|
|
55
|
+
| Deliberately empty | `null` | `NULL` (the whole cell) |
|
|
56
|
+
| Remove the own value and inherit | `{ "inherit": true }` | `INHERIT` (the whole cell) |
|
|
57
|
+
| A value | the value | the text; `\NULL` and `\INHERIT` are the literal words |
|
|
67
58
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
```
|
|
59
|
+
This is **not** JSON Merge Patch, where `null` removes a member: here `null` stores an empty override and only
|
|
60
|
+
`{ "inherit": true }` removes one. It is also not Magento's `__EMPTY__VALUE__` marker. `INHERIT` at Global and an
|
|
61
|
+
empty required field are refused with `SCOPED_VALUE_INVALID`.
|
|
72
62
|
|
|
73
|
-
|
|
74
|
-
the only correct way to model "(channel, NULL) and (channel, NULL) are
|
|
75
|
-
the same row" is two partial indexes — one for each NULL semantic.
|
|
63
|
+
## Reading and saving a scope
|
|
76
64
|
|
|
77
|
-
|
|
65
|
+
- `GET /api/v1/admin/catalog/products/:id/scoped-values?channelId=&languageCode=` (`catalog:read`) answers every
|
|
66
|
+
field's effective value at the scope, its source (`set`, `set_empty`, `inherited_channel`, `inherited_global`,
|
|
67
|
+
`absent`), the levels it supports, what the completeness check misses at that scope and the product's
|
|
68
|
+
`version`.
|
|
69
|
+
- `PUT /api/v1/admin/catalog/products/:id/scoped-values` (`catalog:write`) saves one scope in one Command with one
|
|
70
|
+
audit entry. The body carries the `version` the editor read; a save made against an older version is refused with
|
|
71
|
+
`409 VERSION_CONFLICT`, so two operators never overwrite each other silently.
|
|
72
|
+
- `POST …/scoped-values/copy` copies one Channel × language value to other channels of the product.
|
|
78
73
|
|
|
79
|
-
|
|
80
|
-
create index "product_value_overrides_product_attr_idx"
|
|
81
|
-
on "product_value_overrides" ("product_id", "attribute_key");
|
|
82
|
-
```
|
|
74
|
+
## Channels a product leaves
|
|
83
75
|
|
|
84
|
-
A
|
|
85
|
-
|
|
86
|
-
product
|
|
87
|
-
It carries no FK to `sales_channels` so a deleted / un-assigned
|
|
88
|
-
channel is silently tolerated on read.
|
|
76
|
+
A value stored for a channel the product is no longer sold on, or for a language the channel no longer offers, is
|
|
77
|
+
kept but ignored. The scope map lists such rows so they can be removed; they come back into effect if the
|
|
78
|
+
product returns to that channel or language.
|
|
89
79
|
|
|
90
|
-
##
|
|
80
|
+
## Duplicating a product
|
|
91
81
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
effective-value preview cannot drift from what the storefront renders.
|
|
82
|
+
**Duplicate** copies the product's values at every scope — Global, Channel and Channel × language, deliberately empty
|
|
83
|
+
values and inherit states included — for every field family above, in one audited Command. Two things are not
|
|
84
|
+
copied: URL keys (the copy gets a fresh Global key, because a key is one product's per channel) and status (the copy
|
|
85
|
+
starts inactive everywhere, so it is reviewed before it is sold).
|
|
97
86
|
|
|
98
|
-
|
|
99
|
-
— walks four steps:
|
|
87
|
+
## Related pages
|
|
100
88
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
3. `(global + language)` baseline — for language-scoped attributes,
|
|
106
|
-
pick the requested language out of the JSONB;
|
|
107
|
-
4. `(global)` baseline — single value (or primary-language pick for
|
|
108
|
-
language-scoped attrs).
|
|
109
|
-
|
|
110
|
-
The first non-empty slot wins. Empty string, `null`, empty object,
|
|
111
|
-
empty array are all treated as "absent" and fall through. The function
|
|
112
|
-
returns both the resolved value AND a `source` tag indicating which
|
|
113
|
-
slot produced the answer — the admin UI consumes this to render the
|
|
114
|
-
"channel + language override" / "global baseline" badge per field.
|
|
115
|
-
|
|
116
|
-
### Orphan tolerance
|
|
117
|
-
|
|
118
|
-
An administrator can flip an attribute's `channelScoped` flag back to
|
|
119
|
-
`false` after channel overrides have already been written. The
|
|
120
|
-
resolver simply skips override rows whose attribute is no longer
|
|
121
|
-
channel-scoped, so the storefront falls back to the baseline without
|
|
122
|
-
any data-loss event. A future maintenance pass can drop orphan rows;
|
|
123
|
-
this feature does not require it.
|
|
124
|
-
|
|
125
|
-
## Write path
|
|
126
|
-
|
|
127
|
-
Channel-aware overrides land through one admin endpoint:
|
|
128
|
-
|
|
129
|
-
```
|
|
130
|
-
PATCH /api/v1/admin/catalog/products/:id/value-overrides
|
|
131
|
-
{
|
|
132
|
-
"upserts": [
|
|
133
|
-
{ "attributeKey": "name", "channelId": "<vip-uuid>", "languageCode": "en-US", "value": { "v": "VIP wholesale name (EN)" } },
|
|
134
|
-
{ "attributeKey": "description", "channelId": "<vip-uuid>", "languageCode": "pl-PL", "value": { "v": "Wholesale-only Polish copy" } }
|
|
135
|
-
],
|
|
136
|
-
"deletes": [
|
|
137
|
-
{ "attributeKey": "description", "channelId": "<retail-uuid>", "languageCode": "en-US" }
|
|
138
|
-
]
|
|
139
|
-
}
|
|
140
|
-
```
|
|
141
|
-
|
|
142
|
-
All requested operations run in a single `em.transactional` pass.
|
|
143
|
-
The handler validates every entry up front against six rules and
|
|
144
|
-
rolls everything back on the first failure:
|
|
145
|
-
|
|
146
|
-
| 422 code | Triggered when |
|
|
147
|
-
| ----------------------------------- | -------------- |
|
|
148
|
-
| `attribute_unknown` | `attributeKey` is neither a system attr (`name`, `description`) nor a row in `product_attributes`. |
|
|
149
|
-
| `attribute_not_channel_scoped` | the attribute's `channelScoped=false`, so it has no channel slot. |
|
|
150
|
-
| `attribute_missing_language` | the attribute's `languageScoped=true`, but the slot has `languageCode=null`. |
|
|
151
|
-
| `channel_not_assigned_to_product` | `channelId` is not in `sales_channel_products` for the product. |
|
|
152
|
-
| `language_not_in_channel` | `languageCode` is non-null and not in the channel's `SalesChannel.languages` array. |
|
|
153
|
-
| `value_invalid` | the wrapped `value.v` does not match the attribute's `valueType`. |
|
|
154
|
-
|
|
155
|
-
The baseline write path (Name / Description per language; global
|
|
156
|
-
`attribute_values`) is unchanged — editors still use the existing
|
|
157
|
-
locale-side-by-side inputs on the Details tab. Channel overrides are
|
|
158
|
-
additive.
|
|
159
|
-
|
|
160
|
-
## Read paths
|
|
161
|
-
|
|
162
|
-
These consumers go through the resolver:
|
|
163
|
-
|
|
164
|
-
- **Admin endpoint** — `GET /api/v1/admin/catalog/products/:id?channelId=&languageCode=&includeOverridesMap=true`
|
|
165
|
-
returns the baseline product PLUS, when context params are passed, a
|
|
166
|
-
`resolved` block with `name`, `description`, `attributeValues`,
|
|
167
|
-
`sources`. When `includeOverridesMap=true`, the full override list
|
|
168
|
-
is attached for client-side switcher previews.
|
|
169
|
-
- **Storefront public read** — pulls the channel from the
|
|
170
|
-
`x-sales-channel` header (the existing convention) and
|
|
171
|
-
the language from `Accept-Language`, else the channel's default
|
|
172
|
-
language. The override layer is invisible to the public client: it
|
|
173
|
-
receives the effective value. The product page (name, description,
|
|
174
|
-
SEO fields, attribute values, the product-page attribute list, grouped
|
|
175
|
-
children and bundle options) and every listing card walk the storefront's own baseline language pick — requested
|
|
176
|
-
language, then the channel's default language, then `en-US`, `en` and
|
|
177
|
-
the first stored language — and at each language take the
|
|
178
|
-
`(channel + language)` slot if it is filled, else stop there if the
|
|
179
|
-
baseline has text for that language. An override therefore answers
|
|
180
|
-
only for the language whose baseline text the page would show, or an
|
|
181
|
-
earlier one in that order: a request in `en-US` on a channel whose
|
|
182
|
-
default is `pl-PL` shows the `en-US` baseline, not the `pl-PL`
|
|
183
|
-
override, while a `de-DE` request for a product with no `de-DE` text
|
|
184
|
-
falls through to `pl-PL` and shows its override. The `(channel-only)`
|
|
185
|
-
slot is asked last and wins over the baseline wherever the walk
|
|
186
|
-
stopped. Product-link tiles keep their own language pick, which has
|
|
187
|
-
no channel-default leg, and walk the override slots over it, so a
|
|
188
|
-
tile can show the `en-US` baseline where the listing card shows the
|
|
189
|
-
channel default's override. A product without overrides shows exactly what
|
|
190
|
-
it showed before. Listing filters, attribute filters and name sorting
|
|
191
|
-
still read the baseline.
|
|
192
|
-
- **Search indexer (Meilisearch)** — builds one document per
|
|
193
|
-
`(product, channel)` pair. Each document's `name` and `description`
|
|
194
|
-
fields are run through the resolver with `channel.defaultLanguage`
|
|
195
|
-
as the active language, so per-channel overrides flow into
|
|
196
|
-
storefront search ranking and name sorting.
|
|
197
|
-
- **Search result cards** — the search module re-reads every hit from
|
|
198
|
-
Postgres before it answers, and the card name it shows is resolved
|
|
199
|
-
there, not taken from the index: the request's sales channel override
|
|
200
|
-
rows are read once per results page and the card walks the same
|
|
201
|
-
languages and slots, in the same order, as a listing card above. The indexed name is
|
|
202
|
-
resolved for the channel's default language only, so it would be
|
|
203
|
-
wrong for a request in any other language. A product without an
|
|
204
|
-
override for the channel shows exactly what it showed before.
|
|
205
|
-
|
|
206
|
-
## Admin UI
|
|
207
|
-
|
|
208
|
-
The product edit page's **Details** tab gains a
|
|
209
|
-
`<ProductScopeEditor>` panel above the existing locale inputs. It:
|
|
210
|
-
|
|
211
|
-
1. Loads `GET /scope-context` (channels assigned to the product + each
|
|
212
|
-
channel's languages + the platform primary admin language + the
|
|
213
|
-
editor's remembered preference) and `GET /value-overrides` in
|
|
214
|
-
parallel.
|
|
215
|
-
2. Renders a Sales Channel switcher (Global + each assigned channel)
|
|
216
|
-
and a Language switcher narrowed to the active channel's languages
|
|
217
|
-
(or the union of all channel languages when Global).
|
|
218
|
-
3. Shows the resolved Name + Description for the active context with a
|
|
219
|
-
source badge per field — `channel + language override` / `channel
|
|
220
|
-
override` / `global baseline (language)` / `global baseline
|
|
221
|
-
(fallback)` / `no value`.
|
|
222
|
-
4. Offers "Add override" / "Edit override" / "Reset to Global"
|
|
223
|
-
affordances per field. Edits go through `PATCH /value-overrides`
|
|
224
|
-
with optimistic refresh.
|
|
225
|
-
5. Persists the editor's `(channel, language)` selection back via
|
|
226
|
-
`PUT /editor-preference` (debounced, best-effort) so the next visit
|
|
227
|
-
seeds the same context.
|
|
228
|
-
|
|
229
|
-
Edit affordances are gated on a specific channel being selected.
|
|
230
|
-
Under Global / no channel, the panel is read-only and a help string
|
|
231
|
-
explains that overrides only apply per-channel.
|
|
232
|
-
|
|
233
|
-
## Migration
|
|
234
|
-
|
|
235
|
-
One migration `20260611T140346_catalog_product_value_overrides_init.ts` ships everything:
|
|
236
|
-
|
|
237
|
-
- adds `channel_scoped` + `language_scoped` boolean columns to
|
|
238
|
-
`product_attributes` (default `false`);
|
|
239
|
-
- creates `product_value_overrides` with the two partial UNIQUE
|
|
240
|
-
indexes and the `(product_id, attribute_key)` btree;
|
|
241
|
-
- creates `product_editor_preferences` (composite PK
|
|
242
|
-
`(admin_user_id, product_id)`).
|
|
243
|
-
|
|
244
|
-
No baseline data migration. No data backfill. The `down()` is the
|
|
245
|
-
exact inverse — drop the two tables and the two columns.
|
|
246
|
-
|
|
247
|
-
## What is not in scope
|
|
248
|
-
|
|
249
|
-
- **User-defined attribute overrides in the admin UI** — the panel
|
|
250
|
-
surfaces only the system Name + Description today. User attribute
|
|
251
|
-
overrides are accepted by the PATCH endpoint and resolved on read,
|
|
252
|
-
but the admin SPA does not yet expose a write affordance for them.
|
|
253
|
-
- **Override-aware listing filters and sorting** — the public catalog
|
|
254
|
-
endpoint returns `name` and `description` as the resolved string for
|
|
255
|
-
the request's sales channel and language (see *Read paths* above), but
|
|
256
|
-
listing filters, attribute filters and name sorting still read the
|
|
257
|
-
baseline values. Making them follow the overrides is a follow-up.
|
|
258
|
-
- **Channel-aware reindex enqueue** — the PATCH endpoint does not
|
|
259
|
-
yet enqueue a Meilisearch reindex job per touched channel; the
|
|
260
|
-
next per-product upsert (driven by any catalog mutation) picks it
|
|
261
|
-
up. A dedicated reindex on override write is a small follow-up.
|
|
89
|
+
- [Editing a product at a scope](./editing-a-product-at-a-scope.md) — the scope switcher, inherit and the Scope map in the editor.
|
|
90
|
+
- [URL Keys and Redirects](./url-keys-and-redirects.md) — key uniqueness per channel and redirects.
|
|
91
|
+
- [Gallery and Labels](./gallery-and-labels.md), [Attachments](./attachments.md),
|
|
92
|
+
[Packaging Units](./packaging-units.md) — the media and packaging values per scope.
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: Product content
|
|
3
|
+
description: Page Builder documents kept per product in content attributes and rendered on the product page's description tab.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Product content
|
|
7
|
+
|
|
8
|
+
A **content attribute** holds one Page Builder document per language for each
|
|
9
|
+
product — a buying guide, a feature banner, a size chart. The product page shows
|
|
10
|
+
it in the description tab (**Opis**), below the plain description. Anything the
|
|
11
|
+
Page Builder offers can go into it, including formatted text written in its
|
|
12
|
+
rich-text block.
|
|
13
|
+
|
|
14
|
+
## Defining a content attribute
|
|
15
|
+
|
|
16
|
+
On **Catalog → Attributes**, create an attribute with the type **Page Builder
|
|
17
|
+
content**. The type comes with fixed settings:
|
|
18
|
+
|
|
19
|
+
- it is always kept **per language**;
|
|
20
|
+
- it cannot be searchable, filterable, comparable, a variant axis, a
|
|
21
|
+
promotion or price-list rule, mass-editable, quick-searchable, required,
|
|
22
|
+
shown in the **Parametry** tab, or set per sales channel. The form does not
|
|
23
|
+
offer those settings, the list shows them locked, and the API refuses each one
|
|
24
|
+
with `400 VALIDATION_FAILED`, naming the setting;
|
|
25
|
+
- it has no options;
|
|
26
|
+
- its type cannot be changed later, and no other attribute can be changed into
|
|
27
|
+
it (`409`).
|
|
28
|
+
|
|
29
|
+
Then add the attribute to an [attribute set](./attribute-sets.md). Its position
|
|
30
|
+
in the set is the order in which the product page shows the set's content
|
|
31
|
+
attributes. The type is offered for products only — the generic custom-field
|
|
32
|
+
screens of other records do not offer it.
|
|
33
|
+
|
|
34
|
+
## Authoring
|
|
35
|
+
|
|
36
|
+
On the product's **Attributes** tab, each content attribute of the product's
|
|
37
|
+
saved attribute set is a card rather than an input, below the attribute values.
|
|
38
|
+
The card shows, per editing language, whether content is filled in, and a short
|
|
39
|
+
summary of what is stored. The cards are the same at every scope of the editor's
|
|
40
|
+
scope switcher: content has no value per sales channel.
|
|
41
|
+
**Edit content** opens the product content screen
|
|
42
|
+
(`/catalog/products/:id/content/:attributeKey`). It has:
|
|
43
|
+
|
|
44
|
+
- a **language** switch — English, Polish, and any other language the stored
|
|
45
|
+
content already has;
|
|
46
|
+
- the **Page Builder** canvas for the selected language;
|
|
47
|
+
- **Save content** — one save stores every language you edited. Leaving the screen with
|
|
48
|
+
unsaved edits asks first. The back link returns to the product's Attributes
|
|
49
|
+
tab.
|
|
50
|
+
|
|
51
|
+
The card offers no link while the product has not been saved yet, or while the
|
|
52
|
+
Details tab shows a different attribute set from the saved one — save the
|
|
53
|
+
product first.
|
|
54
|
+
|
|
55
|
+
To remove a language, delete every block from its document and save. A language
|
|
56
|
+
with no block is not stored, and an attribute with no language left holds no
|
|
57
|
+
value.
|
|
58
|
+
|
|
59
|
+
Reading content needs the catalogue read permission, and saving it the catalogue
|
|
60
|
+
write permission. Without the write permission the screen is read-only.
|
|
61
|
+
|
|
62
|
+
The canvas offers the Page Builder's **Translate** action under its usual
|
|
63
|
+
switch and permission. A translation lands in the canvas and is stored only when
|
|
64
|
+
you press **Save content**.
|
|
65
|
+
|
|
66
|
+
## On the storefront
|
|
67
|
+
|
|
68
|
+
The description tab is shown when the product has a plain description **or** at
|
|
69
|
+
least one content attribute with content. It shows the plain description first,
|
|
70
|
+
then each content attribute in the attribute set's order. No heading or label is
|
|
71
|
+
printed above a document — the document carries its own headings.
|
|
72
|
+
|
|
73
|
+
Each document is resolved to one language in this order: the visitor's language,
|
|
74
|
+
the sales channel's default language, English, then any language that has
|
|
75
|
+
content. A language whose document holds no block is skipped. The content is the
|
|
76
|
+
product's, so it is the same whichever variant is selected.
|
|
77
|
+
|
|
78
|
+
The blocks are drawn by the storefront's Page Builder renderer — the one that
|
|
79
|
+
draws CMS pages — so HTML an operator typed is sanitised the same way, and a
|
|
80
|
+
block that belongs to a switched-off module is not drawn. A saved change is
|
|
81
|
+
visible on the next load of the product page.
|
|
82
|
+
|
|
83
|
+
Content never appears in the **Parametry** tab. That tab lists only attributes
|
|
84
|
+
marked visible on the product page that hold a value, and it is not shown when
|
|
85
|
+
there is none.
|
|
86
|
+
|
|
87
|
+
## When the CMS module is off
|
|
88
|
+
|
|
89
|
+
Product content needs the CMS module, which provides the Page Builder:
|
|
90
|
+
|
|
91
|
+
- the product page shows **no** content, and the product API returns none — a
|
|
92
|
+
product whose only description was content shows no description tab;
|
|
93
|
+
- the admin cards keep showing which languages hold content, but offer no
|
|
94
|
+
**Edit content** link, and the content screen explains that no editor is
|
|
95
|
+
available. An operator without access to the CMS module sees the same;
|
|
96
|
+
- nothing stored is changed or deleted. Switching the CMS module back on brings
|
|
97
|
+
the content back on the product page and makes it editable again.
|
|
98
|
+
|
|
99
|
+
This is stricter than [category page content](./category-content.md), which
|
|
100
|
+
keeps rendering while the CMS module is off.
|
|
101
|
+
|
|
102
|
+
## Lifecycle
|
|
103
|
+
|
|
104
|
+
- **Duplicate** — the copy carries the same content.
|
|
105
|
+
- **Attribute set** — when a content attribute leaves the product's attribute
|
|
106
|
+
set, its content is kept but not offered: the card disappears, the content
|
|
107
|
+
screen answers *not available*, and the product page leaves it out. Adding the
|
|
108
|
+
attribute back brings it all back.
|
|
109
|
+
- **Product delete** — a deleted product's content stays stored with it, and is
|
|
110
|
+
unreachable from the admin, the API and the storefront. Assets embedded in it
|
|
111
|
+
are no longer reported as in use.
|
|
112
|
+
- **Attribute delete** — deleting a content attribute deletes its content on
|
|
113
|
+
every product. The delete confirmation says how many products carry content
|
|
114
|
+
first (see [Attributes](./attributes.md#deleting-an-attribute)).
|
|
115
|
+
- **Assets** — a library asset embedded in a product's content is reported as in
|
|
116
|
+
use by that product, so it cannot be deleted while the content holds it.
|
|
117
|
+
|
|
118
|
+
## What content does not take part in
|
|
119
|
+
|
|
120
|
+
Content attributes are deliberately left out of:
|
|
121
|
+
|
|
122
|
+
- values per sales channel or per channel language (the editor's Channel and
|
|
123
|
+
Channel × language scopes): the editor's save and the connectors' scoped write
|
|
124
|
+
refuse a content attribute's key;
|
|
125
|
+
- product export and import — export omits them, and a non-empty cell under a
|
|
126
|
+
content attribute's `attribute:<key>` column is refused for that cell
|
|
127
|
+
(`content_attribute`), the rest of the row being imported;
|
|
128
|
+
- the external (integration) API and PIM/ERP connectors, and the API-key read of
|
|
129
|
+
an attribute set;
|
|
130
|
+
- the products bulk editor;
|
|
131
|
+
- product feeds — neither as a feed field nor in a selection rule;
|
|
132
|
+
- storefront search, quick search and the admin product search;
|
|
133
|
+
- promotions, price lists, comparison and storefront filters;
|
|
134
|
+
- the product list, the search response and every other product read except
|
|
135
|
+
the product page's.
|
|
136
|
+
|
|
137
|
+
## For integrators
|
|
138
|
+
|
|
139
|
+
| Verb + Path | Audience | Purpose |
|
|
140
|
+
| --- | --- | --- |
|
|
141
|
+
| `GET /api/v1/catalog/products/:idOrSlug?include=content` | storefront | The product detail with `contentAttributes`: `[{ key, language, content }]`, each document resolved to the caller's language, in set order. Without `include` the response has no `contentAttributes` key. `include` accepts only `content` |
|
|
142
|
+
| `GET /api/v1/admin/catalog/products/:id/content` | admin (`catalog:read`) | The card list: `{ productId, attributeSetId, attributes: [{ attributeId, key, label, labelDefault, position, languages: [{ language, filled, blocks, excerpt }] }] }`. Summaries only, never documents |
|
|
143
|
+
| `GET /api/v1/admin/catalog/products/:id/content/:attributeKey` | admin (`catalog:read`) | One attribute's envelope: `{ productId, attributeKey, content }` with `content` = `{ languages: { "<code>": <document> } }` or `null` |
|
|
144
|
+
| `PUT /api/v1/admin/catalog/products/:id/content/:attributeKey` | admin (`catalog:write`) | Replaces the envelope; the body is `{ "content": <envelope> }`, and `{ "content": null }` clears it. Answers the stored, normalised value |
|
|
145
|
+
|
|
146
|
+
The envelope is the one a CMS page uses and is limited to 1 MiB (1 048 576
|
|
147
|
+
bytes) of JSON across all languages; a larger one is refused with
|
|
148
|
+
`400 VALIDATION_FAILED`. A key that is not a content attribute of the product's
|
|
149
|
+
current set is refused with `400 ATTRIBUTE_VALUE_REJECTED`. An unknown or deleted
|
|
150
|
+
product answers `404 PRODUCT_NOT_FOUND`. The `PUT` body is validated by the
|
|
151
|
+
handler, so the published OpenAPI document shows no request schema for it.
|
|
152
|
+
|
|
153
|
+
A content attribute's key is refused in `attributeValues` everywhere —
|
|
154
|
+
`POST`/`PATCH /api/v1/admin/catalog/products`, the API-key
|
|
155
|
+
`PUT /api/v1/catalog/products/by-sku/:sku` and the catalogue's write port — with
|
|
156
|
+
`400 ATTRIBUTE_VALUE_REJECTED`; content is written only through the route above.
|
|
157
|
+
|
|
158
|
+
Saving runs the `product.content.update` command — the audit entry records the
|
|
159
|
+
attribute and which languages the envelope carried, not the documents — and
|
|
160
|
+
emits `product.content.updated.v1`, on which the storefront's product cache is
|
|
161
|
+
flushed. It does not emit `product.updated.v1`, so a content save does not
|
|
162
|
+
re-index the product.
|
|
163
|
+
|
|
164
|
+
A connector that maps attribute types should skip `page_builder`: it is a value
|
|
165
|
+
type of `customFieldValueTypeSchema`, `attributeValueTypeSchema` and
|
|
166
|
+
`apiAttributeTypeSchema` in `@endora-commerce/contracts`, and none of the
|
|
167
|
+
integration paths carries it. The content schemas are
|
|
168
|
+
`productContentEnvelopeSchema`, `putProductContentRequestSchema`,
|
|
169
|
+
`adminProductContentSchema`, `adminProductContentListSchema` and
|
|
170
|
+
`productPageContentAttributeSchema`.
|
|
171
|
+
|
|
172
|
+
## Providing an editor
|
|
173
|
+
|
|
174
|
+
The content screen owns the document and no editor: it renders the admin zone
|
|
175
|
+
`product.content.editor` and saves what the zone reports. A module that owns a
|
|
176
|
+
Page Builder contributes a component there; its props are
|
|
177
|
+
`{ productId, attributeKey, language, data, onChange }`, where `data` is the
|
|
178
|
+
document to open and `onChange` reports every edit. The contributor never saves.
|
|
179
|
+
When nothing contributes, the card and the screen say that no editor is
|
|
180
|
+
available.
|