[DataObject] Add searchPath option to Image, Hotspotimage & ImageGallery

[cancan101]

Adds a new "searchPath" class-definition setting next to "uploadPath" for the image-flavored data types. While uploadPath only targets inline uploads, searchPath lets the asset search dialog of the field open pre-scoped to a configured asset folder (as a visible, user-clearable filter — a soft default, not a restriction).

The property is serialized to the UI automatically via the public-props JSON serialization, so the admin UIs (Studio / classic) can consume it from the field configuration.

Changes in this pull request

Resolves #17157

Additional info

Additional info: UI support implemented in pimcore/studio-ui-bundle#3993, the property is inert without it.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[github-actions]

Review Checklist

• Target branch (12.3 for bug fixes, others 2026.x)
• Tests (if it's testable code, there should be a test for it - get help)
• Docs (every functionality needs to be documented, see here)
• Migration incl. install.sql (e.g. if the database schema changes, ...)
• Upgrade notes (deprecations, important information, migration hints, ...)
• Label
• Milestone

[pimcore-deployments]

🚫 Issue-link guardrail failed — this PR has been converted to draft.

Every PR must reference a tracking issue in pimcore/platform-version so the change stays traceable.

• Resolves #17157 is not valid: issue not found.

Add the link with a keyword in the PR description (not in a comment): https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/using-keywords-in-issues-and-pull-requests

When fixed, press Ready for review to re-run the checks.

[pimcore-deployments]

🚫 CI & merge-readiness guardrail failed — this PR has been converted to draft.

A PR can only be merged when it has no conflicts with the base branch and all CI checks pass.

• CI check not successful: Milestone assigned (failure).

When fixed, press Ready for review to re-run the checks.

[pimcore-deployments]

👋 Friendly reminder — this pull request is still a draft.

A guardrail converted it to draft because something needed fixing, and there has been no activity since. If nothing changes, it will be closed in 14 days.

To keep it open, just take one of these steps:

• Address the guardrail comment above, then press Ready for review.
• Or leave a comment explaining that it is still in progress — any activity resets this timer.

Closing is not rejection: the branch and the discussion stay, and the PR can be reopened at any time.

When fixed, press Ready for review to re-run the checks.