Skip to content

Added Raptor doc#3200

Open
mnocon wants to merge 2 commits into
5.0from
raptor-doc
Open

Added Raptor doc#3200
mnocon wants to merge 2 commits into
5.0from
raptor-doc

Conversation

@mnocon
Copy link
Copy Markdown
Contributor

@mnocon mnocon commented May 14, 2026 •
edited
Loading

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 14, 2026

Preview of modified files

Preview of modified Markdown:

mnocon
mnocon commented May 14, 2026
View reviewed changes
Comment thread docs/recommendations/raptor_integration/raptor_connector_guide.md
- [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)
Copy link
Copy Markdown
Contributor Author

@mnocon mnocon May 14, 2026

Choose a reason for hiding this comment

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

It belongs to the Product group: https://github.com/ibexa/connector-raptor/pull/52/changes#diff-e09a15b5e9778fe6299c84ba5358b51504ea881f68fa69ae5246ba31c8161807R376 , even though it has content in the name?

Copy link
Copy Markdown
Contributor

@adriendupuis adriendupuis May 20, 2026

Choose a reason for hiding this comment

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

Still there at https://github.com/ibexa/connector-raptor/blob/5.0/src/bundle/Resources/config/prepend/page_builder_blocks.yaml#L398-L400

If it's a mistake, it won't be fixed before merge freeze for 5.0.8

But I guess this is in Product category because it recommends products in the first place, related to whatever content as the criteria.

Copy link
Copy Markdown
Contributor Author

@mnocon mnocon May 20, 2026

Choose a reason for hiding this comment

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

@tbialcz could you please have a look, maybe something we could clarify in the doc?

@mnocon mnocon marked this pull request as ready for review May 14, 2026 15:23
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented May 14, 2026

Quality Gate Passed 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

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 14, 2026

code_samples/ change report

Before (on target branch)After (in current PR)

code_samples/recommendations/config/packages/ibexa_connector_raptor.yaml

docs/recommendations/raptor_integration/connector_installation_configuration.md@28:``` yaml

code_samples/recommendations/config/packages/ibexa_connector_raptor.yaml

docs/recommendations/raptor_integration/connector_installation_configuration.md@28:``` yaml
docs/recommendations/raptor_integration/connector_installation_configuration.md@29:[[= include_file('code_samples/recommendations/config/packages/ibexa_connector_raptor.yaml', 0, 13) =]]
docs/recommendations/raptor_integration/connector_installation_configuration.md@29:[[= include_file('code_samples/recommendations/config/packages/ibexa_connector_raptor.yaml', 0, 17) =]]
docs/recommendations/raptor_integration/connector_installation_configuration.md@30:```

001⫶ibexa:
002⫶    system:
003⫶        <scope>:
004⫶            connector_raptor:
005⫶                enabled:              true
006⫶                customer_id:          ~ # Required
007⫶                tracking_type:        client # One of: "client" or "server"
008⫶
009⫶                # Raptor Recommendations API key
010⫶                recommendations_api_key: ~ # Required
011⫶
012⫶                # Raptor Recommendations API URL, optional, set by default
013⫶                recommendations_api_url: '%ibexa.connector.raptor.recommendations.api_url%'
docs/recommendations/raptor_integration/connector_installation_configuration.md@30:```

001⫶ibexa:
002⫶    system:
003⫶        <scope>:
004⫶            connector_raptor:
005⫶                enabled:              true
006⫶                customer_id:          ~ # Required
007⫶                tracking_type:        client # One of: "client" or "server"
008⫶
009⫶                # Raptor Recommendations API key
010⫶                recommendations_api_key: ~ # Required
011⫶
012⫶                # Raptor Recommendations API URL, optional, set by default
013⫶                recommendations_api_url: '%ibexa.connector.raptor.recommendations.api_url%'

docs/recommendations/raptor_integration/connector_installation_configuration.md@76:``` yaml hl_lines="14-17"
docs/recommendations/raptor_integration/connector_installation_configuration.md@77:[[= include_file('code_samples/recommendations/config/packages/ibexa_connector_raptor.yaml') =]]
docs/recommendations/raptor_integration/connector_installation_configuration.md@78:```
014⫶
015⫶                # Cookie lifetime in days for server-side tracking identifier
016⫶                # Default: 365 days. Minimum: 1 day.
017⫶                cookie_id_lifetime_days: 365

docs/recommendations/raptor_integration/connector_installation_configuration.md@77:``` yaml hl_lines="18-20"
docs/recommendations/raptor_integration/connector_installation_configuration.md@78:[[= include_file('code_samples/recommendations/config/packages/ibexa_connector_raptor.yaml') =]]
docs/recommendations/raptor_integration/connector_installation_configuration.md@79:```

001⫶ibexa:
002⫶    system:
003⫶        <scope>:
004⫶            connector_raptor:
005⫶                enabled:              true
006⫶                customer_id:          ~ # Required
007⫶                tracking_type:        client # One of: "client" or "server"
008⫶
009⫶                # Raptor Recommendations API key
010⫶                recommendations_api_key: ~ # Required
011⫶
012⫶                # Raptor Recommendations API URL, optional, set by default
013⫶                recommendations_api_url: '%ibexa.connector.raptor.recommendations.api_url%'

001⫶ibexa:
002⫶    system:
003⫶        <scope>:
004⫶            connector_raptor:
005⫶                enabled:              true
006⫶                customer_id:          ~ # Required
007⫶                tracking_type:        client # One of: "client" or "server"
008⫶
009⫶                # Raptor Recommendations API key
010⫶                recommendations_api_key: ~ # Required
011⫶
012⫶                # Raptor Recommendations API URL, optional, set by default
013⫶                recommendations_api_url: '%ibexa.connector.raptor.recommendations.api_url%'
014❇️ibexa_connector_raptor:
015❇️    # When enabled, tracking exceptions are thrown instead of being silently handled
016❇️    strict_exceptions: true
014⫶
015⫶                # Cookie lifetime in days for server-side tracking identifier
016⫶                # Default: 365 days. Minimum: 1 day.
017⫶                cookie_id_lifetime_days: 365
018❇️ibexa_connector_raptor:
019❇️    # When enabled, tracking exceptions are thrown instead of being silently handled
020❇️    strict_exceptions: true


 Download colorized diff

@mnocon mnocon requested review from alongosz, barbaragr and tbialcz May 15, 2026 06:46
This was referenced May 15, 2026
Draft
Open
alongosz
alongosz approved these changes May 15, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@alongosz alongosz left a comment

Choose a reason for hiding this comment

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

+1 but let's make sure we don't include parts that won't make it to the release.

@adriendupuis adriendupuis added Wait with merge PRs that shouldn't be merged instantly and removed Needs DEV review labels May 20, 2026
@adriendupuis adriendupuis mentioned this pull request May 20, 2026
Open
7 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@adriendupuis adriendupuis adriendupuis left review comments

@alongosz alongosz alongosz approved these changes

@julitafalcondusza julitafalcondusza julitafalcondusza approved these changes

@tbialcz tbialcz Awaiting requested review from tbialcz

@barbaragr barbaragr Awaiting requested review from barbaragr

Assignees

No one assigned

Labels

Ready for MERGE Wait with merge PRs that shouldn't be merged instantly

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@mnocon @alongosz @adriendupuis @julitafalcondusza