From 4131b2112f3f39a41ec06a66cd419bd04382ffb4 Mon Sep 17 00:00:00 2001 From: Bruce Denham Date: Thu, 11 Dec 2025 17:19:24 -0600 Subject: [PATCH 1/2] feat: Add Purchase Order merchant blocks (13 blocks) All purchase order related merchant blocks. Fixed placeholder paths to use @images alias for base path resolution. Base: releases/b2b-nov-release --- .../blocks/commerce-b2b-po-approval-flow.mdx | 60 +++++++++++++ .../commerce-b2b-po-approval-rule-details.mdx | 60 +++++++++++++ .../commerce-b2b-po-approval-rule-form.mdx | 60 +++++++++++++ .../commerce-b2b-po-approval-rules-list.mdx | 84 +++++++++++++++++++ .../commerce-b2b-po-checkout-success.mdx | 60 +++++++++++++ .../blocks/commerce-b2b-po-comment-form.mdx | 60 +++++++++++++ .../blocks/commerce-b2b-po-comments-list.mdx | 60 +++++++++++++ ...ommerce-b2b-po-company-purchase-orders.mdx | 84 +++++++++++++++++++ ...mmerce-b2b-po-customer-purchase-orders.mdx | 84 +++++++++++++++++++ .../blocks/commerce-b2b-po-header.mdx | 60 +++++++++++++ .../blocks/commerce-b2b-po-history-log.mdx | 60 +++++++++++++ ...2b-po-require-approval-purchase-orders.mdx | 84 +++++++++++++++++++ .../blocks/commerce-b2b-po-status.mdx | 60 +++++++++++++ 13 files changed, 876 insertions(+) create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-approval-flow.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-details.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-form.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-approval-rules-list.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-checkout-success.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-comment-form.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-comments-list.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-company-purchase-orders.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-customer-purchase-orders.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-header.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-history-log.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx create mode 100644 src/content/docs/merchants/blocks/commerce-b2b-po-status.mdx diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-approval-flow.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-flow.mdx new file mode 100644 index 000000000..b12ed3154 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-flow.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Approval Flow" +description: Users view workflow status and who approved or rejected orders through this block. Place it on purchase order detail pages. +sidebar: + label: "PO Approval Flow" +--- + +import Diagram from '@components/Diagram.astro'; + +Users view workflow status and who approved or rejected orders through this block. Place it on purchase order detail pages. + + + ![Purchase Order Approval Flow block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-details.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-details.mdx new file mode 100644 index 000000000..2b4135845 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-details.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Approval Rule Details" +description: Administrators review rule conditions and approval requirements through this block. Place it on approval rule detail pages. +sidebar: + label: "PO Approval Rule Details" +--- + +import Diagram from '@components/Diagram.astro'; + +Administrators review rule conditions and approval requirements through this block. Place it on approval rule detail pages. + + + ![Purchase Order Approval Rule Details block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-form.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-form.mdx new file mode 100644 index 000000000..7b95d0072 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rule-form.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Approval Rule Form" +description: Administrators create spending limits and set approval hierarchies through this block. Place it on create approval rule pages. +sidebar: + label: "PO Approval Rule Form" +--- + +import Diagram from '@components/Diagram.astro'; + +Administrators create spending limits and set approval hierarchies through this block. Place it on create approval rule pages. + + + ![Purchase Order Approval Rule Form block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rules-list.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rules-list.mdx new file mode 100644 index 000000000..78798014e --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-approval-rules-list.mdx @@ -0,0 +1,84 @@ +--- +title: "Purchase Order Approval Rules List" +description: Administrators view all approval rules and which orders they affect through this block. Place it on approval rules pages. +sidebar: + label: "PO Approval Rules List" +--- + +import Diagram from '@components/Diagram.astro'; + +Administrators view all approval rules and which orders they affect through this block. Place it on approval rules pages. + + + ![Purchase Order Approval Rules List block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Page metadata + +Configure page-level metadata in the document authoring table below: + + + + + + + + + + + + + + + + + + + +
metadata
TitleApproval Rules
Robotsnoindex, nofollow
Cache Controlno-store
+ +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-checkout-success.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-checkout-success.mdx new file mode 100644 index 000000000..69ec4ddda --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-checkout-success.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Checkout Success" +description: Buyers receive purchase order confirmation and order numbers through this block. Place it on purchase order confirmation pages. +sidebar: + label: "PO Checkout Success" +--- + +import Diagram from '@components/Diagram.astro'; + +Buyers receive purchase order confirmation and order numbers through this block. Place it on purchase order confirmation pages. + + + ![Purchase Order Checkout Success block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-comment-form.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-comment-form.mdx new file mode 100644 index 000000000..9fb23f373 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-comment-form.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Comment Form" +description: Team members communicate about orders and document decisions through this block. Place it on purchase order detail pages. +sidebar: + label: "PO Comment Form" +--- + +import Diagram from '@components/Diagram.astro'; + +Team members communicate about orders and document decisions through this block. Place it on purchase order detail pages. + + + ![Purchase Order Comment Form block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-comments-list.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-comments-list.mdx new file mode 100644 index 000000000..1e87590ed --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-comments-list.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Comments List" +description: Team members view order discussions and approval reasons through this block. Place it on purchase order detail pages. +sidebar: + label: "PO Comments List" +--- + +import Diagram from '@components/Diagram.astro'; + +Team members view order discussions and approval reasons through this block. Place it on purchase order detail pages. + + + ![Purchase Order Comments List block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-company-purchase-orders.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-company-purchase-orders.mdx new file mode 100644 index 000000000..a5a762eb3 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-company-purchase-orders.mdx @@ -0,0 +1,84 @@ +--- +title: "Company Purchase Orders" +description: Managers monitor all company spending and track pending approvals through this block. Place it on company purchase orders pages. +sidebar: + label: "Company POs" +--- + +import Diagram from '@components/Diagram.astro'; + +Managers monitor all company spending and track pending approvals through this block. Place it on company purchase orders pages. + + + ![Company Purchase Orders block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Page metadata + +Configure page-level metadata in the document authoring table below: + + + + + + + + + + + + + + + + + + + +
metadata
TitlePurchase Orders
Robotsnoindex, nofollow
Cache Controlno-store
+ +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-customer-purchase-orders.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-customer-purchase-orders.mdx new file mode 100644 index 000000000..1456437d2 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-customer-purchase-orders.mdx @@ -0,0 +1,84 @@ +--- +title: "Customer Purchase Orders" +description: Buyers track their own purchase orders and monitor approval status through this block. Place it on my purchase orders pages. +sidebar: + label: "Customer POs" +--- + +import Diagram from '@components/Diagram.astro'; + +Buyers track their own purchase orders and monitor approval status through this block. Place it on my purchase orders pages. + + + ![Customer Purchase Orders block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Page metadata + +Configure page-level metadata in the document authoring table below: + + + + + + + + + + + + + + + + + + + +
metadata
TitleMy Purchase Orders
Robotsnoindex, nofollow
Cache Controlno-store
+ +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-header.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-header.mdx new file mode 100644 index 000000000..8faae6f20 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-header.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Header" +description: Users navigate purchase order details with contextual page headers through this block. Place it at the top of purchase order pages. +sidebar: + label: "PO Header" +--- + +import Diagram from '@components/Diagram.astro'; + +Users navigate purchase order details with contextual page headers through this block. Place it at the top of purchase order pages. + + + ![Purchase Order Header block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-history-log.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-history-log.mdx new file mode 100644 index 000000000..297d99bb8 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-history-log.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order History Log" +description: Users view audit trails showing who approved orders and when actions occurred through this block. Place it on purchase order detail pages. +sidebar: + label: "PO History Log" +--- + +import Diagram from '@components/Diagram.astro'; + +Users view audit trails showing who approved orders and when actions occurred through this block. Place it on purchase order detail pages. + + + ![Purchase Order History Log block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx new file mode 100644 index 000000000..4d375407f --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx @@ -0,0 +1,84 @@ +--- +title: "Purchase Orders Requiring Approval" +description: Approvers see orders awaiting their review and prioritize approval processing through this block. Place it on orders for approval pages. +sidebar: + label: "POs Requiring Approval" +--- + +import Diagram from '@components/Diagram.astro'; + +Approvers see orders awaiting their review and prioritize approval processing through this block. Place it on orders for approval pages. + + + ![Purchase Orders Requiring Approvalblock.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Page metadata + +Configure page-level metadata in the document authoring table below: + + + + + + + + + + + + + + + + + + + +
metadata
TitleRequires My Approval
Robotsnoindex, nofollow
Cache Controlno-store
+ +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-status.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-status.mdx new file mode 100644 index 000000000..78f272506 --- /dev/null +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-status.mdx @@ -0,0 +1,60 @@ +--- +title: "Purchase Order Status" +description: Users view order status and take actions like approve, reject, or cancel through this block. Place it on purchase order detail pages. +sidebar: + label: "PO Status" +--- + +import Diagram from '@components/Diagram.astro'; + +Users view order status and take actions like approve, reject, or cancel through this block. Place it on purchase order detail pages. + + + ![Purchase Order Status block.](@images/placeholder.webp) + + + +## Requirements + +Customers must log in to access this block. Enable company features in **Stores** > **Configuration** > **General** > **B2B Features** > **Enable Company**. Purchase orders are then configured per company. + +## Configuration + +No configurations available for this block. + +## Section metadata + +Control the section styling, spacing, and layout that wraps your commerce block. All properties are optional: + + + + + + + + + + + + + + + + + + + + + + + + + + + +
section-metadata
Stylehighlight (optional)
Paddingmedium (optional)
Marginsmall (optional)
Column Width30% (optional)
Gapsmall (optional)
+ +
+Learn more: See the Section Metadata guide for all available values and the Page Metadata guide for SEO and caching options. +
+ From 00ab5a0166d6e62c204c8016555d2c8a5093c411 Mon Sep 17 00:00:00 2001 From: Kevin Harper Date: Fri, 9 Jan 2026 12:29:24 -0600 Subject: [PATCH 2/2] Review feedback --- .../blocks/commerce-b2b-po-require-approval-purchase-orders.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx b/src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx index 4d375407f..36adb81b6 100644 --- a/src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx +++ b/src/content/docs/merchants/blocks/commerce-b2b-po-require-approval-purchase-orders.mdx @@ -10,7 +10,7 @@ import Diagram from '@components/Diagram.astro'; Approvers see orders awaiting their review and prioritize approval processing through this block. Place it on orders for approval pages. - ![Purchase Orders Requiring Approvalblock.](@images/placeholder.webp) + ![Purchase Orders Requiring Approval block.](@images/placeholder.webp)