Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| 44cefc2fe2 | |||
| 176bfaefe0 |
@@ -114,7 +114,7 @@ A personal parsing model has its own **Model reads images** switch, on or off. I
|
||||
|
||||
The upload is the normal booking import; the model simply works behind it.
|
||||
|
||||
1. In the trip, open the **Bookings** or **Transports** tab and click **Import booking confirmations** (the download icon in the bar). On a tab without bookings, the button reads **Import from file**.
|
||||
1. In the trip, open the **Bookings** or **Transports** tab and click **Import booking confirmations** (the upload icon in the bar). On a tab without bookings, the button reads **Import from file**.
|
||||
2. Drop your files onto the upload area: EML, PDF, PKPass, HTML or TXT, up to 5 files of 10 MB each. When the model reads images, photos (JPG, PNG, WEBP) are accepted too. Click **Import**.
|
||||
3. The dialog closes and a **background widget** in the bottom right corner shows *Parsing files…* with a count. You can keep working meanwhile; the widget survives a reload and follows you to other pages.
|
||||
4. When parsing is done, click **Import** in the widget.
|
||||
|
||||
@@ -68,7 +68,7 @@ Rest the pointer on a pill for *Check-in: Hotel Adler* or *Check-out: Hotel Adle
|
||||
|
||||
A stay whose booking is still **Pending** gets a dashed, tinted pill, and its tooltip ends in *(Pending)*. On the map, the hotel's marker is drawn with a dashed ring and a lighter face until the booking is **Confirmed**, see [Map Features](Map-Features#place-markers).
|
||||
|
||||

|
||||

|
||||
|
||||
## In the Reservations panel
|
||||
|
||||
|
||||
@@ -25,6 +25,8 @@ Click **New Category** (top right of the card). A dialog opens:
|
||||
|
||||
4. **Preview**: a chip shows how the category will look to users as you make selections.
|
||||
|
||||

|
||||
|
||||
Click **Create** to save.
|
||||
|
||||
## Editing a category
|
||||
|
||||
@@ -82,6 +82,8 @@ Each cell is a pill that cycles through three states when clicked, and saves at
|
||||
| **Off** | Switched off until the user turns it on. |
|
||||
| **Blocked** | Switched off for everyone. In each user's settings the cell shows a lock instead of a switch, and nothing is sent there. |
|
||||
|
||||

|
||||
|
||||
A default applies to every user who has not changed that cell themselves, including users who joined before you set it, so a later change reaches them too. A cell a user switched keeps the user's choice, unless you block it. The events themselves are listed in [Notifications](Notifications#notification-events).
|
||||
|
||||
## On a phone
|
||||
|
||||
@@ -46,7 +46,7 @@ In **Settings > API Keys**, the **Google Maps API Key** block has a collapsible
|
||||
|
||||
At the bottom of **Notifications**, **Defaults for users** is a matrix of every notification event against every channel. Each cell cycles through **On**, **Off** and **Blocked** when clicked and is saved right away; an event a channel cannot deliver shows a dash. **On** and **Off** are only where a user's settings start: each user may still change them. **Blocked** turns that event off on that channel for everyone, and it shows as locked in their settings. The defaults apply to every user who has not changed that cell themselves. See [Notifications](Notifications).
|
||||
|
||||

|
||||

|
||||
|
||||
The **Week starts on** default decides which day opens each row of every date picker for users who have not picked their own (Monday unless set).
|
||||
|
||||
|
||||
@@ -25,6 +25,8 @@ Both views share a toolbar: a **Search plugins…** box, a **Type** filter (Widg
|
||||
|
||||
## Installing from the registry
|
||||
|
||||

|
||||
|
||||
1. Switch to **Discover**. Each card shows the icon, name, author, description, type, a **Reviewed** badge if applicable, the **Signed**/**Unsigned** badge, the latest version, and a download count.
|
||||
2. Click a card to open the **pre-install review dialog** (see below).
|
||||
3. Click **Install**.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
The **Settings** tab (in the **Configuration** group of the admin side navigation, `/admin?tab=settings`) holds the instance-wide switches for signing in, uploads and place data. On a wide screen the cards sit in two columns: access and identity on the left (**Authentication Methods**, **Passkey login**, **Require two-factor authentication (2FA)**, **Single Sign-On (OIDC)**), files and place data on the right (**Allowed File Types**, **API Keys**). The **Danger Zone** runs across the full width at the bottom. On a narrow screen the same cards stack in that order.
|
||||
|
||||

|
||||
|
||||
Switches save as soon as you flip them. Text fields save with the card's own **Save** button. The phone admin has the same cards in its **Settings** section.
|
||||
|
||||
## Authentication Methods
|
||||
|
||||
@@ -4,6 +4,8 @@ The **Storage** tab (Admin Panel > Configuration > Storage) controls where TREK
|
||||
kind of content: which storage backends exist, which content category writes
|
||||
to which backend, and whether writes are replicated to additional backends.
|
||||
|
||||

|
||||
|
||||
## Backends
|
||||
|
||||
A backend is a named place bytes can live. Two exist out of the box:
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
The **User Defaults** tab (in the **Users** group of the admin side navigation, `/admin?tab=defaults`) sets instance-wide defaults for user settings. Users who have not changed a setting see these values; their own changes always take priority. The defaults are merged in every time a user's settings load, so a default you change later reaches everyone who never picked their own value.
|
||||
|
||||

|
||||

|
||||
|
||||
On a wide screen the tab has two cards side by side: **Default User Settings** on the left, **Map** on the right. On a narrow screen the map card follows below. The phone admin has the same tab as a section of its own.
|
||||
|
||||
@@ -73,6 +73,8 @@ Depending on the engine, more rows appear below it:
|
||||
| **3D buildings & terrain** | Mapbox (3D) | **On** or **Off**. On unless set otherwise. |
|
||||
| **High-quality mode** | Mapbox (3D) | **On** or **Off**. Off unless set otherwise. |
|
||||
|
||||

|
||||
|
||||
See [Map-Settings](Map-Settings) for the styles and what the two Mapbox switches do.
|
||||
|
||||
## See also
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Tune how TREK looks: colour mode, accent scheme, readability, and which dashboard widgets you see.
|
||||
|
||||

|
||||

|
||||
|
||||
## Where to find it
|
||||
|
||||
|
||||
@@ -77,6 +77,8 @@ Your Atlas statistics panel shows:
|
||||
|
||||
With the Tours addon on, the desktop panel has a third tab, **Tours**, next to **Stats** and **Bucket List**: what you have done on your tours across all your trips. Pick a **period** (all time, this year, the last 12 months or an earlier year) and a **tour type**, and the tab shows the distance with the number of tours at its corner, the ascent and descent, and the types with their distance. **Show tours** opens every tour of the period as a list.
|
||||
|
||||

|
||||
|
||||
- **When a tour counts.** A tour counts once the day it is on in a trip is over; a tour on several days once the last of them is over. A tour on no day, a tour only on days without a date and a tour whose day is still ahead do not count; the tab says how many of each there are.
|
||||
- **Planned or recorded.** Until you link the track you actually took in the tour's detail, a tour counts with the values of your planning, and it says so with a **Planned** badge: they are not measured. A linked actual track replaces those values for that tour, marked **Recorded**; it is never added on top, and the track itself is not counted as a tour of its own.
|
||||
- **Only your own part.** A day of a tour counts for you when it names you among its participants, or names nobody, which in the planner means everyone of the trip. A day that names only others counts for them, not for you.
|
||||
|
||||
@@ -4,7 +4,7 @@ Record what the trip costs, who put the money down and who it is shared with, an
|
||||
|
||||
> **Renamed to Costs (v3.3.0, #1464):** the feature is called **Costs** everywhere in the UI: the planner tab reads **Costs**, and so does its entry in Admin → Addons. Its internal addon id is still `budget`, which is why the permission is `budget_edit` and the MCP scopes are `budget:read` and `budget:write`.
|
||||
|
||||

|
||||

|
||||
|
||||
## Where to find it
|
||||
|
||||
@@ -194,7 +194,7 @@ With Costs on, the cost pills on the days of the plan and **Total Cost** at its
|
||||
|
||||
The table is a second way to read and plan the same expenses, close to the categorized budget sheet TREK had before Costs was rebuilt. Switch to it with the **Table** icon in the bar; **List** brings the ledger back. Search and filters apply to the table as well.
|
||||
|
||||

|
||||

|
||||
|
||||
- Expenses are grouped by **category**, in the order of the category pill, each group with how many entries it has and its subtotal. Click a category's header to fold it.
|
||||
- The columns are **Name**, **Date**, **Total**, **Persons** and **Days**, followed by the worked-out **Per Person**, **Per Day** and **P. p / Day** on their own grey ground. An expense with a custom (uneven) split leaves the per-person columns empty, since it has no single share per person.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Talk with everyone on the trip in real time, without leaving the planner.
|
||||
|
||||

|
||||

|
||||
|
||||
## Where to find it
|
||||
|
||||
|
||||
@@ -24,7 +24,7 @@ The dashboard also gains a **Collections widget** that surfaces your lists as co
|
||||
- **Edit or delete a list** from the **Edit** button in the list's hero (owner only). Deleting a list removes its saved places.
|
||||
- **All saved** is a built-in view that unions the places from every list you own or co-own, so you can search and act across your whole library at once.
|
||||
|
||||

|
||||

|
||||
|
||||
## Place status
|
||||
|
||||
@@ -43,7 +43,7 @@ You usually find out you have been somewhere while looking at the trip, not whil
|
||||
- The **Save to list** dialog on a trip place shows every list that already holds it, each with its own status pill. Tap a pill to cycle that list's status, or use **Visited everywhere** to mark all of them at once.
|
||||
- The places panel has **Mark visited in your lists** in its selection bar (and in the bulk toolbar on phones). Select the places (**Select all** covers the whole trip) and every saved copy of them is marked visited.
|
||||
|
||||

|
||||

|
||||
|
||||
Matching is by the place's provider id, its coordinates, or the link a place saved out of that trip already carries, so a copy you renamed inside a list is still found. Lists shared with you read-only are left alone.
|
||||
|
||||
|
||||
@@ -28,6 +28,8 @@ Only the **start** date is linked to the other one. Picking a start date fills t
|
||||
|
||||
The same dialog changes the dates of an existing trip later. The day plans follow their position, so new dates that hold fewer days take the last days of the plan away. When anything is planned on those days, the dialog lists it and asks before it saves; see [Shortening a trip](Day-Plans-and-Notes#shortening-a-trip). To make a trip one day longer without opening the dialog, add a day with the next date in the planner; see [Adding a day](Day-Plans-and-Notes#adding-a-day).
|
||||
|
||||

|
||||
|
||||
### Currency
|
||||
|
||||
The trip's currency, its **accounting base**. Every expense in the Costs tab is converted into it, and every balance and settle-up suggestion is calculated in it. The dialog pre-fills your own display currency (Settings > General > Language & region > *Display currency*); if you left that on **Trip currency**, it falls back to **EUR**. An administrator can preset the instance-wide value under Admin → **User Defaults**, which new users inherit until they pick their own. 165 currencies are available.
|
||||
|
||||
@@ -56,6 +56,8 @@ Every currency is shown with its own number of decimals. Most use two. The Japan
|
||||
|
||||
**Settings → General → Language & region → Display currency** is a **per-user, presentation-only** preference. It converts what you *read* in the Costs tab (totals, the category chart, balances, the settle-up amounts) into a single currency, so a trip with dollars, yen and roubles in it still adds up to one number you understand.
|
||||
|
||||

|
||||
|
||||
It never changes what is stored. Two people looking at the same trip can read it in different currencies and both see correct, consistent balances.
|
||||
|
||||
It has two modes:
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
The days column on the left of the Plan tab holds the itinerary: one card per day, with the places, bookings, transports, tours and notes of that day in order.
|
||||
|
||||

|
||||

|
||||
|
||||
## The Day Plan sidebar
|
||||
|
||||
@@ -167,7 +167,7 @@ At the foot of the column, **Total Cost** adds up every expense of the trip with
|
||||
|
||||
The selected day ends in its route bar, as long as the day can be routed: two or more places, one located place that the day's accommodation can frame, or a transfer day from one hotel to another. On a phone the same controls sit in the **Daily Overview** sheet.
|
||||
|
||||

|
||||

|
||||
|
||||
- **Route** draws the day's route on the map and puts the travel time between each pair of stops into the timeline.
|
||||
- **The travel mode**: Driving, Walking, Cycling, and any mode a plugin adds.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Keep tickets, confirmations, vouchers and photos with the trip, and tie each one to the places and bookings it belongs to.
|
||||
|
||||

|
||||

|
||||
|
||||
## Where to find it
|
||||
|
||||
@@ -14,8 +14,6 @@ The tab opens with the same bar as Transports, Bookings, Lists and Costs: **File
|
||||
|
||||
## Uploading
|
||||
|
||||

|
||||
|
||||
Drop files onto the dashed upload area under the bar, click it to open the file picker, or paste an image straight into the tab (Ctrl+V). Several files can go up at once.
|
||||
|
||||
When the upload is done and the trip has places or bookings, the **Assign File** dialog opens for the last file you uploaded, so you can tie it to a place or a booking right away (see [Linking files](#linking-files-to-places-reservations-or-assignments)). Close it if the file belongs nowhere in particular.
|
||||
@@ -93,6 +91,8 @@ A file can be tied to several places and bookings at once. The **Assign** pencil
|
||||
|
||||
Click an entry to tie the file to it, and click it again to untie it; a tied entry is highlighted with a check mark. Every click is saved at once, so the dialog has no save button: close it when you are done.
|
||||
|
||||

|
||||
|
||||
From the other side, the booking and transport editors have **Attach file** for a new file and **Link existing file** for one the trip already has. On the phone it is the **Link** pill in the Files row of the booking and transport sheets. The files of a booking appear in its detail popup, where **Show in files** brings you here, and the files of a place appear in the place inspector.
|
||||
|
||||
Linking needs the `file_edit` permission.
|
||||
|
||||
@@ -38,6 +38,8 @@ A screen that has sub-screens lists them under **Sub-screens**, folded: the trip
|
||||
columns, its panels and its tabs (including Place details, Day details and Road trip); Settings and the Admin panel fold their tabs; Journey folds the
|
||||
journal and the studio. Dashboard, Vacay, Atlas, Collections and the Notifications inbox have help of their own.
|
||||
|
||||

|
||||
|
||||
### Guides
|
||||
|
||||
A guide is one task, start to finish. It opens with the goal and a chip that says how long it is,
|
||||
@@ -52,6 +54,8 @@ A guide is one task, start to finish. It opens with the goal and a chip that say
|
||||
hides.
|
||||
4. **Related**, the guides that go with this one, and **In the docs**, the wiki pages behind it.
|
||||
|
||||

|
||||
|
||||
Some guides carry a button that takes you straight to the screen the task happens on.
|
||||
|
||||
### Search
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
TREK is a self-hosted, real-time collaborative travel planner licensed under AGPL-3.0.
|
||||
|
||||

|
||||

|
||||
|
||||
## Features
|
||||
|
||||
|
||||
@@ -34,6 +34,8 @@ The bundled directory is found automatically. `TREK_WIKI_DIR` overrides where TR
|
||||
|
||||
The left sidebar mirrors this wiki's own table of contents, parsed straight out of `_Sidebar.md`: the same sections, in the same order, with the same page titles. On screens narrower than desktop the sidebar collapses behind a **Contents** button that opens it as a drawer.
|
||||
|
||||

|
||||
|
||||
The page you are reading is highlighted with a chevron.
|
||||
|
||||
## Search
|
||||
|
||||
@@ -22,6 +22,8 @@ Invite links live in the **Invite Links** card under **Admin > Users**. Click **
|
||||
|
||||
**Add to trip (optional)**: bind the invite to any trip on the instance, not just your own. When someone registers through the link, they are automatically added to that trip as a member. Leave it on **No trip** for a plain registration invite. The selector only appears when at least one trip exists.
|
||||
|
||||

|
||||
|
||||
**Create & Copy** generates a 32-character hexadecimal token and copies the URL to your clipboard.
|
||||
|
||||
Each link in the list shows whether it is **Active**, **Expired** or **Used up**, how often it was used out of its limit, when it expires, the trip it adds to, and who created it. The copy button (**Copy link**) copies its URL again.
|
||||
|
||||
@@ -4,7 +4,7 @@ Journey is a photo-first travel journal. Each journey is linked to one or more o
|
||||
|
||||
> **Admin:** enable Journey in [Admin-Addons](Admin-Addons).
|
||||
|
||||

|
||||

|
||||
|
||||
## What Journey is
|
||||
|
||||
@@ -172,7 +172,7 @@ While you travel, the stays of each day can be ready for review without you star
|
||||
|
||||
**Place entries from their photos**, a switch under **Photos** in **Journey Settings**, goes one step further: an entry without a place takes the spot where its first photo with GPS was taken. Places you set yourself are never moved. It is off by default.
|
||||
|
||||

|
||||

|
||||
|
||||
## TREK Studio
|
||||
|
||||
|
||||
@@ -4,6 +4,8 @@ OAuth scopes control exactly which data your AI client can read or write in TREK
|
||||
|
||||

|
||||
|
||||

|
||||
|
||||
## All scopes
|
||||
|
||||
TREK defines 35 scopes across 17 groups.
|
||||
|
||||
@@ -2,6 +2,8 @@
|
||||
|
||||
TREK has a layout of its own for phones. It is the same app at the same address with the same data, drawn for one hand and a small screen: a floating bar at the bottom, sheets that slide up instead of dialogs, and a trip screen built around the day you are on. Install it to your home screen and it behaves like an app; see [Offline-Mode-and-PWA](Offline-Mode-and-PWA).
|
||||
|
||||

|
||||
|
||||
## When the phone layout applies
|
||||
|
||||
TREK switches to the phone layout when the window is narrower than 768 px, and also on a touch screen less than 500 px tall, so a phone turned on its side keeps the phone layout instead of jumping to the desktop planner. A tablet and a desktop window follow their width as usual. Turning the phone or resizing the window switches between the two layouts on the fly.
|
||||
|
||||
@@ -2,12 +2,14 @@
|
||||
|
||||
The dashboard at `/dashboard` is your home base — it lists all your trips, lets you create new ones, and surfaces quick-access widgets.
|
||||
|
||||

|
||||

|
||||
|
||||
## View Modes
|
||||
|
||||
Use the toggle button in the top toolbar to switch between **grid** (card thumbnails) and **list** (compact rows). Your preference is saved in `localStorage` under the key `trek_dashboard_view` and persists across sessions.
|
||||
|
||||

|
||||
|
||||
In both modes the dashboard shows a large [Spotlight card](#spotlight-card) for your most relevant trip at the top of the page — the toggle only changes how the trips below it are laid out. The spotlighted trip is taken out of that list when it earns the spot on its own: an ongoing trip, or the next upcoming one. If you have neither, the spotlight borrows your first trip for the header and that trip still shows up in the list below.
|
||||
|
||||
## Searching Trips
|
||||
@@ -69,6 +71,8 @@ On mobile, the header is a floating glass bar: the TREK logo on the left (tap it
|
||||
|
||||
On wide screens a sticky right column shows the **Currency**, **Collections** (only with the Collections addon enabled), **Timezones**, and **Upcoming reservations** widgets, plus any widget a plugin contributes. Each one is switched on or off separately for desktop and mobile under **Settings → Appearance → Dashboard widgets**; desktop also has a **Right sidebar** master toggle that removes the whole column, and the column disappears on its own once every widget in it is off.
|
||||
|
||||

|
||||
|
||||
On mobile, the same widgets are inline panels below the spotlight card, not a bottom sheet. By default the trip list comes first and the widgets stack underneath it. How they stack — and where the trip list sits among them — is set on the phone under **Settings → Appearance → Mobile → Dashboard order**.
|
||||
|
||||
See [Dashboard-Widgets](Dashboard-Widgets) for full usage details.
|
||||
|
||||
@@ -14,6 +14,8 @@ The bell in the navigation bar shows how many notifications you have not read ye
|
||||
|
||||
Following a notification from the panel closes it. New notifications arrive live over TREK's connection, so the count and the panel update without a reload.
|
||||
|
||||

|
||||
|
||||
## The inbox page
|
||||
|
||||
The page lists every notification, newest first, and loads older ones as you scroll down.
|
||||
|
||||
@@ -92,6 +92,8 @@ A default applies to every cell you have not changed yourself, so when the admin
|
||||
|
||||
## Webhook configuration
|
||||
|
||||

|
||||
|
||||
Enter a URL that TREK will POST to when a notification fires. Once saved, the URL is displayed as `••••••••`. Use the **Test** button to send a test payload to the saved URL.
|
||||
|
||||
TREK auto-detects the webhook destination and adjusts the payload format:
|
||||
@@ -191,7 +193,9 @@ The bell icon in the navigation bar shows your unread notification count. Click
|
||||
- Mark all notifications read at once.
|
||||
- Delete individual notifications or clear all at once.
|
||||
- Answer **boolean notifications**, which ask a yes-or-no question, with their two buttons directly in the panel.
|
||||
- Click **Show all notifications** to open the full page at `/notifications`, with **All** and **Unread** pills, **Mark all read** and **Delete all** (which asks *Delete all notifications?* first). On a phone the inbox is its own screen. With nothing in it, the page reads *No notifications* and *You're all caught up!*.
|
||||
- Click **Show all notifications** to open the full page at `/notifications`, with **All** and **Unread** pills, **Mark all read** and **Delete all** (which asks *Delete all notifications?* first). On a phone the inbox is its own screen. With nothing in it, the page reads *No notifications*; the bell's panel adds *You're all caught up!*.
|
||||
|
||||

|
||||
|
||||
In-app notifications are pushed in real time via WebSocket so the badge and panel update without a page refresh.
|
||||
|
||||
|
||||
@@ -89,6 +89,8 @@ A small pill floats at the bottom centre of the window (just above the tab bar o
|
||||
|
||||
On a phone, **Settings** has its own **Offline** screen with the same controls as the desktop tab.
|
||||
|
||||

|
||||
|
||||
### Offline mode
|
||||
|
||||
- **Force offline mode** — a switch that first downloads everything you need (see *Prepare for offline* below) and then routes the whole app to the local cache, queueing every change you make. Flip it back off to reconnect: queued changes are replayed and the cache is refreshed. The override is remembered across app restarts, so a session forced offline before a flight stays offline when the PWA relaunches.
|
||||
|
||||
@@ -60,6 +60,8 @@ Under the header:
|
||||
- **Notes**: the icon, the text and the time, if set
|
||||
- **Bookings**: the type icon, the title, the time, the notes of a transport (unless **Transport notes** is off), the details that fit the type (airline, flight number and route for a flight; train number, platform and seat for a train; party size for a restaurant; the venue for an event; the operator for a tour), the location and the booking code
|
||||
|
||||

|
||||
|
||||
### Footer
|
||||
|
||||
Every printed page carries a small "made with TREK" logo at the bottom.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Build the trip's packing list together: items grouped into lists, ticked off as they go into the bag, shared with the group or kept to yourself, and, if you like, weighed per bag.
|
||||
|
||||

|
||||

|
||||
|
||||
## Where to find it
|
||||
|
||||
|
||||
@@ -2,9 +2,9 @@
|
||||
|
||||
Reuse packing lists across trips using pre-built templates.
|
||||
|
||||
The screenshot shows where admins build templates, the **Packing Templates** card on **Admin > Personalization**. Applying a template is described below.
|
||||
The screenshot shows the **Apply template** menu in the Lists bar of a trip's packing list. Admins build the templates on the **Packing Templates** card on **Admin > Personalization**, see [Admin-Packing-Templates](Admin-Packing-Templates).
|
||||
|
||||

|
||||

|
||||
|
||||
## Applying a template
|
||||
|
||||
|
||||
@@ -41,6 +41,8 @@ Each entry in the list shows its name, a **Synced** or **This device** badge, th
|
||||
- **Rename** (pencil icon): edit the name inline; press Enter to save, Escape to cancel. Names are capped at 60 characters.
|
||||
- **Delete** (trash icon): confirms with *Remove this passkey? Confirm with your password.* and requires your current password.
|
||||
|
||||

|
||||
|
||||
Removing every passkey can never lock you out; your password always remains as a fallback.
|
||||
|
||||
> **Admin:** In **Admin → Users**, editing a user exposes a **Reset passkeys** action that removes all of that user's passkeys at once (for a lost device). The user can still sign in with their password.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Places are the building blocks of a trip: sights, restaurants, hotels, stations, trailheads. You add them by searching, by pasting a map link, by typing coordinates, from your saved places, by right-clicking the map or by importing a file or a list.
|
||||
|
||||

|
||||

|
||||
|
||||
## The places column
|
||||
|
||||
@@ -17,6 +17,8 @@ The right column of the Plan tab lists every place of the trip. Its head band ha
|
||||
- **Filter by country or region** (the globe): every country the trip's places lie in, with its regions underneath, each with the number of places in it. Pick a country or one region; **All countries** is the default and **Clear filter** goes back to it. The button only appears once the trip spans more than one country or region.
|
||||
- **Sort by**: newest first (**Recently added**, the default), **Oldest first**, by name, **Highest rated** or **Recently changed**. The order applies to the list only, not to the map, and your browser remembers it.
|
||||
|
||||

|
||||
|
||||
With a day open and **Planned** chosen, the list shows only that day's places, and a chip says **Showing the open day only**. Its **X** (*Show the whole trip*) closes the day. See [Trip Planner Overview](Trip-Planner-Overview#layout).
|
||||
|
||||
Each row shows the place's photo or category tile, a short stroke in the track's colour for an imported track, the category icon, the name, the average member rating, and a line with the description or the address. Click a row to open the [place inspector](#the-place-inspector), or drag it onto a day. While a day is open, a place that is not on it yet shows a **+** (*+ Day*) that puts it on that day.
|
||||
@@ -47,7 +49,7 @@ Click **Select** (the tick next to the search field) to switch the list into sel
|
||||
|
||||
**Add Place/Activity** and **Edit Place** are the same dialog.
|
||||
|
||||

|
||||

|
||||
|
||||
- **The head band** holds the name, which you type straight into the band, and the category as a pill. The **+** next to the pill (*New category*) turns it into a field for a new category's name; **OK** or Enter creates it, **Cancel** or Escape closes the field. Categories are shared by the whole instance, so creating one takes an admin account (see [Tags and Categories](Tags-and-Categories)). After a search pick, a pill names where the place came from. Once the place has coordinates, the round **Open in maps** pill opens it in a map app, the same menu as **Navigation** (see [Opening a place in a map app](#opening-a-place-in-a-map-app)).
|
||||
- **Search** finds the place and fills in the rest, see [Searching for a place](#searching-for-a-place). A place picked from the search, or from a marker of the [map categories](#exploring-the-map-by-category), comes with the matching category already picked when the trip's palette has one (a hotel goes to the category named like Hotel or Accommodation, a café to Café or Bar, and so on). A category you chose yourself is never replaced.
|
||||
@@ -250,7 +252,7 @@ Amap links work the same way, as long as the link carries a coordinate: `uri.ama
|
||||
|
||||
Click a place in the places column, in a day, or on the map, and its inspector opens over the map.
|
||||
|
||||

|
||||

|
||||
|
||||
- **The head band** shows the photo (a click opens it in a gallery, see [The photo gallery](#the-photo-gallery)), with a green ring while the place is open and a red one while it is closed, the name (double-click it to rename the place), the address on one line with the full address in a tooltip, and pills: **Open** or **Closed**, the category, the time of the visit, the Google rating, the phone number to call, the e-mail address, and the coordinates. **X** closes the inspector.
|
||||
- **Rating**: every member's vote, see [Rating a place](#rating-a-place).
|
||||
@@ -276,6 +278,8 @@ Saved places in [Collections](Collections) are rated the same way. Saving a trip
|
||||
|
||||
Click the round photo in the head band of the place inspector, or the photo in the phone's place sheet, to open a full screen gallery of the place's own picture and the photos its sources know, each with its credit. While there is nothing to show, the photo is just a picture and does not open.
|
||||
|
||||

|
||||
|
||||
## Custom place image
|
||||
|
||||
By default a place's thumbnail is fetched automatically (from Google or Wikimedia when the place was imported or matched, otherwise it shows a category icon). The picture is changed in the place editor, under **Pick a picture** (open the place and click **Edit**). It is a grid of tiles:
|
||||
|
||||
@@ -56,6 +56,8 @@ On first boot TREK automatically seeds an admin account before any user register
|
||||
|
||||
You will be prompted to change the password on first login.
|
||||
|
||||

|
||||
|
||||
Once an admin has set up [OIDC / SSO](OIDC-SSO) or [Passkeys](Passkeys), the login page offers those ways in as well, next to the password form (*Sign in with* followed by the provider's name, or *Sign in with a passkey*).
|
||||
|
||||
**Moving an existing TREK?** Instead of setting up a new admin, start the new install with `RESTORE_FROM_BACKUP` pointing at a backup ZIP inside the container (for example `-e RESTORE_FROM_BACKUP=/app/data/backup.zip` with the file placed in `./data`). On that first start TREK restores the backup before any setup and creates no admin account; sign in with an account from the backup. See [Backups](Backups#restoring-on-a-new-install-before-setup).
|
||||
|
||||
@@ -8,7 +8,7 @@ Everything you booked for a trip that is not a way of getting around: hotels, re
|
||||
|
||||
Open a trip and select the **Bookings** tab. It lists accommodation, restaurant, event, tour, parking and other bookings. Transport records never show up here; they stay on the **Transports** tab, which works the same way and is described on [its own page](Transport-Flights-Trains-Cars).
|
||||
|
||||
The tab starts with a bar like the other planner tabs. The name sits on the left. On the right are a search box, **Filter**, the switch between **Cards**, **List** and **Timeline**, **View options** and **Export as spreadsheet (CSV)** (the spreadsheet icon, see [Exporting as CSV](#exporting-as-csv)). If you may edit bookings, the bar ends with **Import booking confirmations** (the download icon, shown when your server can [import confirmations](#import-from-booking-confirmation)) and **Manual Booking**.
|
||||
The tab starts with a bar like the other planner tabs. The name sits on the left. On the right are a search box, **Filter**, the switch between **Cards**, **List** and **Timeline**, **View options** and **Export as spreadsheet (CSV)** (the download icon, see [Exporting as CSV](#exporting-as-csv)). If you may edit bookings, the bar ends with **Import booking confirmations** (the upload icon, shown when your server can [import confirmations](#import-from-booking-confirmation)) and **Manual Booking**.
|
||||
|
||||
A trip without any bookings shows *No reservations yet* instead, with **Manual Booking** and **Import from file** as buttons right under it.
|
||||
|
||||
@@ -82,7 +82,7 @@ A number on the Filter button counts what is switched on, and a chip such as *3
|
||||
|
||||
## Exporting as CSV
|
||||
|
||||
**Export as spreadsheet (CSV)**, the spreadsheet icon after **View options**, downloads the bookings as a CSV file. It holds exactly what the tab shows: the search and the filters apply, and the rows follow **Sort by** from the view options (the grouping is left out, one row per booking). The columns are **Type**, **Title**, **Status**, **Start**, **End**, **From**, **To**, **Location**, **Confirmation** and **Notes**; **From** and **To** are filled for bookings with a route. The file is semicolon-separated with a UTF-8 byte-order mark, so Excel opens it cleanly, and is named after the trip and the tab, such as `berlin-2026-bookings.csv`. A cell that would start with `=`, `+`, `-` or `@` gets a leading apostrophe, so a spreadsheet never runs it as a formula.
|
||||
**Export as spreadsheet (CSV)**, the download icon after **View options**, downloads the bookings as a CSV file. It holds exactly what the tab shows: the search and the filters apply, and the rows follow **Sort by** from the view options (the grouping is left out, one row per booking). The columns are **Type**, **Title**, **Status**, **Start**, **End**, **From**, **To**, **Location**, **Confirmation** and **Notes**; **From** and **To** are filled for bookings with a route. The file is semicolon-separated with a UTF-8 byte-order mark, so Excel opens it cleanly, and is named after the trip and the tab, such as `berlin-2026-bookings.csv`. A cell that would start with `=`, `+`, `-` or `@` gets a leading apostrophe, so a spreadsheet never runs it as a formula.
|
||||
|
||||
While a search or filter is active, the button's tooltip reads *Export the {shown} of {total} shown rows (CSV)*. The button is there for every member who can see the tab, as soon as it has at least one booking. The Transports tab exports its own list the same way.
|
||||
|
||||
@@ -181,7 +181,7 @@ Up to 5 files per import, 10 MB each. A photo always goes to the AI model, never
|
||||
|
||||
### How to import
|
||||
|
||||
1. On the **Bookings** or the **Transports** tab, click **Import booking confirmations** (the download icon in the bar). On a tab without bookings the button reads **Import from file**.
|
||||
1. On the **Bookings** or the **Transports** tab, click **Import booking confirmations** (the upload icon in the bar). On a tab without bookings the button reads **Import from file**.
|
||||
2. Drop your files onto the upload area, or click it to pick them, then click **Import**.
|
||||
3. The dialog closes and a widget in the bottom right corner shows *Parsing files…*, with a count when there are several files. You can keep working meanwhile: the widget follows you to other pages and survives a reload.
|
||||
4. When it is done, click **Import** in the widget.
|
||||
|
||||
@@ -31,6 +31,8 @@ In **Road trip** the planner changes shape:
|
||||
| Map | the selected day | every day of the trip. **Fold** on a day card takes that day off the map as well |
|
||||
| Right column | the places list | **Along the route** (the search, see below) and the **Driving settings** card |
|
||||
|
||||

|
||||
|
||||
The map's category pills still work, so you can look around what is in view as well as along the drive; a place both searches find is drawn once. **Show whole trip** is not offered, because this view already draws the whole trip.
|
||||
|
||||
The drive is built from the places planned on each day. Plan the places the trip is for under **Days** as usual, or import them (see [Importing a Google Maps route](#importing-a-google-maps-route)). A day is routed once it has two places with coordinates; a day with fewer shows an empty card you can drop a stop onto, and a place without coordinates is left out of the drive. In the rail, drag a stop to reorder its day or to move it to another day, or focus it with the keyboard and press Alt with the up or down arrow.
|
||||
@@ -149,6 +151,8 @@ The **Driving settings** card sits under the search in the right column. Its bad
|
||||
| **Route line** | **Connect the days**, **Start and end each day at your stay**, **A colour per day** |
|
||||
| **Current warnings** | **Show hazard areas** |
|
||||
|
||||

|
||||
|
||||
**Connect the days** routes the drive from one day's last stop to the next day's first and counts it towards the day it arrives on. It is off by default, and always on while daily travel times are set. **Start and end each day at your stay** is off by default too, see [Starting and ending the day at the stay](#starting-and-ending-the-day-at-the-stay). **A colour per day** draws each day in its own colour and tints its card to match.
|
||||
|
||||
## Driving limits and range
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
TREK works out the driving, walking and cycling times between the places of a day, draws the route on the map, can reorder the places into a shorter route, and hands the day to a map app for navigation. All of it sits in the route bar at the foot of the selected day.
|
||||
|
||||

|
||||

|
||||
|
||||
## The route bar
|
||||
|
||||
|
||||
@@ -63,6 +63,8 @@ An element that auto layout tied to a journal entry follows that entry, so a cor
|
||||
|
||||
**Designed pages** come first: pages laid out by a designer, 48 for the cover and the other single pages and 60 double spreads, in twelve styles (**Spine band**, **Poster**, **Cut-out**, **Postcard**, **Grid and badge**, **Minimal**, **Stamps**, **Riso**, **Editorial**, **Vintage poster**, **Night film** and **Field notes**). Each card shows the page you are on as the click would lay it, with its own photos and words and in the book's theme. The **Style** chips narrow the set to one look. What a design has no room for stays with the page.
|
||||
|
||||

|
||||
|
||||
Below come **My layouts** and the **Built in** ones: thirteen spread layouts (**Hero and story**, **Four up**, **Strip and text**, **Mosaic** and more) and five for the cover and back.
|
||||
|
||||
**Save this page as a layout** keeps the arrangement of a page without its photos, for every editor of this book. Applying it lays another page out the same way and keeps that page's photos and words. A book keeps up to 24 layouts.
|
||||
|
||||
@@ -23,6 +23,8 @@ Categories appear in:
|
||||
- **Map hover cards**: resting the pointer on a marker shows the category with the place's name and address.
|
||||
- **Saved places** in [Collections](Collections), which use the same set.
|
||||
|
||||

|
||||
|
||||
A place picked from the search or from a marker of the map's category buttons comes with a matching category already picked, when the palette has one whose name or icon fits (a hotel goes to a category such as Hotel or Accommodation, a museum to Sights or Museum). Pick another one and it stays yours. See [The place form](Places-and-Search#the-place-form).
|
||||
|
||||
> **Admin:** Create and manage categories in [Admin-Categories](Admin-Categories), or create one on the spot with the **+** (*New category*) next to the category pill in the head band of the place form. Only admins can create, edit, or delete categories. All users can read them.
|
||||
|
||||
@@ -13,6 +13,8 @@ With the AI Assistant addon on, the assistant can look for tours and propose the
|
||||
|
||||
While the Tours add-on is on, the right column of the Plan tab has a switch at its top: **Places** and **Tours**. **Tours** replaces the places list with every tour of the trip, so you can plan them next to the days. Tours never appear in the Places list while the add-on is on; a GPX or KML track you import is always a tour.
|
||||
|
||||

|
||||
|
||||
Each row shows:
|
||||
|
||||
- a coloured bar: the colour of the tour's line on the map,
|
||||
@@ -104,6 +106,8 @@ A tour opens a card of its own over the map on the **Plan** tab, the counterpart
|
||||
|
||||
The map stays usable while the card is open, and **Escape** or the **X** in the head closes it.
|
||||
|
||||

|
||||
|
||||
The head shows the tour's round tile, its name and a row of pills: the type (Hike, Bike tour, Run, Ski & winter, Paddle tour, City / sightseeing walk, Horse ride), a run's profile and pace or a ski tour's discipline, a paddle tour's boat and water, where an imported tour came from, the planned time, the distance, the ascent and the descent. The time pill's tooltip lists its parts: the time on the move, the breaks and the planned total, or for a city walk the walking time and the stays. An amber **use with caution** pill marks an import whose heights or measures are incomplete.
|
||||
|
||||
The body holds, as far as they apply:
|
||||
@@ -186,6 +190,8 @@ The tab has three parts:
|
||||
| Map | **Search place or address** at the top moves the map. The pill at the bottom left switches the map and holds the switches of the open tour. |
|
||||
| Right rail, **Tours of this trip** | **Tour summary** of the tour in the editor, the filter, **Trip totals** and the list of every tour of the trip. The plus in its head, **Add tour**, offers **Import GPX or KML**, **Import walk from Google Maps**, **Take over a tour from another trip** and, while a tour is open, **Plan new tour**. |
|
||||
|
||||

|
||||
|
||||
**Collapse**, on the tab at the inner edge of each rail, folds the rail away; **Plan** and **Tours of this trip** bring them back. A rail's edge can be dragged to make it wider or narrower. GPX, KML and KMZ files dropped anywhere on the tab are imported as tours of the trip.
|
||||
|
||||
The maps the pill offers depend on the type of the open tour: **Map** and **Satellite** always, **Topo** for a hike, a run, a bike tour, a horse ride and a ski and winter tour, **Hiking** for a hike and **Cycling** for a bike tour where an admin has those maps on. **3D** shows the landscape, **Via ferratas** the ferratas around a hike, and **Set points** is the switch that lets a click on the map set a point.
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
Flights, trains, rental cars, ferries and every other ride of a trip, with their departure and arrival points, local times and the details that come with each kind of ticket. Public transit connections can be looked up and added to a day in a few clicks.
|
||||
|
||||

|
||||

|
||||
|
||||
## Where to create
|
||||
|
||||
@@ -33,7 +33,7 @@ The tab works exactly like the Bookings tab: the same bar with search, **Filter*
|
||||
|
||||
## The transport editor
|
||||
|
||||

|
||||

|
||||
|
||||
The head band holds the title, which you type straight into it, and three controls next to each other:
|
||||
|
||||
@@ -126,7 +126,7 @@ A transport you save while offline waits in a queue and is sent when TREK is bac
|
||||
|
||||
Click a transport anywhere, on its card, in the day plan, on the map or in the road trip rail, and its detail opens.
|
||||
|
||||

|
||||

|
||||
|
||||
For a transport, the tiles at the top show the departure and arrival times with their airports or stations, and the platform and seat when they are set. A route with stops lists every stop with its time. The foot of the detail has **On map**, which switches the route's line on and opens the plan on its day, **Delete** and **Edit**. See [The booking detail](Reservations-and-Bookings#the-booking-detail) for everything else it shows.
|
||||
|
||||
@@ -160,7 +160,7 @@ A rental car in its middle days is not a row but a pill in the day's head band.
|
||||
|
||||
Drag a transport row to move it within its day or onto another day. The rows of a flight or train with stops, and the middle days of a longer ride, stay where their times put them. Click a row to open its detail.
|
||||
|
||||

|
||||

|
||||
|
||||
A booking that is pinned to a stop on another day shows at that stop only, not on two days. The dashboard's upcoming reservations leave out planned public transit.
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Trip Members and Sharing
|
||||
|
||||

|
||||

|
||||
|
||||
## Opening the Trip settings
|
||||
|
||||
@@ -96,6 +96,8 @@ There is no limit on the number of guests per trip.
|
||||
|
||||
The **Sharing** area is only visible to users with the `share_manage` permission (default: trip owner). Its first section is **Public Link**.
|
||||
|
||||

|
||||
|
||||
A share link creates a **read-only, token-based URL**:
|
||||
|
||||
```
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
The trip planner is where a trip is built. Open it by clicking a trip card on the [dashboard](My-Trips-Dashboard).
|
||||
|
||||

|
||||

|
||||
|
||||
## Layout
|
||||
|
||||
|
||||
@@ -53,6 +53,8 @@ The area then shows the journal's cover and title, **Linked**, and what you may
|
||||
- **Change journal** links another of your journals instead.
|
||||
- **Unlink** removes the link. *The Journal tab disappears from this trip. Members who could only open the journal through this trip lose access; people you added in the journal itself keep theirs.*
|
||||
|
||||

|
||||
|
||||
The access a link gives lasts as long as the link holds a member and that member stays on the trip. Someone who leaves the trip loses the access they had through it.
|
||||
|
||||
### Who may link
|
||||
|
||||
@@ -85,7 +85,7 @@ Each GL provider keeps its own saved style, so switching between Mapbox GL and M
|
||||
|
||||
## Account tab summary
|
||||
|
||||

|
||||

|
||||
|
||||
The Account tab is a stack of separate cards:
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
TREK shows a weather forecast for every dated day of a trip, and a climate estimate for days too far ahead for a forecast. The data comes from Open-Meteo, so no API key is needed.
|
||||
|
||||

|
||||

|
||||
|
||||
## Where forecasts appear
|
||||
|
||||
|
||||
|
Before Width: | Height: | Size: 127 KiB After Width: | Height: | Size: 67 KiB |
|
Before Width: | Height: | Size: 179 KiB After Width: | Height: | Size: 99 KiB |
|
After Width: | Height: | Size: 49 KiB |
|
Before Width: | Height: | Size: 162 KiB After Width: | Height: | Size: 53 KiB |
|
After Width: | Height: | Size: 159 KiB |
|
Before Width: | Height: | Size: 162 KiB After Width: | Height: | Size: 45 KiB |
|
After Width: | Height: | Size: 68 KiB |
|
After Width: | Height: | Size: 47 KiB |
|
After Width: | Height: | Size: 102 KiB |
|
Before Width: | Height: | Size: 149 KiB After Width: | Height: | Size: 172 KiB |
|
Before Width: | Height: | Size: 312 KiB After Width: | Height: | Size: 132 KiB |
|
After Width: | Height: | Size: 134 KiB |
|
Before Width: | Height: | Size: 204 KiB After Width: | Height: | Size: 62 KiB |
|
Before Width: | Height: | Size: 134 KiB After Width: | Height: | Size: 43 KiB |
|
Before Width: | Height: | Size: 49 KiB After Width: | Height: | Size: 137 KiB |
|
Before Width: | Height: | Size: 102 KiB After Width: | Height: | Size: 118 KiB |
|
Before Width: | Height: | Size: 211 KiB After Width: | Height: | Size: 49 KiB |
|
Before Width: | Height: | Size: 153 KiB After Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 113 KiB After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 92 KiB |
|
Before Width: | Height: | Size: 128 KiB After Width: | Height: | Size: 39 KiB |
|
Before Width: | Height: | Size: 249 KiB After Width: | Height: | Size: 64 KiB |
|
Before Width: | Height: | Size: 98 KiB After Width: | Height: | Size: 31 KiB |
|
Before Width: | Height: | Size: 60 KiB After Width: | Height: | Size: 36 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 30 KiB |
|
Before Width: | Height: | Size: 517 KiB After Width: | Height: | Size: 226 KiB |
|
Before Width: | Height: | Size: 535 KiB After Width: | Height: | Size: 165 KiB |
|
Before Width: | Height: | Size: 186 KiB After Width: | Height: | Size: 63 KiB |
|
Before Width: | Height: | Size: 38 KiB After Width: | Height: | Size: 140 KiB |
|
Before Width: | Height: | Size: 191 KiB After Width: | Height: | Size: 58 KiB |
|
After Width: | Height: | Size: 427 KiB |
|
Before Width: | Height: | Size: 403 KiB After Width: | Height: | Size: 232 KiB |
|
Before Width: | Height: | Size: 588 KiB After Width: | Height: | Size: 332 KiB |
|
After Width: | Height: | Size: 166 KiB |
|
After Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 133 KiB After Width: | Height: | Size: 103 KiB |
|
Before Width: | Height: | Size: 114 KiB After Width: | Height: | Size: 126 KiB |
|
Before Width: | Height: | Size: 66 KiB After Width: | Height: | Size: 276 KiB |
|
Before Width: | Height: | Size: 152 KiB After Width: | Height: | Size: 40 KiB |
|
After Width: | Height: | Size: 133 KiB |
|
Before Width: | Height: | Size: 158 KiB After Width: | Height: | Size: 56 KiB |
|
After Width: | Height: | Size: 59 KiB |
|
After Width: | Height: | Size: 94 KiB |
|
Before Width: | Height: | Size: 324 KiB After Width: | Height: | Size: 226 KiB |
|
After Width: | Height: | Size: 140 KiB |
|
Before Width: | Height: | Size: 49 KiB After Width: | Height: | Size: 196 KiB |
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 56 KiB |
|
Before Width: | Height: | Size: 84 KiB After Width: | Height: | Size: 331 KiB |
|
Before Width: | Height: | Size: 277 KiB After Width: | Height: | Size: 344 KiB |
|
Before Width: | Height: | Size: 469 KiB After Width: | Height: | Size: 143 KiB |
|
Before Width: | Height: | Size: 119 KiB After Width: | Height: | Size: 32 KiB |
|
Before Width: | Height: | Size: 184 KiB After Width: | Height: | Size: 76 KiB |
|
Before Width: | Height: | Size: 469 KiB After Width: | Height: | Size: 415 KiB |