Review the following aspects on the e-shop in order to confirm and validate that the default features have been successfully integrated on the Shopware 6 platform.
...
3. Click Enter to load the new URL.
4. If the view stayed the same - there is no API request on the page
| Warning |
|---|
In the case that there is API request on the page and no content loaded - contact the IT team. In the case that there is no API request on the page and it should be - contact the IT team. |
...
Any page view
Search requests
Category view
A product is added to basket
Scrolling on the page (due to the HTML tags) https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/295141377/JS+Tracker+Check-List#Check-the-scrollImpression-tracking%3A
Click on items/elements on the page (due to HTML tags) https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/295141377/JS+Tracker+Check-List#Check-the-click-tracking%3A
A order is made
A customer logs in
...
The tracking is disabled from your Shopware 6 configuration (Read more about Configurations https://github.com/boxalino/rtux-shopware/wiki/Configurations )
The analytics template is ignored ( make sure the plugins are enabled & active, clear cache on dev templates). The integration team is able to inspect directly on the project.
Autocomplete (JavaScript Client-Side)
...
This can happen when the theme is not compiled (the integration is a JavaScript update).
The integration team is able to address this directly on the project.
When the template is broken
...
Review the API request / response by appending
_bx_inspect_key=<apiKey>to the URL (ex:<e-shop>/search?search=<keyword>&_bx_inspect_key=<apiKey>&_bx_rtux_cache_key=<any-content>)Observe that any selected filter appears in the URL with it`s own name-value (opposing to Shopware6 default that uses hash of ids)
The scrolling events are tracked in the “Network” tab
We recommend to have cache disabled on the pages/flows where it is expected Boxalino content.
...
When there is no API request
If there is no change on the page when inspecting via the _bx_inspect_key - it means the search functionality is not integrated with Boxalino.
The integration team is able to inspect directly on the project:
Enable “test mode” and review the server logs.
Review the controller from
<integration module>/src/Storefront/Controller/SearchControllerhttps://github.com/boxalino/rtux-integration-shopware/wiki/Search-ContextClear cache
...
This is normal if the integration team chose to use the server-side integration.
(if it is not #1) review the required Template Updates https://github.com/boxalino/rtux-integration-shopware/wiki/PDP-Context-(AJAX)#5-theme-template-updates in order to switch to the asynchronous integration.
(if it is not #1) view the uncached product page by adding a random parameter in the URL (add
`?<any-value-after-product-link>). Switch to “test mode” and review server logs. Fix or communicate identified errors if it`s in the scope of Boxalino.Clear cache. The integration team is able to inspect directly on their project.
When there are no recommendations displayed
...
Invalid optimization rule in Boxalino Intelligence Admin
Invalid API request
Category View (navigation)
The category is replaced with the help of the CMS Element CMS Element (for Shopping Experiences) Before continuing with the review, confirm that there is an updated layout in use that has a Boxalino CMS Element configured (ex: widget navigation)
Review the category page with the help of the
_bx_inspect_key=<apiKey>Observe that any selected filter appears in the URL with it`s own name-value (opposing to Shopware6 default that uses hash of ids)
The scrolling events are tracked in the “Network” tab https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/295141377/JS+Tracker+Check-List#Check-the-scrollImpression-tracking%3A
When there is no API request
If there is no change on the page when inspecting via the _bx_inspect_key - it means the CMS element is not included in the Category layout or there is a caching issue.
The integration team is able to inspect directly on their project.
When there are no products displayed
Review the steps from Search https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/877789187/Testing+the+SW6+Integration#When-there-are-no-products-displayed
When the page is cached
After Shopware 6.4, there is an internal framework layer of cache.
In order to avoid for certain contexts & pages integrated with Boxalino to be cached:
review that the cache invalidator subscribers are part of the integration https://github.com/boxalino/rtux-integration-shopware/blob/3.4.0/src/Resources/config/services/api/cms.xml#L36
update the config shopware.yml.
| Code Block |
|---|
shopware: cache: invalidation: category_route: ["cms-block-navigation-boxalino-api"] |
When the Boxalino CMS Element is not visible
The CMS element is added like any other backend Shopware 5 CMS block https://developer.shopware.com/docs/guides/plugins/plugins/content/cms/add-cms-block .
In case it is missing, please check that:
The module is installed & active
The backend theme has been compiled (review SW6 documentation)
Clear cache
Homepage Sliders (cms)
The sliders are added on the homepage with the help of the CMS Element CMS Element (for Shopping Experiences) Before continuing with the review, confirm that the page you are inspect is using an updated layout that has a Boxalino CMS Element configured (ex: widget home).
Review the home page with the help of the
_bx_inspect_key=<apiKey>(ex:<e-shop>?_bx_inspect_key=<apiKey>&cacheKey=<some-text>The scrolling events are tracked in the “Network” tab https://boxalino.atlassian.net/wiki/spaces/BPKB/pages/295141377/JS+Tracker+Check-List#Check-the-scrollImpression-tracking%3A
When there is no API request
If there is no change on the page when inspecting (uncached) via the _bx_inspect_key - it means:
The CMS element is not included in the homepage layout
If the CMS element is included and there is no API request - there is a caching issue and/or some server-side errors.
The integration team is able to inspect directly on the server.