mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-11-12 23:31:02 +00:00
docs(wiki): describe the cover photo search, the new start date step and offline edits of a trip, and the dashboard's hero badge, stat tiles and Idea cards
This commit is contained in:
+11
-1
@@ -43,7 +43,7 @@ The cover image is displayed on the trip card and as the background of the Spotl
|
||||
- **Drag and drop** an image file onto the dashed upload area.
|
||||
- **Paste from clipboard**: if you have an image in your clipboard, paste it anywhere in the dialog.
|
||||
- **File picker**: click the upload area to browse for a file.
|
||||
- **Search Unsplash**: type a query to pick a stock photo. If this returns *"Unsplash search unavailable"* (common on VPS/datacenter IPs), configure a free Unsplash Access Key; see [Environment-Variables → Image Search (Unsplash)](Environment-Variables#image-search-unsplash).
|
||||
- **Search Unsplash**: type a query into the **Search destination photos** field and click **Search Unsplash** to pick a stock photo. With the field empty, the button searches for the trip title. If this returns *"Unsplash search unavailable"* (common on VPS/datacenter IPs), configure a free Unsplash Access Key; see [Environment-Variables → Image Search (Unsplash)](Environment-Variables#image-search-unsplash).
|
||||
|
||||
When **creating** a new trip the cover image field is always visible. When **editing** an existing trip it is only shown if you have the `trip_cover_upload` permission. For a new trip, the image is uploaded immediately after the trip is created.
|
||||
|
||||
@@ -69,6 +69,16 @@ A new trip starts on **3 days**. If reminders are switched off on your instance,
|
||||
|
||||
Add initial trip members under **Travel buddies**. On a **new** trip, selected members are queued locally and added to the trip immediately after it is saved. The selector shows all registered users on your instance except yourself.
|
||||
|
||||
Once the trip exists, people are managed from the planner instead: the **Trip settings** pill in the top bar opens **People** (members and guests without an account) and **Sharing** (the read-only link and the invite link). See [Trip-Members-and-Sharing](Trip-Members-and-Sharing).
|
||||
|
||||
## Changing the start date
|
||||
|
||||
When you move the start date of an existing trip, a step called **New start date** asks how your plans follow: **Keep bookings on their dates** moves the day plans with the new dates while reservations and accommodations stay on their original dates as long as those are still part of the trip, and **Shift everything** moves the entire itinerary, bookings included. If the new dates hold fewer days than the plan, a **Remove days?** step lists what goes first; see [Shortening a trip](Day-Plans-and-Notes#shortening-a-trip).
|
||||
|
||||
## Editing offline
|
||||
|
||||
Editing a trip uses this same dialog. While you are offline, the name, description and reminder can be changed, and they are sent when the connection is back. New dates, a different number of days, another currency or a new cover need a connection.
|
||||
|
||||
## Saving
|
||||
|
||||
Click **Create New Trip** (when editing, the button reads **Update**). The trip is saved, the dialog closes and a *"Trip created successfully!"* toast confirms it, and you stay on the dashboard. The new trip is sorted into the trip list by its dates; click its card (or the Spotlight card, if it is the trip that earns that spot) to open the [Trip-Planner-Overview](Trip-Planner-Overview).
|
||||
|
||||
@@ -36,17 +36,34 @@ Trips without dates are treated as past.
|
||||
|
||||
## Spotlight Card
|
||||
|
||||
The first ongoing trip — or the next upcoming trip if none is ongoing — is promoted to a full-width **Spotlight card** at the top of the grid on desktop, where it shows the travel companions, the trip dates, a countdown and the places as a boarding pass. On mobile this card appears as a hero at the top of the page, with a progress bar for ongoing trips and a stats strip (days, places, travel companions).
|
||||
The first ongoing trip — or the next upcoming trip if none is ongoing — is promoted to a full-width **Spotlight card** at the top of the grid on desktop, where it carries a badge for the state of the trip (**LIVE NOW**, **STARTS TODAY**, **TOMORROW**, **UP NEXT** or **RECENT**), the action buttons on the cover, and a boarding pass strip below the title: your **Buddies**, the **Trip dates**, a countdown (days left, or **Trip starts in** a number of days) and the number of places as destinations. On mobile this card appears as a hero at the top of the page, with a progress bar for ongoing trips and a stats strip (days, places, travel companions).
|
||||
|
||||
If you have no trips yet, the spotlight card is not shown.
|
||||
|
||||
## Stat tiles
|
||||
|
||||
Under the spotlight card on desktop, a row of four tiles sums up all your trips:
|
||||
|
||||
| Tile | What it shows |
|
||||
|---|---|
|
||||
| **Atlas · Countries visited** | The number of countries found in the places and transports of your trips, of 195, with the first flags. A country you removed in [Atlas](Atlas) stays removed here. |
|
||||
| **Trips total** | How many trips you have, and how many places are mapped on them. |
|
||||
| **Days traveled** | The days across all trips. |
|
||||
| **Distance flown** | The distance of your flights, and what that comes to in trips around the equator. |
|
||||
|
||||
Each tile is switched on or off under **Settings → Appearance → Dashboard widgets**, in the **Below the hero** group; see [Dashboard-Widgets](Dashboard-Widgets#showing-and-hiding-widgets). When all four are off the row disappears.
|
||||
|
||||
## Trips without dates
|
||||
|
||||
A trip with no dates is not past and not upcoming. Its card carries an **Idea** badge in place of a countdown, and, as described under Sort Order, it is sorted with the past trips.
|
||||
|
||||
## Archived Trips
|
||||
|
||||
Archived trips are kept out of the default list. The trips section header carries a **Planned / Archived / Completed** filter and the grid shows exactly one of those three sets — switch to **Archived** to see them. On desktop an archived card has the same four actions as any other card, with **Archive** turned into **Restore**. On mobile an archived card drops **Edit**: you can **Copy**, **Restore**, or permanently **Delete** the trip.
|
||||
|
||||
## Mobile Header
|
||||
|
||||
On mobile, the header is a floating glass bar: the TREK logo on the left (tap it to scroll back to the top), a **Notifications** button (bell icon, with a dot when something is unread) that navigates to `/notifications`, and your avatar on the right. The avatar opens the user menu — settings, the admin panel for admins, the dark/light/auto theme cycle, and sign out.
|
||||
On mobile, the header is a floating glass bar: the TREK logo on the left (tap it to scroll back to the top), a **Notifications** button (bell icon, with a dot when something is unread) that navigates to `/notifications`, and your avatar on the right. The inbox there has a tile per kind of notification and a list cut into days, with actions to clear what you have read; see [Notifications](Notifications). The top of the mobile dashboard greets you (*Good morning,*, *Good afternoon,* or *Good evening,*), and an ongoing trip is marked **Live Now**. The avatar opens the user menu — settings, the admin panel for admins, the dark/light/auto theme cycle, and sign out.
|
||||
|
||||
## Dashboard Widgets Sidebar
|
||||
|
||||
@@ -79,3 +96,4 @@ When you have no trips, the dashboard shows the TREK mascot with the caption **N
|
||||
- [Trip-Planner-Overview](Trip-Planner-Overview)
|
||||
- [Dashboard-Widgets](Dashboard-Widgets)
|
||||
- [Calendar-Feeds](Calendar-Feeds)
|
||||
- [Notifications](Notifications)
|
||||
|
||||
Reference in New Issue
Block a user