From a46b32ad1ba9807a86ef957385515ca8b3f0b87e Mon Sep 17 00:00:00 2001
From: Jannik Stehle <50302941+JammingBen@users.noreply.github.com>
Date: Mon, 30 Oct 2023 06:28:23 +0000
Subject: [PATCH] Merge pull request #9863 from LukasHirt/feat/location-picker

feat: add location picker into embed mode
---
 embed-mode/_index.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/embed-mode/_index.md b/embed-mode/_index.md
index b443b085854..d47af7d8461 100644
--- a/embed-mode/_index.md
+++ b/embed-mode/_index.md
@@ -29,3 +29,39 @@ The app is emitting various events depending on the goal of the user. All events
 | **owncloud-embed:select** | Resource[] | Gets emitted when user selects resources via the "Attach as copy" action |
 | **owncloud-embed:share** | string[] | Gets emitted when user selects resources and shares them via the "Share links" action |
 | **owncloud-embed:cancel** | void | Gets emitted when user attempts to close the embedded instance via "Cancel" action |
+
+### Example
+
+```html
+<iframe src="https://my-owncloud-web-instance?mode=embed"></iframe>
+
+<script>
+  function selectEventHandler(event) {
+    const resources = event.detail
+
+    doSomethingWithSelectedResources(resources)
+  }
+
+  window.addEventListener('owncloud-embed:select', selectEventHandler)
+</script>
+```
+
+## Location picker
+
+By default, the Embed mode allows users to select resources. In certain cases (e.g. uploading a file), this needs to be changed to allow selecting a location. This can be achieved by running the embed mode with additional parameter `embed-target=location`. With this parameter, resource selection is disabled and the selected resources array always includes the current folder as the only item.
+
+### Example
+
+```html
+<iframe src="https://my-owncloud-web-instance?mode=embed&embed-target=location"></iframe>
+
+<script>
+  function selectEventHandler(event) {
+    const currentFolder = event.detail[0]
+
+    uploadIntoCurrentFolder(currentFolder)
+  }
+
+  window.addEventListener('owncloud-embed:select', selectEventHandler)
+</script>
+```