diff --git a/changelog/unreleased/enhancement-app-banner b/changelog/unreleased/enhancement-app-banner index 49315cbc60a..c295ab782a7 100644 --- a/changelog/unreleased/enhancement-app-banner +++ b/changelog/unreleased/enhancement-app-banner @@ -3,3 +3,5 @@ Enhancement: Added app banner for mobile devices We've added an app banner at the top of the web view for mobile devices asking the user whether they want to continue working in the app. By dismissing it, it will not show again until a new session is started, e.g. by opening a new tab. https://github.com/owncloud/web/pull/9696 +https://github.com/owncloud/web/pull/9872 + diff --git a/docs/theming/_index.md b/docs/theming/_index.md index a4ac513155a..87ae61ed5fc 100644 --- a/docs/theming/_index.md +++ b/docs/theming/_index.md @@ -259,6 +259,26 @@ Spacing variables get prepended with `--oc-space-`, so e.g. _"xlarge"_ creates t } ``` +### App Banner +To configure the app banner shown on mobile devices, you can use the following settings: + +```json +{ + "appBanner": { + "title": "ownCloud", + "publisher": "ownCloud GmbH", + "additionalInformation": "", + "ctaText": "OPEN", + "icon": "themes/owncloud/assets/owncloud-app-icon.png", + "appScheme": "owncloud" + } +} +``` + +`title` is usually your app's name as shown in the App Store or Google Play. `publisher` is the app developer's name. +`additionalInformation` can be used to specify pricing information, such as "FREE" or a catchphrase like "Don't miss out on our awesome app!". +`ctaText` refers to the text in the call to action button on the right side. The `icon` directive may be used to specify your own app icon. `appScheme` is the first part of the URL that is used to tell the mobile OS which app to open, so using `ownCloud` will generate links such as `owncloud://yourdomain.com/f/2b61b822...`. + ## Example theme An empty template for your custom theme is provided below, and you can use the instructions above to set it up according to your needs. Please note that since changing themes at runtime is not yet supported it only consists of a `default` theme. @@ -277,6 +297,14 @@ An empty template for your custom theme is provided below, and you can use the i "name": "", "slogan": "" }, + "appBanner": { + "title": "", + "publisher": "", + "additionalInformation": "", + "ctaText": "", + "icon": "", + "appScheme": "" + }, "logo": { "topbar": "", "favicon": "",