Release 5.0.7 fixes by mnocon · Pull Request #3140 · ibexa/documentation-developer

mnocon · 2026-04-15T11:10:03Z

Small fixes to issues found when reviewing the code

Contains fixes from #3139

github-actions · 2026-04-15T11:10:20Z

Preview of modified files

Preview of modified Markdown:

mnocon · 2026-04-15T11:10:38Z

@@ -1,37 +1,29 @@
-{{ ibexa_tracking_track_event(


It was broken in https://ez-systems-developer-documentation--3134.com.readthedocs.build/en/3134/templating/twig_function_reference/recommendations_twig_functions/#custom-templates

mnocon · 2026-04-15T11:11:13Z

 | `enabled` | `false` | Enables the connector. |
 | `instance_url` | string | Base URL of your [[= pim_product_name =]] instance, for example `https://example.quable.com`. |
-| `api_token` | string | [Read Access API token](https://docs.quable.com/v5-EN/docs/system-api-tokens) used to authenticate requests to [[= pim_product_name =]]. |
+| `api_token` | string | [Read Access API token](https://docs.quable.com/v5-EN/docs/api-tokens) used to authenticate requests to [[= pim_product_name =]]. |


Quable changed their doc and link broke

mnocon · 2026-04-15T11:11:34Z

@@ -1,5 +1,5 @@
 ---
-description: Quable API
+description: Learn how to use PHP and REST APIs to retrieve product data from Quable


Preview looked wrong in the cards:
https://ez-systems-developer-documentation--3134.com.readthedocs.build/en/3134/product_catalog/quable/quable/#development

mnocon · 2026-04-15T11:11:53Z

 It loads the initial script into `window.raptor`.
 The script then enables event tracking, such as page visits, product views, or buys, from the front end.
-It can be overridden in multiple ways to support custom implementations and to render code snippet through [[= product_name_base =]] in the [design engine](design_engine.md).
+It can be overridden in multiple ways to support custom implementations and to render code snippet through [[= product_name =]] in the [design engine](design_engine.md).


product_name_base - Ibexa
product_name - Ibexa DXP

mnocon · 2026-04-15T11:11:59Z

    "templating/twig_function_reference/field_twig_functions",
    "templating/twig_function_reference/page_twig_functions",
    "templating/twig_function_reference/product_twig_functions",
+    "templating/twig_function_reference/recommendations_twig_functions",


Was missing

adriendupuis

oportunity to re-read the examples

Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com>

github-actions · 2026-04-17T08:35:02Z

code_samples/ change report

Before (on target branch)	After (in current PR)
`code_samples/ai_actions/config/packages/ibexa_connector_gemini.yaml`	`code_samples/ai_actions/config/packages/ibexa_connector_gemini.yaml`
	docs/ai_actions/configure_ai_actions.md@159:```yaml `docs/ai_actions/configure_ai_actions.md@160:[[= include_file('code_samples/ai_actions/config/packages/ibexa_connector_gemini.yaml') =]]` docs/ai_actions/configure_ai_actions.md@161:``` `001⫶ibexa_connector_gemini:` `002⫶ text_to_text:` `003⫶ models:` `004⫶ gemini-pro-latest:` `005⫶ label: 'Gemini Pro Latest'` `006⫶ max_tokens: 4096` `007⫶ gemini-flash-latest:` `008⫶ label: 'Gemini Flash Latest'` `009⫶ max_tokens: 4096` `010⫶ default_model: gemini-pro-latest` `011⫶ default_max_tokens: 4096 # Must be <= the model’s max_tokens` `012⫶ default_temperature: 0.8` `013⫶ image_to_text:` `014⫶ models:` `015⫶ gemini-flash-latest:` `016⫶ label: 'Gemini Flash Latest'` `017⫶ max_tokens: 4096` `018⫶ default_model: gemini-flash-latest` `019⫶ default_max_tokens: 4096` `020⫶ default_temperature: 1.0`
`code_samples/recommendations/templates/tracking/custom_visit.html.twig`	`code_samples/recommendations/templates/tracking/custom_visit.html.twig`
docs/templating/twig_function_reference/recommendations_twig_functions.md@180:``` html+twig `docs/templating/twig_function_reference/recommendations_twig_functions.md@181:[[= include_file('code_samples/recommendations/templates/tracking/custom_visit.html.twig') =]]` docs/templating/twig_function_reference/recommendations_twig_functions.md@182:``` `001⫶{{ ibexa_tracking_track_event(` `002⫶ 'visit',` `003⫶ product,` `004⫶ {},` `005⫶ '@App/tracking/custom_visit.html.twig'` `006⫶) }}` 007⫶``` `008⫶` `009⫶{# templates/tracking/custom_visit.html.twig #}`	docs/templating/twig_function_reference/recommendations_twig_functions.md@169:``` html+twig `docs/templating/twig_function_reference/recommendations_twig_functions.md@170:[[= include_file('code_samples/recommendations/templates/tracking/custom_visit.html.twig') =]]` docs/templating/twig_function_reference/recommendations_twig_functions.md@171:``` `001⫶{# templates/tracking/custom_visit.html.twig #}` `002⫶` `003⫶{#` `004⫶# Custom visit tracking template` `005⫶#` 006⫶# Available variables, assed to the template by `ibexa_tracking_track_event`: `007⫶# - parameters: array of Raptor tracking parameters (p1, p2, p3, etc.)` `008⫶# - debug: boolean flag to enable debug console messages` `009⫶#}`
`010⫶`	`010⫶`
`011⫶ {#` `012⫶ # Custom visit tracking template` `013⫶ #` `014⫶ # Available variables:` `015⫶ # - parameters: array of Raptor tracking parameters (p1, p2, p3, etc.)` `016⫶ # - debug: boolean flag to enable debug console messages` `017⫶ #}` `018⫶` `019⫶ <script type="text/javascript">` `020⫶ {% autoescape 'js' %}` `021⫶ (function () {` `022⫶ // Custom logic before tracking` `023⫶ console.log('Custom visit tracking template');` `024⫶ console.log('Tracking parameters:', {{ parameters\|json_encode\|raw }});` `025⫶` `026⫶ // Send the tracking event (REQUIRED for tracking to work)` `027⫶ const event = 'trackEvent';` `028⫶ const params = {{ parameters\|json_encode\|raw }};` `029⫶ window.raptor.push(event, params);` `030⫶` `031⫶ // Custom logic after tracking` `032⫶ {% if debug %}` `033⫶ console.log('Visit event tracked successfully');` `034⫶ {% endif %}` `035⫶ })();` `036⫶ {% endautoescape %}` `037⫶ </script>`	`011⫶<script type="text/javascript">` `012⫶ {% autoescape 'js' %}` `013⫶ (function () {` `014⫶ // Custom logic before tracking` `015⫶ {# For example, always override the website ID by editing the received parameters: #}` `016⫶ {% set parameters = parameters\|merge({'p7': 'custom-website-id'}) %}` `017⫶ {% if debug %}` `018⫶ console.log('Custom visit tracking template');` `019⫶ console.log('Tracking parameters:', {{ parameters\|json_encode\|raw }});` `020⫶ {% endif %}` `021⫶` `022⫶ // Send the tracking event (REQUIRED for tracking to work)` `023⫶ const event = 'trackEvent'; // Don't change this - Raptor API method name` `024⫶ const params = {{ parameters\|json_encode\|raw }};` `025⫶ window.raptor.push(event, params);` `026⫶` `027⫶ // Custom logic after tracking` `028⫶ {% if debug %}` `029⫶ console.log('Visit event tracked successfully');` `030⫶ {% endif %}` `031⫶ })();` `032⫶ {% endautoescape %}` `033⫶</script>`

Download colorized diff

Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com>

sonarqubecloud · 2026-04-17T10:41:10Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

@mnocon

* Raptor integration - feature branch (#3121) * first batch added * content added * recommendations twig page added * updates * content moved, structure updated * guide added * guide content * fixes, content moved * fixes after review * Raptor integration - feature branch: fix links (#3123) * Add preview of linked PHP API Ref entries * Fix few links * new batch of fixes * updates * new blocks added * name fix * fix * new page added to cards on raptor_connector landing page * fixes - first batch * new fixes * PHP & JS CS Fixes * new fixes * block names fixed * code fixed * code fixed * links fixed * card fixed * IBX-11571: Rendering recommendations outside of Page Builder documented in Dev-doc (#3127) * Update JWT (#3108) * development_security.md: Update JWT firewalls ibexa/recipes-dev#122 ibexa/recipes-dev#124 ibexa/recipes-dev#125 * rest_api_authentication.md: XML isn't supported for JWT ibexa/rest#101 * render doc added * updates * img added, content added * mkdocs * fixes after rev * fix * fixes --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * php fix * composer.json fix - connector-raptor added * Raptor integration - feature branch: Fix PHP (#3130) * EventData.php: Wrap into a class * Event*.php: Format * language fixes * Raptor integration: Rework PHP (#3131) * tracking_php_api.md: Detail EventMapper, EventType, EventContext * tracking_php_api.md: caution about buy event --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * server description updated --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: julitafalcondusza <julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Added translation-related Twig Component groups (#3091) * Doc for Quable (#3085) * Renaming - part one * Current status * Install doc ready? * Fixed build * Configuration doc * Removed Quable other * Added product guide skeleton * Guide * Current status * Customize product embeds * Added missing search doc * Attribute rendering * Provided a list of attributes * Fixed mkdocs build * Self review * Added product code limitatin * Fix typos * Removed asset mentions * Self review * Selfreview done * Apply suggestion from @mnocon * Fixed table rendering * Added Quable API * Removed Quable client package * Adrien's review * After review * Apply suggestions from code review Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Review changes * Update docs/product_catalog/quable/install_quable.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Update docs/product_catalog/add_remote_pim_support.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Update docs/product_catalog/customize_product_embed_templates.md Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Manual changes * Apply suggestions from code review Co-authored-by: Paweł Niedzielski <pawel.tadeusz.niedzielski@gmail.com> * Manual review feedback * Added doc for language configuration (#3128) * Added doc for language configuration * Apply suggestion from @mnocon --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Paweł Niedzielski <pawel.tadeusz.niedzielski@gmail.com> * Added doc for TaxonomyNoEntries & TaxonomySubtree (#3082) * Added doc for TaxonomyNoEntries * Added doc for Taxonomy subtree * Fixed CS * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Apply suggestion from @mnocon * Rebuild --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * IBX-11485: Update doc for Symfony 7.4 (#3098) * Update doc for Symfny 7.4 * Added bundle entry * Apply suggestion from @mnocon * Added var/share mention * Review feedback * Apply suggestions from code review Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * Product tour (#3065) * Product tour doc skeleton * Review feedback * Vale * Review feedback - part 2 * Added doc for the new config * Review feedback * Adjusted includes * Wording * Specified button name * Removed TODO * Help Center and Product tour enabled by default * Added images and interactive demo * Apply suggestions from code review Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Manual changes * [TMP] Fix build * Fixed build * Reworded --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Documented try_catch (and sql: execute) in migrations (#3060) * Added doc for try_catch and sql in migrations * Vale suggestions * Vale suggestion * Added missing code block * Review feedback * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * Improved example and clarified migration and migratoin step usage * Removed RN enties --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * IBX-10998: Document Gemini connector (#3025) * IBX-10998: Document Gemini connector * Update docs/ai_actions/extend_ai_actions.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Implement reviewer comments * Apply suggestions from code review Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Add RN entry * IBX-11401: Describe Gemini embeddings provider (#3120) * IBX-11401: Describe Gemini embeddings provider * Remove the RN entry * Fied broken link * Fixed event page name --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Added doc for additional parameter for ibexa_render (#3043) * Added doc for additional parameter for ibexa_render * Added update sections * Update docs/update_and_migration/from_5.0/update_from_5.0.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Reworked RN drafts * Update docs/release_notes/ibexa_dxp_v4.6.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Removed RN entries --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Product tour: Deptract+Rector fixes (#3136) * deptrac.baseline.yaml: Ignore NotificationScenarioSubscriber * NotificationScenarioSubscriber: Apply Rector suggestions * customize_product_tour.md: Update hl_lines * updated_at_criterion.md: Rm EOF blank lines * Release 5.0.7 follow up (#3137) * Added homepage mention * Applied update doc suggestion * Reworded Gemini connector * Fixed link? * search_api.md: Minor fixes * Raptor Add/Update buy event (#3141) * tracking_php_api.md: Rm caution w/ EventType::BUY * recommendations_twig_functions: Add buy event, sort events * tracking_php_api.md: More PHP API Ref links in mapping intro --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> * 5.0.7 update (#3143) * Added DB update scripts * Mention that ibexa:setup is deprecated * Reordered * Reworded * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Release 5.0.7 fixes (#3140) * Highlight and wording fixes * Fixes * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Extracted to separate yaml file * Apply suggestion from @adriendupuis Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> --------- Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Release notes for v5.0.7 and v4.6.29 (#3133) * Init next release notes w/ postponed * mkdocs.yml: Increment latest_tag_* * Symfony 7.4 #3098 * Apply suggestion from @adriendupuis * Revert "Apply suggestion from @adriendupuis" This reverts commit 519103f. * ibexa_dxp_v5.0.md: Raptor connector LTS Update * ibexa_dxp_v5.0.md: Raptor connector LTS Update (Format) * Apply suggestion from vale * Apply suggestions from @julitafalcondusza Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * ibexa_dxp_v5.0.md: translation components, AI in PB * ibexa_dxp_v5.0.md: Narrowed link for Raptor connector * ibexa_dxp_v5.0.md: Sort editions and add Quable * ibexa_dxp_vX.Y.md: Taxonomy search criteria * ibexa_dxp_v4.6.md: Taxonomy search criteria: fix links * Comment include 'snippets/release_XY.md' * Use absolute links in snippets/release_XY.md * Add Quable to ibexa_dxp_v4.6.md * Add Integrated help's Product tour * Raptor connector isn't an LTS Update * Raptor connector isn't an LTS Update * Quable is an add-on * ibexa_dxp_v5.0.md: REST API request body examples * ibexa_dxp_v5.0.md: PHP API * ibexa_dxp_v5.0.md: PHP API * Quable PIM isn't for Commerce * Move Quable PIM up, rm badges * ibexa_dxp_v5.0.md: Fix link * Quable isn't for 4.6 * Add PHP API draft to release notes * Apply suggestion from @dabrt * remove blur, set versions and date * uncomment include_file * Apply suggestions from code review Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Apply suggestions from code review Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * resync ibexa_dxp_v5.0.md and ibexa_dxp_v4.6.md * Move AI Actions in blocks upper * TaxonomySubtree isn't new to these release * Update the next release date --------- Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Made Date and time/Symbol attribute links version aware * Update docs/release_notes/ibexa_dxp_v4.6.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Update docs/release_notes/ibexa_dxp_v4.6.md Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> * Fixed broken link * Added PHP API links * Added security note --------- Co-authored-by: julitafalcondusza <117284672+julitafalcondusza@users.noreply.github.com> Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: julitafalcondusza <julitafalcondusza@users.noreply.github.com> Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> Co-authored-by: Paweł Niedzielski <pawel.tadeusz.niedzielski@gmail.com>

mnocon added 2 commits April 15, 2026 12:48

Highlight and wording fixes

6f577e2

Fixes

a27025b

mnocon commented Apr 15, 2026

View reviewed changes

Comment thread docs/ai_actions/configure_ai_actions.md Outdated

mnocon commented Apr 15, 2026

View reviewed changes

mnocon added the Needs DOC review label Apr 15, 2026

mnocon requested review from a team, adriendupuis, dabrt and julitafalcondusza April 15, 2026 11:12

adriendupuis requested changes Apr 15, 2026

View reviewed changes

Comment thread docs/ai_actions/configure_ai_actions.md Outdated

Comment thread code_samples/recommendations/templates/tracking/custom_visit.html.twig

Comment thread code_samples/recommendations/templates/tracking/custom_visit.html.twig Outdated

adriendupuis requested changes Apr 15, 2026

View reviewed changes

Comment thread code_samples/recommendations/templates/tracking/custom_visit.html.twig Outdated

Comment thread code_samples/recommendations/templates/tracking/custom_visit.html.twig

mnocon commented Apr 17, 2026

View reviewed changes

Comment thread code_samples/recommendations/templates/tracking/custom_visit.html.twig Outdated

Apply suggestions from code review

f48c80a

Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com> Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com>

mnocon requested review from adriendupuis and tbialcz April 17, 2026 08:27

Extracted to separate yaml file

b56e9d6

mnocon force-pushed the release-5.0.7-fixes branch from 923a9e3 to b56e9d6 Compare April 17, 2026 08:27

adriendupuis requested changes Apr 17, 2026

View reviewed changes

Comment thread code_samples/recommendations/templates/tracking/custom_visit.html.twig Outdated

Apply suggestion from @adriendupuis

8292c78

Co-authored-by: Adrien Dupuis <61695653+adriendupuis@users.noreply.github.com>

mnocon requested a review from adriendupuis April 17, 2026 10:31

adriendupuis approved these changes Apr 17, 2026

View reviewed changes

mnocon merged commit b6b31f9 into release-5.0.7 Apr 17, 2026
8 of 9 checks passed

mnocon deleted the release-5.0.7-fixes branch April 17, 2026 10:36

Conversation

mnocon commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Apr 15, 2026

Preview of modified files

Uh oh!

mnocon Apr 15, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

mnocon Apr 15, 2026

Choose a reason for hiding this comment

Uh oh!

mnocon Apr 15, 2026

Choose a reason for hiding this comment

Uh oh!

mnocon Apr 15, 2026

Choose a reason for hiding this comment

Uh oh!

mnocon Apr 15, 2026

Choose a reason for hiding this comment

Uh oh!

adriendupuis left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Apr 17, 2026

code_samples/ change report

Uh oh!

Uh oh!

Uh oh!

sonarqubecloud Bot commented Apr 17, 2026

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mnocon commented Apr 15, 2026 •

edited

Loading