IBX-111154: New recommendations blocks described

docs/recommendations/raptor_integration/custom_recommendation_rendering.md

@@ -30,6 +30,9 @@ Any other required parameters are specific to each controller and are detailed i
 |Block name| Controller                                                                                  |Parameters|Recommendation item type|
 |----------|---------------------------------------------------------------------------------------------|----------|------------------------|
 |[Content that have been seen along with the item category]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#content-that-has-been-seen-along-with-the-item-category-block)| <nobr>`ContentBasedOnProductCategoryBlockController`</nobr><br><nobr>`::showAction()`</nobr> |<nobr>`categoryId` (integer),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Content|
+|[Items associated with the given Content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#items-associated-with-the-given-content-block)| <nobr>`ItemsBasedOnContentBlockController::showAction`</nobr><br><nobr>`::showAction()`</nobr> |<nobr>`contentId` (integer),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
+|[Items of Customized Feeds sorted by personal preferences and popularity or trendiness]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#items-of-customized-feeds-sorted-by-personal-preferences-and-popularity-or-trendiness)| <nobr>`MerchandisingItemsBlockController`</nobr><br><nobr>`::showAction()`</nobr> |<nobr>`feedId` (integer),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
+|[Merchandising content sorted by personal preferences and popularity]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#merchandising-content-sorted-by-personal-preferences-and-popularity)| <nobr>`MerchandisingContentBlockController`</nobr><br><nobr>`::showAction()`</nobr> |<nobr>`feedId` (integer),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Content|
 |[Most popular content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-content-block)| <nobr>`PopularContentBlockController`</nobr><br><nobr>`::showAction()`</nobr>                                  |<nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Content|
 |[Most popular products]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-products-block)| <nobr>`PopularItemsBlockController`</nobr><br><nobr>`::showAction()`</nobr>                                    |<nobr>`showInStock` (boolean),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
 |[Most popular products in category]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-products-in-category-block)| <nobr>`PopularItemsInCategoryBlockController`</nobr><br><nobr>`::showAction()`</nobr>                          |<nobr>`categoryId` (integer),</nobr><br><nobr>`showInStock` (boolean),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
@@ -38,6 +41,8 @@ Any other required parameters are specific to each controller and are detailed i
 |[Other Customers Have also Purchased block]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#other-customers-have-also-purchased-block)| <nobr>`OtherCustomersAlsoPurchasedBlockController`</nobr><br><nobr>`::showAction()`</nobr>                     |<nobr>`productCode` (string),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
 |[Personalized content recommendations]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#personalized-content-recommendations-block)| <nobr>`UserContentRecommendationsBlockController`</nobr><br><nobr>`::showAction()`</nobr>                      |<nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Content|
 |[The Personal Shopping Assistant]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#the-personal-shopping-assistant-block)| <nobr>`UserItemRecommendationsBlockController`</nobr><br><nobr>`::showAction()`</nobr>                         |<nobr>`productCode` (string),</nobr><br><nobr>`showInStock` (boolean),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
+|[The Personal Shopping Assistant (additional sales)]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#the-personal-shopping-assistant-additional-sales-block)| <nobr>`UserCrossSellingBlockController`</nobr><br><nobr>`::showAction()`</nobr>                         |<nobr>`showInStock` (boolean),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
+|[The Personal Shopping Assistant (conversion)]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#the-personal-shopping-assistant-conversion-block)| <nobr>`UserCrossSellingBlockController`</nobr><br><nobr>`::showAction()`</nobr>                         |<nobr>`showInStock` (boolean),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
 |[User's item history]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#users-item-history-block)| <nobr>`UserItemHistoryBlockController`</nobr><br><nobr>`::showAction()`</nobr>                                 |<nobr>`showInStock` (boolean),</nobr><br><nobr>`limit` (integer),</nobr><br><nobr>`template` (string)</nobr>|Product|
 
 Each template receives a `recommendations` Twig variable, which is a list with either [`Ibexa\Contracts\ProductCatalog\Values\ProductInterface`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-ProductCatalog-Values-ProductInterface.html) instances for product recommendations or [`Ibexa\Contracts\Core\Repository\Values\Content\Content`](/api/php_api/php_api_reference/classes/Ibexa-Contracts-Core-Repository-Values-Content-Content.html) instances for content recommendations.

docs/recommendations/raptor_integration/raptor_connector_guide.md

@@ -65,12 +65,14 @@ Recommendation blocks are organized into dedicated categories, each grouping blo
 
 - **Recommendations: Content** - presents content recommendations:
     - [Content that has been seen along with the item category]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#content-that-has-been-seen-along-with-the-item-category-block)
+    - [Merchandising content sorted by personal preferences and popularity]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#merchandising-content-sorted-by-personal-preferences-and-popularity)
     - [Most popular content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-content-block)
     - [Other customers have also seen this content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#other-customers-have-also-seen-this-content-block)
     - [Personalized content recommendations]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#personalized-content-recommendations-block)
     - [User’s content history]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#users-content-history-block)
 - **Recommendations: Product** - displays product suggestions based on visitors’ browsing history:
     - [Items associated with the given Content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#items-associated-with-the-given-content-block)
+    - [Items of Customized Feeds sorted by personal preferences and popularity or trendiness]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#items-of-customized-feeds-sorted-by-personal-preferences-and-popularity-or-trendiness)
     - [Most popular products]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-products-block)
     - [Most popular products in category]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-products-in-category-block)
     - [Other customers have also seen]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#other-customers-have-also-seen-block)

docs/recommendations/raptor_integration/recommendation_blocks.md

@@ -20,12 +20,14 @@ In the toolbar, corresponding categories for recommendation blocks are available
 
 - **Recommendations: Content** - presents content recommendations:
     - [Content that has been seen along with the item category]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#content-that-has-been-seen-along-with-the-item-category-block)
+    - [Merchandising content sorted by personal preferences and popularity]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#merchandising-content-sorted-by-personal-preferences-and-popularity)
     - [Most popular content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-content-block)
     - [Other customers have also seen this content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#other-customers-have-also-seen-this-content-block)
     - [Personalized content recommendations]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#personalized-content-recommendations-block)
     - [User’s content history]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#users-content-history-block)
 - **Recommendations: Product** - displays product suggestions based on visitors’ browsing history:
     - [Items associated with the given Content]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#items-associated-with-the-given-content-block)
+    - [Items of Customized Feeds sorted by personal preferences and popularity or trendiness]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#items-of-customized-feeds-sorted-by-personal-preferences-and-popularity-or-trendiness)
     - [Most popular products]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-products-block)
     - [Most popular products in category]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#most-popular-products-in-category-block)
     - [Other customers have also seen]([[= user_doc =]]/recommendations/raptor_integration/raptor_recommendation_blocks/#other-customers-have-also-seen-block)
@@ -38,7 +40,11 @@ In the toolbar, corresponding categories for recommendation blocks are available
 
 ![Recommendation blocks](img/recommendation_blocks.png)
 
-After opening the settings of a recommendation block, a link is available at the bottom of the window.
+After opening the settings of a recommendation block, you can click the info icon on the right side to display a tooltip with basic information about selected recommendation strategy.
+
+![Tooltip](img/tooltip.png)
+
+Also, a link is available at the bottom of the window.
 It leads to the [Raptor Control Panel](https://controlpanel.raptorsmartadvisor.com/) (opens in a separate tab), where you can configure advanced settings and fine-tune the recommendation strategy.
 
 ![Advanced settings](img/advanced_settings.png)