From f5ad328729c193794d3066e16fc8b02dbce1173d Mon Sep 17 00:00:00 2001 From: Andrey Borysenko Date: Thu, 17 Jul 2025 19:22:34 +0300 Subject: [PATCH] feat: add note about new OCP \OCP\Search\IExternalProvider interface Signed-off-by: Andrey Borysenko --- .../app_upgrade_guide/upgrade_to_32.rst | 1 + developer_manual/digging_deeper/search.rst | 7 +++++++ 2 files changed, 8 insertions(+) diff --git a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_32.rst b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_32.rst index 0f7f1ca6a25..a06ac9cf498 100644 --- a/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_32.rst +++ b/developer_manual/app_publishing_maintenance/app_upgrade_guide/upgrade_to_32.rst @@ -51,6 +51,7 @@ Added APIs - New method ``\OCP\Files\Template\BeforeGetTemplatesEvent::shouldGetFields`` to get the event's ``withFields`` property, which should determine whether or not to perform template field extraction on the returned templates. - New interface ``\OCP\OCM\ICapabilityAwareOCMProvider`` to extend the OCM provider with 1.1 and 1.2 extensions of the Open Cloud Mesh Discovery API - New task processing task type ``OCP\TaskProcessing\AnalyzeImages`` to ask questions about images. +- New interface ``\OCP\Search\IExternalProvider`` allows extending the search provider with an explicit flag to indicate that the search is performed on external (3rd-party) resources. This is used in Unified Search to disable searches through these by default (via a toggle switch). Changed APIs ^^^^^^^^^^^^ diff --git a/developer_manual/digging_deeper/search.rst b/developer_manual/digging_deeper/search.rst index b28ee7d469a..a5d3f30b1a9 100644 --- a/developer_manual/digging_deeper/search.rst +++ b/developer_manual/digging_deeper/search.rst @@ -228,6 +228,13 @@ This interface allows to supports other filtering types. ``getCustomFilters`` allows to declare specific filters. In current state, the specific filters will only be available in the API. +External search provider +------------------------ + +Since Nextcloud 32, to improve privacy, you can extend your provider with the ``\OCP\Search\IExternalProvider`` interface and implement the ``isExternalProvider()`` method to indicate that the search is performed on external (3rd-party) resources. +In the Unified Search UI, searching through these providers is disabled by default (via toggle switch). + + Provider registration ---------------------