chore: Individual Pricing documentation#2133
chore: Individual Pricing documentation#2133Duy Dinh (silverDuy) wants to merge 13 commits intomainfrom
Conversation
Duy Dinh (silverDuy)
requested review from
Micha Hobert (Isengo1989) and
Duc Le Duc (leduc92)
There was a problem hiding this comment.
Pull request overview
Adds new documentation pages for the B2B “Individual Pricing” component, covering feature overview, core concepts (entities/workflow + pricing workflow), and developer extensibility points. Also updates the B2B Components landing page and the repository spellchecker wordlist to recognize newly introduced technical terms.
Changes:
- Introduce a new Individual Pricing documentation section with overview and conceptual docs.
- Add an extensibility guide describing relevant extensions, events, and message-bus messages.
- Update the B2B components index and extend
.wordlist.txtwith new domain terms.
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
products/extensions/b2b-components/individual-pricing/index.md |
New landing page describing Individual Pricing features, behavior, and links to deeper docs. |
products/extensions/b2b-components/individual-pricing/guides/01-extensibility-events-messages.md |
New guide documenting extension points and including a PHP subscriber example. |
products/extensions/b2b-components/individual-pricing/concepts/01-entities-and-workflow.md |
New concept doc describing entities, schema, and evaluation workflow. |
products/extensions/b2b-components/individual-pricing/concepts/02-pricing-workflow.md |
New concept doc detailing runtime resolution, caching/indexing, limitations, and performance considerations. |
products/extensions/b2b-components/index.md |
Adds Individual Pricing to the list of available B2B components. |
.wordlist.txt |
Adds new technical terms for the spell checker used by the docs. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
...ucts/extensions/b2b-components/individual-pricing/guides/01-extensibility-events-messages.md
Outdated
Show resolved
Hide resolved
products/extensions/b2b-components/individual-pricing/concepts/01-entities-and-workflow.md
Show resolved
Hide resolved
products/extensions/b2b-components/individual-pricing/concepts/02-pricing-workflow.md
Outdated
Show resolved
Hide resolved
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Micha Hobert (Isengo1989)
left a comment
Micha Hobert (Isengo1989)
left a comment
There was a problem hiding this comment.
Thx for the PR Duy Dinh (@silverDuy) - added some comments.
Please change the currency to appear after the number for greater precision (which is the official writing style)
€50 -> 50€
or best change it to be more international to $
€50 -> 50$
Micha Hobert (Isengo1989)
added
the
Undocumented Feature
Micha Hobert (@Isengo1989) Thank you for your suggestion, I changed it from €50 -> 50$ already. |
Duy Dinh (silverDuy)
requested review from
Micha Hobert (Isengo1989) and
Copilot
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 6 out of 6 changed files in this pull request and generated 7 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - Example: A product with 100$ original price but 80$ individual price sorts by 100$ | ||
| - **Price filtering**: Products may be incorrectly included or excluded from results | ||
| - Example: Filtering 50$-75$ might miss a 100$ product that costs 60$ with individual pricing | ||
| - Example: Filtering 50$-75$ might include a 50$ product that costs 85$ with individual pricing |
There was a problem hiding this comment.
The price examples use 100$, 80$, and ranges like 50$-75$. Consider switching to $100, $80, $50–$75 (or a currency-neutral format) to avoid ambiguity and keep formatting consistent with common conventions.
| - Example: A product with 100$ original price but 80$ individual price sorts by 100$ | |
| - **Price filtering**: Products may be incorrectly included or excluded from results | |
| - Example: Filtering 50$-75$ might miss a 100$ product that costs 60$ with individual pricing | |
| - Example: Filtering 50$-75$ might include a 50$ product that costs 85$ with individual pricing | |
| - Example: A product with $100 original price but $80 individual price sorts by $100 | |
| - **Price filtering**: Products may be incorrectly included or excluded from results | |
| - Example: Filtering $50–$75 might miss a $100 product that costs $60 with individual pricing | |
| - Example: Filtering $50–$75 might include a $50 product that costs $85 with individual pricing |
There was a problem hiding this comment.
Micha Hobert (@Isengo1989) What do you think about this suggestion? Will we keep it as 50$ or change it to $50? 🤔
products/extensions/b2b-components/individual-pricing/concepts/02-pricing-workflow.md
Outdated
Show resolved
Hide resolved
products/extensions/b2b-components/individual-pricing/concepts/02-pricing-workflow.md
Outdated
Show resolved
Hide resolved
| - `by_percent`: Reduce price by a percentage (e.g., 10% off) | ||
| - `by_fixed`: Reduce price by a fixed amount (e.g., 5$ off) | ||
| - `to_fixed`: Set price to a specific amount (e.g., 99.99$) | ||
| - `volume_pricing`: Use tiered pricing based on quantity | ||
|
|
||
| ### Individual Pricing Tier | ||
|
|
||
| The tier entity defines volume-based pricing tiers for quantity discounts. Multiple tiers can be associated with a single Individual Pricing rule when the action type is set to `volume_pricing`. | ||
|
|
||
| **Key properties:** | ||
|
|
||
| - **individualPricingId**: Reference to the parent pricing rule | ||
| - **qtyFrom**: Minimum quantity for this tier (inclusive) | ||
| - **qtyTo**: Maximum quantity for this tier (inclusive, null for unlimited) | ||
| - **price**: Price collection containing prices for different currencies | ||
|
|
||
| **Example tiers:** | ||
|
|
||
| - Tier 1: 1-9 units @ 10$ each | ||
| - Tier 2: 10-49 units @ 9$ each | ||
| - Tier 3: 50+ units @ 8$ each |
There was a problem hiding this comment.
The examples use currency formatting like 5$, 99.99$, and 10$ each, which is atypical and can be misread. Consider switching to $5, $99.99, $10 (or using a currency-agnostic example) for clarity and consistency throughout the docs.
products/extensions/b2b-components/individual-pricing/concepts/01-entities-and-workflow.md
Outdated
Show resolved
Hide resolved
…/01-entities-and-workflow.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…/02-pricing-workflow.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
No description provided.