Skip to content

Doc for Quable PIM#399

Merged
mnocon merged 17 commits intorelease-5.0.7from
quable-pim
Apr 14, 2026
Merged

Doc for Quable PIM#399
mnocon merged 17 commits intorelease-5.0.7from
quable-pim

Conversation

@mnocon
Copy link
Copy Markdown
Contributor

@mnocon mnocon commented Mar 30, 2026

Added documentation for Quable PIM

Things done:

  1. Renamed PIM usages to Product Catalog
  2. Described how to work with Quable products and categories
  3. Described embedding products in content
  4. Described product embed block

Most important pages:

@mnocon mnocon marked this pull request as ready for review March 31, 2026 11:56

Due to a technical limitation, content browser doesn't display product variants.
- **Name** – Enter a name for the page block.
- **Product code** — Enter the product code and click **Add** or click **Select products**. Then, select products, and click **Confirm**.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The label says "Select products" (even though it's single select)

It lets you navigate the content tree, and, for example, create, edit, move, copy, or delete content.
- [[% include 'snippets/experience_badge.md' %]] [[% include 'snippets/commerce_badge.md' %]] **Site management**, which enables you to create and edit block-based pages and manage multiple websites.
- **PIM**, which enables you to handle products presented on the website, including their specifications and pricing.
- **Product catalog**, which enables you to handle products presented on the website, including their specifications and pricing.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The UI says Product catalog, I've checked this

Comment thread docs/pim/pim.md Outdated
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Renamed to product_catalog/product_catalog.md

- Symbol - value of product's symbol attribute

If the default list of attributes is not sufficient, ask your development team to [create a custom attribute type]([[= developer_doc =]]/pim/create_custom_attribute_type/).
If the default list of attributes is not sufficient, ask your development team to [create a custom attribute type]([[= developer_doc =]]/product_catalog/create_custom_attribute_type/).
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Renamed in dev doc PR


- **Name** – Enter a name for the page block.
- **Product list** — Create a list of products. Enter a comma-separated list of product/variant codes and click **Add** or click **Select product**. Then, in content browser, select products, and click **Confirm**.
- **Product list** — Create a list of products. Enter a comma-separated list of product codes and click **Add** or click **Select products**. Then, select products, and click **Confirm**.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence seems weird. First, simple option, is completely contained within the sentence. Product selection "overflows" into another statement.

Suggested change
- **Product list** — Create a list of products. Enter a comma-separated list of product codes and click **Add** or click **Select products**. Then, select products, and click **Confirm**.
- **Product list** — Create a list of products. Enter a comma-separated list of product codes and click **Add**, or click **Select products**. Then, select products, and click **Confirm**.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, used Tomek's suggestion: #399 (comment)

@mnocon mnocon requested a review from a team April 3, 2026 07:52
@ibexa-workflow-automation-1 ibexa-workflow-automation-1 bot requested review from adriendupuis, dabrt and julitafalcondusza and removed request for a team April 3, 2026 07:53
Comment thread docs/content_management/block_reference.md Outdated
Comment thread docs/content_management/block_reference.md Outdated
Comment thread docs/content_management/block_reference.md Outdated
Comment thread docs/content_management/block_reference.md Outdated
Comment thread docs/content_management/block_reference.md Outdated
Comment thread docs/product_catalog/quable_pim_integration.md Outdated

# Quable PIM integration

[[= product_name =]] integrates with [[[= pim_product_name =]]](https://www.quable.com/en) as an external Product Information Management (PIM) source.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

as an external Product Information Management (PIM) source -> as an external product information source (PIM)

Copy link
Copy Markdown
Contributor Author

@mnocon mnocon Apr 9, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure if you've skipped "management" on purpose (it feels weird to not use the full name before abbreviation), for now I've changed to:

as an external product information management (PIM) source.

but I'm ok with changing it further if needed

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've put the abbreviation in a wrong place, I meant "product information source (PIM)". It sounded odd to me to have a source of management.

Comment thread docs/product_catalog/quable_pim_integration.md Outdated

!!! note "Quable PIM integration"

When [Quable is configured as the product catalog source](quable_pim_integration.md), creating and editing products in [[= product_name =]] is not available.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When [Quable is configured as the product catalog source](quable_pim_integration.md), creating and editing products in [[= product_name =]] is not available.
When [Quable is configured as the source of product information](quable_pim_integration.md), creating and editing products in [[= product_name =]] is not available.

information or data

The same applies to other iterations of the same disclaimer. This way the "product catalog" even more refers to "our" product catalog.

Comment thread docs/product_catalog/work_with_product_categories.md Outdated
Comment thread docs/content_management/block_reference.md
mnocon and others added 5 commits April 9, 2026 16:32
Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>
Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>
@dabrt dabrt self-requested a review April 14, 2026 07:57
@sonarqubecloud
Copy link
Copy Markdown

@mnocon mnocon changed the base branch from 5.0 to release-5.0.7 April 14, 2026 10:42
@mnocon mnocon merged commit c3d823d into release-5.0.7 Apr 14, 2026
7 checks passed
@mnocon mnocon deleted the quable-pim branch April 14, 2026 10:42
@mnocon mnocon mentioned this pull request Apr 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants