Start with a Guided Tour. #5465

mohsenD98 · 2024-07-22T16:13:45Z

Enhanced First-Time User Experience (FTUE)

This pull request introduces a guided tutorial for new users when they launch the application for the first time. The goal is to provide an intuitive onboarding experience, setting the stage for a successful and enjoyable usage of Qfield.

Demonstration:
To illustrate the new feature, please watch the demo:

Dark

Screencast.from.2024-07-25.11-46-19.webm

Light

Screencast.from.2024-07-25.11-46-52.webm

As shown in the demo, we have implemented a tutorial panel that introduces key features step-by-step. The guide is designed to gradually introduce users to the application's functionality.

In this initial implementation, we've focused on providing essential information to new users. Future enhancements will further refine the tutorial to offer an even more engaging and effective learning experience.

This update aims to simplify the learning curve for our users, ensuring they can quickly get started with Qfield and maximize their productivity.

qfield-fairy · 2024-07-22T16:28:15Z

🎉 Ta-daaa, freshly created APKs are available for 2313c0e: arm64-android

Other architectures

src/qml/WelcomeScreen.qml

src/qml/qgismobileapp.qml

nirvn · 2024-07-23T12:53:31Z

We need to find a way for these guides not to show up in our testing environment :-)

mohsenD98 · 2024-07-23T16:39:29Z

also i pushed modified UI as recommended in our chat.

Update object id.

suricactus · 2024-07-24T13:53:02Z

Just want to say, fantastic feature! One very small suggestion, I think it would be nice to have the current step we are at with the dialogs, e.g. GNSS is 3/5. It's always good to know your road ahead.

m-kuhn · 2024-07-25T04:27:13Z

src/qml/qgismobileapp.qml

+        "target": () => [gnssButton]
+      }, {
+        "title": qsTr("Search"),
+        "description": qsTr("The search bar provides you with a quick way to find features within your project, jump to a typed latitude and longitude point, and much more."),


Should we link "and much more" to the docs?

m-kuhn · 2024-07-25T04:28:15Z

src/qml/qgismobileapp.qml

+        "target": () => [zoomToolbar]
+      }, {
+        "title": qsTr("GNSS"),
+        "description": qsTr("This button toggles your device's positioning system. When enabled, a position marker will appear top of the map. Long-pressing the button will open the positioning menu where additional functionalities can be explored."),


Suggested change

"description": qsTr("This button toggles your device's positioning system. When enabled, a position marker will appear top of the map. Long-pressing the button will open the positioning menu where additional functionalities can be explored."),

"description": qsTr("This button toggles the positioning system. When enabled, a position marker will appear top of the map. Long-pressing the button will open the positioning menu where additional functionalities can be explored."),

m-kuhn · 2024-07-25T04:29:01Z

src/qml/qgismobileapp.qml

+        "target": () => [menuButton]
+      }, {
+        "title": qsTr("Zoom Toolbar"),
+        "description": qsTr("In addition to pinch gesture, these buttons helps you quickly zooming in and out."),


Suggested change

"description": qsTr("In addition to pinch gesture, these buttons helps you quickly zooming in and out."),

"description": qsTr("In addition to the pinch gesture, these buttons help you quickly zoom in and out."),

m-kuhn · 2024-07-25T04:30:21Z

src/qml/qgismobileapp.qml

+
+    steps: [{
+        "title": qsTr("Menu"),
+        "description": qsTr("You can open dashboard here to interact with the project's legends and map theme, or start digitizing by activating the editing mode. Long-pressing the button also gives you immediate access to the main menu."),


Suggested change

"description": qsTr("You can open dashboard here to interact with the project's legends and map theme, or start digitizing by activating the editing mode. Long-pressing the button also gives you immediate access to the main menu."),

"description": qsTr("This button opens the dashboard. With the dashboard you can interact with the legend and map theme, or start digitizing by activating the editing mode. Long-pressing the button gives you immediate access to the main menu."),

m-kuhn · 2024-07-25T04:36:38Z

Looking good !
I just left a couple of small wording improvements.

Is it possible to abort the tour? Someone who sets up 50 tablets for a team should not have to click through.

mohsenD98 · 2024-07-25T05:52:23Z

Looking good ! I just left a couple of small wording improvements.

Is it possible to abort the tour? Someone who sets up 50 tablets for a team should not have to click through.

Thankyou, yes its possible:

mohsenD98 · 2024-07-25T05:53:22Z

Just want to say, fantastic feature! One very small suggestion, I think it would be nice to have the current step we are at with the dialogs, e.g. GNSS is 3/5. It's always good to know your road ahead.

Really nice idea ! working on it :) 👍

nirvn · 2024-07-25T07:02:58Z

src/qml/qgismobileapp.qml

+    objectName: 'mapCanvasTour'
+
+    steps: [{
+        "title": qsTr("Menu"),


Suggested change

"title": qsTr("Menu"),

"title": qsTr("Dashboard"),

nirvn · 2024-07-25T07:03:13Z

src/qml/qgismobileapp.qml

+        "description": qsTr("This button opens the dashboard. With the dashboard you can interact with the legend and map theme, or start digitizing by activating the editing mode. Long-pressing the button gives you immediate access to the main menu."),
+        "target": () => [menuButton]
+      }, {
+        "title": qsTr("Zoom Toolbar"),


Suggested change

"title": qsTr("Zoom Toolbar"),

"title": qsTr("Zoom"),

nirvn · 2024-07-25T07:03:23Z

src/qml/qgismobileapp.qml

+        "description": qsTr("In addition to the pinch gesture, these buttons help you quickly zoom in and out."),
+        "target": () => [zoomToolbar]
+      }, {
+        "title": qsTr("GNSS"),


Suggested change

"title": qsTr("GNSS"),

"title": qsTr("Positioning"),

mohsenD98 force-pushed the guide-map-buttons branch from 51db692 to 931712f Compare July 22, 2024 16:40

nirvn reviewed Jul 23, 2024

View reviewed changes

mohsenD98 and others added 4 commits July 24, 2024 10:39

Add guide at startup.

ccc0bea

try to pass spix test.

f4e0d5e

Fix pr issues and resolved ui feedback.

fcb5280

Update smoke_test.py

db3a72e

Update object id.

nirvn force-pushed the guide-map-buttons branch from 9bafaee to 06e13f4 Compare July 24, 2024 04:00

Spix, will you behave?

1a2d6e6

nirvn force-pushed the guide-map-buttons branch from ed8dc50 to 1a2d6e6 Compare July 24, 2024 12:06

mohsenD98 changed the title ~~WIP: Add guide at startup.~~ Add guide at startup. Jul 24, 2024

mohsenD98 changed the title ~~Add guide at startup.~~ Start with a Guided Tour. Jul 24, 2024

m-kuhn reviewed Jul 25, 2024

View reviewed changes

Fix description wrapping and height.

6cf3680

Apply text improvements by m-kuhn.

a6b8974

nirvn reviewed Jul 25, 2024

View reviewed changes

mohsenD98 added 3 commits July 25, 2024 10:43

Add progress of guide + fix words.

703dcb1

Use shape instead of image to support dark theme better!

6ed07a7

Fix orders.

2313c0e

nirvn approved these changes Jul 26, 2024

View reviewed changes

nirvn merged commit afd8eaf into master Jul 26, 2024
23 checks passed

nirvn deleted the guide-map-buttons branch July 26, 2024 14:28

mohsenD98 self-assigned this Aug 9, 2024

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Start with a Guided Tour. #5465

Start with a Guided Tour. #5465

mohsenD98 commented Jul 22, 2024 •

edited

Loading

qfield-fairy commented Jul 22, 2024 •

edited

Loading

nirvn commented Jul 23, 2024

mohsenD98 commented Jul 23, 2024

suricactus commented Jul 24, 2024

m-kuhn Jul 25, 2024

m-kuhn Jul 25, 2024

m-kuhn Jul 25, 2024

m-kuhn Jul 25, 2024

mohsenD98 Jul 25, 2024

m-kuhn commented Jul 25, 2024

mohsenD98 commented Jul 25, 2024

mohsenD98 commented Jul 25, 2024

nirvn Jul 25, 2024

mohsenD98 Jul 25, 2024

nirvn Jul 25, 2024

mohsenD98 Jul 25, 2024

nirvn Jul 25, 2024

mohsenD98 Jul 25, 2024

	"description": qsTr("This button toggles your device's positioning system. When enabled, a position marker will appear top of the map. Long-pressing the button will open the positioning menu where additional functionalities can be explored."),
	"description": qsTr("This button toggles the positioning system. When enabled, a position marker will appear top of the map. Long-pressing the button will open the positioning menu where additional functionalities can be explored."),

	"description": qsTr("In addition to pinch gesture, these buttons helps you quickly zooming in and out."),
	"description": qsTr("In addition to the pinch gesture, these buttons help you quickly zoom in and out."),

	"description": qsTr("You can open dashboard here to interact with the project's legends and map theme, or start digitizing by activating the editing mode. Long-pressing the button also gives you immediate access to the main menu."),
	"description": qsTr("This button opens the dashboard. With the dashboard you can interact with the legend and map theme, or start digitizing by activating the editing mode. Long-pressing the button gives you immediate access to the main menu."),

Start with a Guided Tour. #5465

Start with a Guided Tour. #5465

Conversation

mohsenD98 commented Jul 22, 2024 • edited Loading

Enhanced First-Time User Experience (FTUE)

qfield-fairy commented Jul 22, 2024 • edited Loading

nirvn commented Jul 23, 2024

mohsenD98 commented Jul 23, 2024

suricactus commented Jul 24, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

m-kuhn commented Jul 25, 2024

mohsenD98 commented Jul 25, 2024

mohsenD98 commented Jul 25, 2024

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

mohsenD98 commented Jul 22, 2024 •

edited

Loading

qfield-fairy commented Jul 22, 2024 •

edited

Loading