Develop/3.7

_data/docs-home.yml

@@ -127,18 +127,19 @@ toc:
     - title: Templatization
       path: /docs/user-guide/templatization/
       new: true
-- title: White Labeling
+- title: White labeling
   pe: true
   section:
     - title: Overview
       path: /docs/pe/user-guide/white-labeling/
     - title: Self-registration
       path: /docs/pe/user-guide/self-registration/
-    - title: Mail Templates
+    - title: Mail templates
       path: /docs/pe/user-guide/mail-templates/
-    - title: Custom Translations
+    - title: Custom translation
       path: /docs/pe/user-guide/custom-translation/
-    - title: Custom Menu
+      new: true
+    - title: Custom menu
       path: /docs/pe/user-guide/custom-menu/
 - title: Integrations
   pe: true
@@ -316,9 +317,11 @@ toc:
     path: /docs/user-guide/ui/slack-settings/
   - title: Microsoft Teams Settings
     path: /docs/user-guide/ui/microsoft-teams-settings/
-    new: true
   - title: Mail Settings
     path: /docs/user-guide/ui/mail-settings/
+  - title: Mobile application QR code
+    path: /docs/user-guide/ui/mobile-qr-code/
+    new: true
   - title: JWT Security Settings
     path: /docs/user-guide/ui/jwt-security-settings/
 - title: Contribution Guide

_data/mobile-pe/docs-home.yml

@@ -23,5 +23,7 @@ toc:
         path: /docs/pe/mobile/white-labeling/
       - title: Self-registration
         path: /docs/pe/mobile/self-registration/
+      - title: QR code settings
+        path: /docs/pe/mobile/qr-code-settings/
   - title: Publish your app
     path: /docs/pe/mobile/release/

_data/mobile/docs-home.yml

@@ -19,5 +19,7 @@ toc:
         path: /docs/mobile/mobile-actions/
       - title: OAuth 2.0
         path: /docs/mobile/oauth2/
+      - title: QR code settings
+        path: /docs/mobile/qr-code-settings/
   - title: Publish your app
     path: /docs/mobile/release/

_data/paas/docs-home.yml

@@ -144,17 +144,18 @@ toc:
     - title: Templatization
       path: /docs/paas/user-guide/templatization/
       new: true
-- title: White Labeling
+- title: White labeling
   section:
     - title: Overview
       path: /docs/paas/user-guide/white-labeling/
     - title: Self-registration
       path: /docs/paas/user-guide/self-registration/
-    - title: Mail Templates
+    - title: Mail templates
       path: /docs/paas/user-guide/mail-templates/
-    - title: Custom Translations
+    - title: Custom translation
       path: /docs/paas/user-guide/custom-translation/
-    - title: Custom Menu
+      new: true
+    - title: Custom menu
       path: /docs/paas/user-guide/custom-menu/
 - title: Integrations
   section:
@@ -304,9 +305,11 @@ toc:
       path: /docs/paas/user-guide/ui/slack-settings/
     - title: Microsoft Teams Settings
       path: /docs/paas/user-guide/ui/microsoft-teams-settings/
-      new: true
     - title: Mail Settings
       path: /docs/paas/user-guide/ui/mail-settings/
+    - title: Mobile application QR code
+      path: /docs/paas/user-guide/ui/mobile-qr-code/
+      new: true
 - title: Subscriptions
   path: /products/paas/subscription/
 - title: Plan and billing

_data/pe/docs-home.yml

@@ -144,17 +144,18 @@ toc:
   - title: Templatization
     path: /docs/pe/user-guide/templatization/
     new: true
-- title: White Labeling
+- title: White labeling
   section:
     - title: Overview
       path: /docs/pe/user-guide/white-labeling/
     - title: Self-registration
       path: /docs/pe/user-guide/self-registration/
-    - title: Mail Templates
+    - title: Mail templates
       path: /docs/pe/user-guide/mail-templates/
-    - title: Custom Translations
+    - title: Custom translation
       path: /docs/pe/user-guide/custom-translation/
-    - title: Custom Menu
+      new: true
+    - title: Custom menu
       path: /docs/pe/user-guide/custom-menu/
 - title: Integrations
   section:
@@ -322,9 +323,11 @@ toc:
     path: /docs/pe/user-guide/ui/slack-settings/
   - title: Microsoft Teams Settings
     path: /docs/pe/user-guide/ui/microsoft-teams-settings/
-    new: true
   - title: Mail Settings
     path: /docs/pe/user-guide/ui/mail-settings/
+  - title: Mobile application QR code
+    path: /docs/pe/user-guide/ui/mobile-qr-code/
+    new: true
   - title: JWT Security Settings
     path: /docs/pe/user-guide/ui/jwt-security-settings/
 - title: Contribution Guide

_includes/docs/mobile/customization.md

@@ -12,7 +12,9 @@
 - **[Setup alarm details dashboard](/docs/{{docsPrefix}}mobile/alarm-dashboard)**
 - **[Configure mobile actions](/docs/{{docsPrefix}}mobile/mobile-actions)**
 - **[Configure OAuth 2.0](/docs/{{docsPrefix}}mobile/oauth2)**
+- **[Configure mobile app QR code settings](/docs/{{docsPrefix}}mobile/qr-code-settings/)**
 {% if docsPrefix == 'pe/' %}
 - **[Configure white-labeling](/docs/pe/mobile/white-labeling)**
 - **[Configure self-registration](/docs/pe/mobile/self-registration)**
+- **[Configure mobile app QR code settings](/docs/pe/mobile/qr-code-settings/)**
 {% endif %}

_includes/docs/mobile/qr-code-settings.md

@@ -0,0 +1,94 @@
+* TOC
+{:toc}
+
+This guide provides instructions on how to configure a custom mobile application to launch directly from a [QR code scan](/docs/{{peDocsPrefix}}user-guide/ui/mobile-qr-code/) using your phone's camera. 
+Whether you're looking to customize an existing app with your own source code from {% if docsPrefix == "pe/" %}[GitHub](https://github.com/thingsboard/flutter_thingsboard_pe_app){:target="_blank"}{% endif %}{% if docsPrefix == null %}[GitHub](https://github.com/thingsboard/flutter_thingsboard_app){:target="_blank"}{% endif %} or direct it to a custom host, this document will walk you through the necessary steps.
+
+## Android app settings
+
+### Direct Android application to your own host
+
+To direct your custom application to your own host, you need to modify `AndroidManifest.xml` file:
+
+- Open the Flutter project with VS Code or Android Studio;
+- Navigate to `android/app/src/main/AndroidManifest.xml` file;
+- Modify **AndroidManifest.xml**. You have to update `android:host=` with your host:
+
+```text
+<!-- App Links -->
+<intent-filter android:autoVerify="true">
+    <action android:name="android.intent.action.VIEW" />
+    <category android:name="android.intent.category.DEFAULT" />
+    <category android:name="android.intent.category.BROWSABLE" />
+    <data
+        android:scheme="https"
+        android:host="thingsboard.cloud"
+        android:pathPrefix="/api/noauth/qr" />
+</intent-filter>
+```
+
+### Mobile app QR code widget settings for Android
+
+To launch your custom mobile application when scanning a QR code, you need to specify the "[App package name](#app-package-name)" and "[SHA256 certificate fingerprints](#sha256-certificate-fingerprints)" in the [ThingsBoard Mobile app QR code widget settings](/docs/{{peDocsPrefix}}user-guide/ui/mobile-qr-code/#configuring-qr-code-widget-on-home-page){:target="_blank"}.
+
+#### App package name
+
+Find the app package name **applicationId** in **build.gradle** file located at `android/app/build.gradle`:
+
+```text
+    defaultConfig {
+        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
+        applicationId "org.thingsboard.pe.app"
+    }
+```
+
+#### SHA256 certificate fingerprints
+
+If your app distributed via Google Play you need to use SHA-256 certificate fingerprint located in your developer account under **Release> Setup > App Integrity> App Signing tab:**
+
+![image](/images/mobile/sha256-fingerprint.png)
+
+If you app distributed locally you need to use the sha256 key your apk signed with
+
+Read more in the guide "[Set up app links for Android](https://docs.flutter.dev/cookbook/navigation/set-up-app-links#sha256-fingerprint){:target="_blank"}", available in the official Firebase documentation.
+
+## iOS app settings
+
+### Direct iOS application to your own host
+
+To direct your iOS application to your own host, you need to modify `entitlements.xml` file:
+
+- Open and modify `ios/YOUR_APP_NAME/YOUR_APP_NAME.entitlements.xml` file in your preferred IDE;
+- Modify **entitlements.xml** with your domain: You have to update `applinks` with your host:
+
+```text
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>aps-environment</key>
+	<string>development</string>
+	<key>com.apple.developer.associated-domains</key>
+	<array>
+		<string>applinks:thingsboard.cloud</string>
+	</array>
+</dict>
+</plist>
+```
+
+### Mobile app QR code widget settings for iOS
+
+To launch your custom iOS mobile application when scanning a QR code, you need to specify the "[App ID](#app-id)" in the [ThingsBoard Mobile app QR code widget settings](/docs/{{peDocsPrefix}}user-guide/ui/mobile-qr-code/#configuring-qr-code-widget-on-home-page){:target="_blank"}.
+
+#### App ID
+
+When you create your Xcode project from a template, the bundle ID ([CFBundleIdentifier](https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleidentifier){:target="_blank"}) uniquely identifies your app throughout the system.
+This ID combines the organization ID and the app name that you enter in reverse-DNS format.
+For example, if you enter "Runner" as the app name for your organization, the bundle identifier will be `com.mycompany.app.Runner`.
+
+To find the bundle ID (**App ID**), you need to:
+- Choose the target;
+- Click the "Signing & Capabilities" pane;
+- Find the bundle identifier (App ID) in the "Signing" section.
+
+![image](/images/mobile/qr-code-app-id.png)