Feature/breadcrumbs

docs/docs/getting-started/document-manager.md

@@ -565,6 +565,10 @@ One of the most important methods on the Document Manager, responsible for const
 
 ```
 
+## Breadcrumbs
+
+For providing breadcrumbs, which might be supported by the WOPI client, implement the `HasBreadcrumbs` interface.
+
 ### Actions
 
 Todo from the docs

src/Contracts/AbstractDocumentManager.php

@@ -77,6 +77,13 @@ abstract class AbstractDocumentManager
         'SupportsRename' => 'supportRename',
         'SupportsExtendedLockLength' => 'supportExtendedLockLength',
 
+        // Breadcrumbs
+        'BreadcrumbBrandName' => 'breadcrumbBrandName',
+        'BreadcrumbBrandUrl' => 'breadcrumbBrandUrl',
+        'BreadcrumbDocName' => 'breadcrumbDocName',
+        'BreadcrumbFolderName' => 'breadcrumbFolderName',
+        'BreadcrumbFolderUrl' => 'breadcrumbFolderUrl',
+
     ];
 
     /**

src/Contracts/Concerns/HasBreadcrumbs.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Nagi\LaravelWopi\Contracts\Concerns;
+
+/**
+ * Provides information to allow showing breadcrumbs in the editor. Not necessarily supported by all WOPI clients.
+ */
+interface HasBreadcrumbs
+{
+    /**
+     * The name of the brand URL.
+     */
+    public function breadcrumbBrandName(): string;
+
+    /**
+     * A user accessible URI that allows the user to
+     * go back to the root page.
+     */
+    public function breadcrumbBrandUrl(): string;
+
+    /**
+     * The name of the document, optional.
+     */
+    public function breadcrumbDocName(): string;
+
+    /**
+     * The name of the folder URL
+     */
+    public function breadcrumbFolderName(): string;
+
+    /**
+     * A user accessible URI that allows the user to
+     * * go back to the parent of the document.
+     */
+    public function breadcrumbFolderUrl(): string;
+}