Skip to content

Commit 9abd5ef

Browse files
committed
update plugin variables
1 parent 6788e3e commit 9abd5ef

File tree

1 file changed

+17
-10
lines changed

1 file changed

+17
-10
lines changed

src/layer/variables/index.md

Lines changed: 17 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,19 +12,26 @@ Here you can find the lists of:
1212

1313
## Project and user variables
1414

15+
1516
The <QGISPluginName /> adds several variables that can be used in QGIS expressions:
1617

1718
| Variable name | Sample value | Scope | Description |
18-
|-----------------------------|-------------------------------|---------|-------------|
19-
| `@mergin_username` | `martin` | global | Name of the user currently logged in to <MainPlatformNameLink /> |
20-
| `@mergin_user_email` | `[email protected]` | global | Email of the user currently logged in to <MainPlatformName />|
21-
| `@mergin_url` | `https://app.merginmaps.com` | global | URL of the <MainPlatformName /> service |
22-
| `@mergin_project_name` | `Tree survey` | project | Name of the active <MainPlatformName /> project |
23-
| `@mergin_project_owner` | `martin` | project | Name of the owner of the active project |
24-
| `@mergin_project_full_name` | `martin/Tree survey` | project | Owner and project name joined with a forward slash |
25-
| `@mergin_project_version` | `42` | project | Current version of the active project |
26-
27-
A common use case is to use `@mergin_username` as the [default value](../default-values/) for one of the fields in a survey layer to automatically track who has added (and/or modified) a particular record.
19+
|-----------------------------|-------------------------------|---------|-------------
20+
| `@mm_full_name` | `martin second name` | global | Full name of the currently logged in user, blank if the full name is not set |
21+
| `@mm_username` | `martin` | global | Username of the user currently logged in to <MainPlatformNameLink /> |
22+
| `@mm_user_email` | `[email protected]` | global | Email of the user currently logged in to <MainPlatformName />|
23+
| `@mm_url` | `https://app.merginmaps.com` | global | URL of the <MainPlatformName /> service |
24+
| `@mm_project_name` | `Tree survey` | project | Name of the active <MainPlatformName /> project |
25+
| `@mm_project_full_name` | `martin/Tree survey` | project | Workspace and project name joined with a forward slash |
26+
| `@mm_project_version` | `42` | project | Current version of the active project |
27+
28+
A common use case is to use `@mm_username` or `@mm_user_email` as the [default value](../form-configuration/#default-values) for one of the fields in a survey layer to automatically track who has added (and/or modified) a particular record.
29+
30+
::: tip `mergin_` variable names still work!
31+
QGIS variables listed here previously used the prefix `mergin_`. Now we use the prefix `mm_` standing for <MainPlatformName />.
32+
33+
Both naming options are functional and will continue to work in the future: `@mergin_user_email` and `@mm_user_email` provide the same value when used in QGIS expressions.
34+
:::
2835

2936
## Position Variables
3037

0 commit comments

Comments
 (0)