From 0b97c21cccf45932d33e4771602db35ce36949be Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 00:53:13 +0700 Subject: [PATCH 1/5] update docs for wf --- docs/web-forms-intro.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e4c72d9e7..f60512f5d 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -49,8 +49,8 @@ b-forms?tab=readme-ov-file#feature-matrix>`_. While most supported functionality Web Forms currently supports 3 geo question types and appearances: * :ref:`Geopoint ` -* :ref:`Maps appearance ` -* :ref:`Placement-map appearance ` +* :ref:`Maps appearance ` +* :ref:`Placement-map appearance ` **Coming soon** From 1bec0a99b9ca16ca24171aadfa943a4dbd0e908e Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 00:58:17 +0700 Subject: [PATCH 2/5] fixes links --- docs/web-forms-intro.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index f60512f5d..e4c72d9e7 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -49,8 +49,8 @@ b-forms?tab=readme-ov-file#feature-matrix>`_. While most supported functionality Web Forms currently supports 3 geo question types and appearances: * :ref:`Geopoint ` -* :ref:`Maps appearance ` -* :ref:`Placement-map appearance ` +* :ref:`Maps appearance ` +* :ref:`Placement-map appearance ` **Coming soon** From 1e6a9a13defa844fa35aba7c6501f62fb3f12028 Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 01:07:35 +0700 Subject: [PATCH 3/5] update docs --- docs/img/web-forms/geoshape.png | 3 +++ docs/img/web-forms/geotrace.png | 3 +++ docs/web-forms-intro.rst | 34 ++++++++++++++++++++++++++------- 3 files changed, 33 insertions(+), 7 deletions(-) create mode 100644 docs/img/web-forms/geoshape.png create mode 100644 docs/img/web-forms/geotrace.png diff --git a/docs/img/web-forms/geoshape.png b/docs/img/web-forms/geoshape.png new file mode 100644 index 000000000..dc82df64e --- /dev/null +++ b/docs/img/web-forms/geoshape.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0807273d325b5410520126e5353271e8531d0b3b4572d195539e90be3f2fb774 +size 2208736 diff --git a/docs/img/web-forms/geotrace.png b/docs/img/web-forms/geotrace.png new file mode 100644 index 000000000..70fbb4b8b --- /dev/null +++ b/docs/img/web-forms/geotrace.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:eabec39687d7d0979702e7ebd50ba8b0b9a97d2a43ccdfab6743d26ac080ec28 +size 1532671 diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e4c72d9e7..b13dd9f45 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -46,17 +46,13 @@ Question types To know which question types are currently supported in Web Forms, see `the Github feature matrix `_. While most supported functionality is very similar to Collect's, this section describes question types with more complex functionality or that differ from Collect. -Web Forms currently supports 3 geo question types and appearances: +Web Forms currently supports 5 geo question types and appearances: * :ref:`Geopoint ` * :ref:`Maps appearance ` * :ref:`Placement-map appearance ` - -**Coming soon** - -- Geoshape -- Geotrace -- Editing all map appearances +* :ref:`Geoshape ` +* :ref:`Geotrace ` Geopoint without appearance ~~~~~~~~ @@ -95,6 +91,30 @@ For both `maps` and `placement-map` appearances, location capture stops when the .. image:: /img/web-forms/geopoint-placement-map-appearance.* :alt: Web forms geopoint with placement-map appearance +Geoshape +~~~~~~~~ + +The geoshape question type allows users to capture a polygon area on a map by adding at least three points to form a closed shape. + +The status bar shows `No points saved` when having less than 3 points. Long press to add points; the shape closes automatically and autosaves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. + +Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect; tap to reselect with vertices shown. Undo reverts the last change. + +.. image:: /img/web-forms/geoshape.* + :alt: Web forms geoshape + +Geotrace +~~~~~~~~ + +The geotrace question type allows users to capture a line on a map by adding at least two points. + +The status bar shows `No points saved` when having less than 2 points. Long press to add points; autosaves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. + +Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect; tap to reselect with vertices shown. Undo reverts the last change. + +.. image:: /img/web-forms/geotrace.* + :alt: Web forms geotrace + Image ~~~~~~~~ From 08f6e12924a73de5bc4999445b043945d22ff7be Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Sat, 20 Dec 2025 01:20:40 +0700 Subject: [PATCH 4/5] spelling --- docs/web-forms-intro.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index b13dd9f45..e802746b0 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -96,9 +96,9 @@ Geoshape The geoshape question type allows users to capture a polygon area on a map by adding at least three points to form a closed shape. -The status bar shows `No points saved` when having less than 3 points. Long press to add points; the shape closes automatically and autosaves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. +The status bar shows `No points saved` when having fewer than 3 points. Long-press to add points; the shape closes automatically and auto-saves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. -Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect; tap to reselect with vertices shown. Undo reverts the last change. +Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect. Undo reverts the last change. .. image:: /img/web-forms/geoshape.* :alt: Web forms geoshape @@ -108,9 +108,9 @@ Geotrace The geotrace question type allows users to capture a line on a map by adding at least two points. -The status bar shows `No points saved` when having less than 2 points. Long press to add points; autosaves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone and it’s larger. Long press to drag and move points. +The status bar shows `No points saved` when having fewer than 2 points. Long-press to add points; auto-saves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. -Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect; tap to reselect with vertices shown. Undo reverts the last change. +Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect. Undo reverts the last change. .. image:: /img/web-forms/geotrace.* :alt: Web forms geotrace From fb101628abb2daa93903c3a2215a1c5d160f872b Mon Sep 17 00:00:00 2001 From: latin-panda <66472237+latin-panda@users.noreply.github.com> Date: Fri, 27 Feb 2026 17:07:25 +0700 Subject: [PATCH 5/5] update docs --- .../web-forms/geopoint-maps-appearance.png | 4 ++-- .../geopoint-placement-map-appearance.png | 4 ++-- docs/img/web-forms/geoshape.png | 4 ++-- docs/img/web-forms/geotrace.png | 4 ++-- docs/img/web-forms/map-advanced-panel.png | 3 +++ docs/web-forms-intro.rst | 21 +++++++++---------- 6 files changed, 21 insertions(+), 19 deletions(-) create mode 100644 docs/img/web-forms/map-advanced-panel.png diff --git a/docs/img/web-forms/geopoint-maps-appearance.png b/docs/img/web-forms/geopoint-maps-appearance.png index 465488c19..9f6453962 100644 --- a/docs/img/web-forms/geopoint-maps-appearance.png +++ b/docs/img/web-forms/geopoint-maps-appearance.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:772395e13d8bf1b463ac938d11ffdc4caf831054eebe19e22e10873a0e669229 -size 2532104 +oid sha256:f97fb1f21f49f3a0b528dcf8d6dacabcb73b987fc6ed337931f2b9c8a86d007a +size 189735 diff --git a/docs/img/web-forms/geopoint-placement-map-appearance.png b/docs/img/web-forms/geopoint-placement-map-appearance.png index 90c529bdf..042952573 100644 --- a/docs/img/web-forms/geopoint-placement-map-appearance.png +++ b/docs/img/web-forms/geopoint-placement-map-appearance.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:bf0e08d22fcb743e84e161eac0b7626a83a7c416a6c5059bee52a0fe77183b04 -size 3082199 +oid sha256:e5dabb53a5b4470dcaf25c5104d0dabad7d9d841f3499ae61646181eaedf8413 +size 473274 diff --git a/docs/img/web-forms/geoshape.png b/docs/img/web-forms/geoshape.png index dc82df64e..7b49b5878 100644 --- a/docs/img/web-forms/geoshape.png +++ b/docs/img/web-forms/geoshape.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:0807273d325b5410520126e5353271e8531d0b3b4572d195539e90be3f2fb774 -size 2208736 +oid sha256:4b03e026c94e1afd23c83a373381a7a0a4db561eebb6a12a493f09a51f71c5da +size 212429 diff --git a/docs/img/web-forms/geotrace.png b/docs/img/web-forms/geotrace.png index 70fbb4b8b..dccb76f3b 100644 --- a/docs/img/web-forms/geotrace.png +++ b/docs/img/web-forms/geotrace.png @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:eabec39687d7d0979702e7ebd50ba8b0b9a97d2a43ccdfab6743d26ac080ec28 -size 1532671 +oid sha256:c68f1542592a6e049f13eca2d71494b8a902554d337a0496f650d724ef3d9953 +size 315009 diff --git a/docs/img/web-forms/map-advanced-panel.png b/docs/img/web-forms/map-advanced-panel.png new file mode 100644 index 000000000..82b491c9e --- /dev/null +++ b/docs/img/web-forms/map-advanced-panel.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:93e34056d363548160085fd9978c9aa748a5465364408d88e1b38ee1bde83cda +size 319405 diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e802746b0..09b9b53a8 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -76,7 +76,7 @@ Once location permissions are granted to Web Forms, it will start reading locati Geopoint with `maps` appearance ~~~~~~~~ -The `maps` appearance allows users to capture their current location while viewing it on a map. After tapping **Get location** and granting permissions, the map automatically zooms to the user’s current location. The user taps **Save point** to save the location. Once saved, the marker turns green to indicate success and the bottom panel displays **Point saved**. The user can remove the saved point and try again if needed. +The `maps` appearance allows users to capture their current location while viewing it on a map. After tapping **Get location** and granting permissions, the map automatically zooms to the user’s current location and saves the location. The marker turns green to indicate success and the bottom panel displays Point saved. The user can remove the saved point and try again if needed. .. image:: /img/web-forms/geopoint-maps-appearance.* :alt: Web forms geopoint with maps appearance @@ -84,7 +84,7 @@ The `maps` appearance allows users to capture their current location while viewi Geopoint with `placement-map` appearance ~~~~~~~~ -The `placement-map` appearance is similar to `maps`, but also allows the user to manually move the marker. If location permissions are granted, the map zooms to the user’s current location. The user can save the current location or manually place the marker by long-pressing on the map. The marker can be dragged to adjust the position. The user can remove the marker and try again at any time before moving on. +The `placement-map` appearance is similar to `maps`, but also allows the user to manually move the marker. If location permissions are granted, the map zooms to the user’s current location. The marker is saved by tapping on the map. The marker can be dragged to adjust the position. The user can remove the marker and try again at any time before moving on. For both `maps` and `placement-map` appearances, location capture stops when the user scrolls away from the question. @@ -94,11 +94,7 @@ For both `maps` and `placement-map` appearances, location capture stops when the Geoshape ~~~~~~~~ -The geoshape question type allows users to capture a polygon area on a map by adding at least three points to form a closed shape. - -The status bar shows `No points saved` when having fewer than 3 points. Long-press to add points; the shape closes automatically and auto-saves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. - -Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect. Undo reverts the last change. +A series of points that form a closed polygon. Points can be added by tapping the screen to place each point. Each coordinate is represented by small circles with outlines. These are connected by lines. The last point that was entered has a darker outline. Use the trash bin icon to delete the entire shape or the undo button to go back a step. .. image:: /img/web-forms/geoshape.* :alt: Web forms geoshape @@ -106,15 +102,18 @@ Select the shape to delete entirely (with confirmation); select a vertex to dele Geotrace ~~~~~~~~ -The geotrace question type allows users to capture a line on a map by adding at least two points. - -The status bar shows `No points saved` when having fewer than 2 points. Long-press to add points; auto-saves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. +A series of points. Identical to geoshape except that the first and last point may be different and at least 2 points are required. -Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect. Undo reverts the last change. +Points can be added by tapping the screen to place each point. Each coordinate is represented by small circles with outlines. These are connected by lines. The last point that was entered has a darker outline. .. image:: /img/web-forms/geotrace.* :alt: Web forms geotrace +For scenarios requiring precise coordinate adjustments, an advanced panel is available for manual data entry. Expanding this panel allows to specify the latitude, longitude, altitude, and accuracy for specific points. Additionally, use the import option to replace the existing trace or shape with external data. + +.. image:: /img/web-forms/map-advanced-panel.* + :alt: Web forms advanced panel for geoshape and geotrace + Image ~~~~~~~~