Conversation
There was a problem hiding this comment.
month_change: true missing in several pages.
When moving from local to Quable:
- Can I use the local and the Quable PIM at the same time?
- How do I handle purchases without carts and orders?
- What happens to taxonomy tree(s) precisely?
- What are the product search criteria and sort clauses I'll have to stop using?
Some old pages could mention Quable
- Product catalog configuration could mention
quableas another possible value fortype. - Product search references could indicate what is supported by Quable.
| description: Quable PIM connector configuration reference for Ibexa DXP | ||
| page_type: reference |
There was a problem hiding this comment.
| description: Quable PIM connector configuration reference for Ibexa DXP | |
| page_type: reference | |
| description: Quable PIM connector configuration reference for Ibexa DXP | |
| page_type: reference | |
| month_change: true |
| @@ -0,0 +1,170 @@ | |||
| --- | |||
| description: Install and configure Quable PIM connector for Ibexa DXP | |||
There was a problem hiding this comment.
| description: Install and configure Quable PIM connector for Ibexa DXP | |
| description: Install and configure Quable PIM connector for Ibexa DXP | |
| month_change: true |
| description: Quable PIM integration with Ibexa DXP | ||
| page_type: landing_page |
There was a problem hiding this comment.
| description: Quable PIM integration with Ibexa DXP | |
| page_type: landing_page | |
| description: Quable PIM integration with Ibexa DXP | |
| page_type: landing_page | |
| month_change: true |
| description: The Quable product guide describes how you can use the product data from Quable in Ibexa DXP to create marketing campaigns built around your products. | ||
| month_change: false |
There was a problem hiding this comment.
| description: The Quable product guide describes how you can use the product data from Quable in Ibexa DXP to create marketing campaigns built around your products. | |
| month_change: false | |
| description: The Quable product guide describes how you can use the product data from Quable in Ibexa DXP to create marketing campaigns built around your products. | |
| month_change: true |
There was a problem hiding this comment.
There is probably more missing month_change: truethan those abvious ones.
|
|
||
| You can use [[= product_name =]] to manage product availability and pricing for [[= pim_product_name =]]'s products, including creating advanced pricing strategies with [discounts](discounts.md) combined with [regions](product_catalog_guide.md#regions) and [currencies](product_catalog_guide.md#currencies). | ||
|
|
||
| ## Known limitations |
There was a problem hiding this comment.
I feel like this isn't the place for this section as it get a bit too technical and detailed for a guide. But I see know better place.
As limitation to the capabilities, I would "hide" it a bit under this section.
| ## Known limitations | |
| ### Known limitations |
Or even move it down after Use cases?
There was a problem hiding this comment.
Moved down after use cases 👍
| |[ProductName](productname_sort_clause.md)|Product's name| | ||
|
|
||
|
|
||
| ### Manage stock and pricing |
There was a problem hiding this comment.
| |[ProductName](productname_sort_clause.md)|Product's name| | |
| ### Manage stock and pricing | |
| |[ProductName](productname_sort_clause.md)|Product's name| | |
| ### Manage stock and pricing |
| description: Ibexa DXP provides product catalog capabilities for managing products, product types, variants, attributes, pricing, and catalogs. | ||
| page_type: landing_page |
There was a problem hiding this comment.
This introduction to the total revamp of what was PIM (https://doc.ibexa.co/en/5.0/pim/pim/) worth being labeled as new.
| description: Ibexa DXP provides product catalog capabilities for managing products, product types, variants, attributes, pricing, and catalogs. | |
| page_type: landing_page | |
| description: Ibexa DXP provides product catalog capabilities for managing products, product types, variants, attributes, pricing, and catalogs. | |
| page_type: landing_page | |
| month_change: true |
I like this new https://ez-systems-developer-documentation--3085.com.readthedocs.build/en/3085/product_catalog/product_catalog/ by the way.
| ### `ibexa_format_product_attribute` | ||
|
|
||
| The `ibexa_format_product_attribute` filter formats the attribute value to a readable, translated form. | ||
| Rendering is performed using a configurable list of Twig templates with named blocks. |
There was a problem hiding this comment.
| Rendering is performed using a configurable list of Twig templates with named blocks. | |
| Rendering is performed by using a configurable list of Twig templates with named blocks. |
"Rendering is performed by using a configurable list of templates..." or rather "Rendering is performed by using templates from a configurable list..." ?
There was a problem hiding this comment.
Changed to:
Rendering is performed by using Twig templates with named blocks, defined in a configurable list.
| <li><a href="pim/catalogs/">Catalogs</a></li> | ||
| <li><a href="pim/prices/">Prices</a></li> | ||
| <li><a href="product_catalog/product_catalog_configuration/">Product catalog configuration</a></li> | ||
| <li><a href="product_catalog/quable_integration/">Quable PIM Integration</a></li> |
There was a problem hiding this comment.
| <li><a href="product_catalog/quable_integration/">Quable PIM Integration</a></li> | |
| <li><a href="product_catalog/quable_integration/">Quable PIM Integration add-on</a></li> |
Will we add Raptor to the index page as well?
There was a problem hiding this comment.
Let's discuss this after the release - it's a good idea
Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>
Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>
Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>
Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com>
| | `webhook_secret` | string | Secret expected in the [webhook](https://docs.quable.com/v5-EN/docs/webhook) authorization header. | | ||
| | <nobr>`throw_on_invalid_criteria`</nobr> | <nobr>`%kernel.debug%`</nobr> | Controls behavior for unsupported search criteria: `true` throws an exception, `false` only logs unsupported criteria. | | ||
| | <nobr>`throw_on_invalid_mapping`</nobr> | <nobr>`%kernel.debug%`</nobr> | Controls behavior for mapping errors during data transformation: `true` throws an exception, `false` only logs mapping errors. | | ||
| | `cache.enabled` | `true` | Global cache switch for the connector. When set to `false`, cache decorators use only [in-memory cache](persistence_cache.md#in-memory-cache-configuration). | |
There was a problem hiding this comment.
| | `cache.enabled` | `true` | Global cache switch for the connector. When set to `false`, cache decorators use only [in-memory cache](persistence_cache.md#in-memory-cache-configuration). | | |
| | `cache.enabled` | `true` | Global cache switch for the connector. When set to `false`, only [in-memory cache](persistence_cache.md#in-memory-cache-configuration) is used. | |
Also, I'd like to note that we are using cache.app.taggable (so indirectly cache.app) to create caching services, which means we are using the cache that is declared for Symfony framework. See https://symfony.com/doc/current/cache.html#system-cache-and-application-cache
cache.appis a general-purpose data cache for application and bundle code. Data in this pool does not need to be flushed on deployment. It defaults tocache.adapter.filesystem, but configuring a faster adapter like Redis is recommended when available (this ensures cached data survives deployments and is shared across multiple instances in a multi-server setup).
There was a problem hiding this comment.
Added as:
When set to
true, [Symfony'scache.appcache pool]([[= symfony_doc =]]/cache.html#system-cache-and-application-cache) is used.
linking to https://symfony.com/doc/current/cache.html#system-cache-and-application-cache
| product_type_group_identifier: product | ||
| ``` | ||
|
|
||
| This configuration defines two engines: the default `local` engine and the new `quable` engine, allowing you to work with products defined within [[= pim_product_name =]]. |
There was a problem hiding this comment.
Siteaccess cannot use both at the same time. Two repositories would be needed. It is one-or-the-other.
| - [Catalogs](product_catalog_guide.md#catalogs) can't be created from [[= pim_product_name =]] products. | ||
| - Product assets are not fully synchronized. Only the main asset thumbnail URL from [[= pim_product_name =]] is used. | ||
| - [Product-level access restrictions](policies.md#products) based on product type are not supported. | ||
| - Products with unsupported identifiers (containing `/` or exceeding 64 characters) are not synchronized. |
There was a problem hiding this comment.
That's not exactly true.
If product contains / or it's identifier is longer than 64 characters, then certain "attachments" (availability, price management) won't work for it due to our arbitrary limitations (which might / are likely to be changed in upcoming versions).
| - Products with unsupported identifiers (containing `/` or exceeding 64 characters) are not synchronized. |
There was a problem hiding this comment.
Changed to:
- You can't define prices and availability for products with product codes exceeding 64 characters.
As discussed on Slack
Co-authored-by: Paweł Niedzielski <pawel.tadeusz.niedzielski@gmail.com>
* Added doc for language configuration * Apply suggestion from @mnocon
|
code_samples/ change report
|



Documentation for the upcoming Quable connector.
Most important changes:
ibexa_quable_instance_url