From 77380ea5cf2c75056175013142e8b28f36769737 Mon Sep 17 00:00:00 2001 From: Maurice Date: Sat, 21 Nov 2026 13:23:03 +0100 Subject: [PATCH] docs(wiki): describe the trip settings' Addons area and its MCP tools --- wiki/Admin-Addons.md | 2 +- wiki/MCP-Tools-and-Resources.md | 2 ++ wiki/Trip-Settings.md | 14 +++++++++++++- 3 files changed, 16 insertions(+), 2 deletions(-) diff --git a/wiki/Admin-Addons.md b/wiki/Admin-Addons.md index e5b395f32..d49837143 100644 --- a/wiki/Admin-Addons.md +++ b/wiki/Admin-Addons.md @@ -16,7 +16,7 @@ Below the head card the addons are grouped in one card per type. From extra-wide ### Trip addons -Trip addons add per-trip feature panels. They appear in every trip where the addon is enabled. +Trip addons add per-trip feature panels. Your switch here is the default for every trip; a trip's owner can turn a trip addon on or off for their own trip under **Trip settings → Addons**, and that choice wins for that trip only. See [Trip-Settings](Trip-Settings#addons). The trip addons are: **Lists**, **Costs**, **Documents**, **Collab** and **Tours** (all enabled by default), and **Road trip** (disabled by default). The exact list is determined by what is registered in your TREK database. diff --git a/wiki/MCP-Tools-and-Resources.md b/wiki/MCP-Tools-and-Resources.md index bfaf3473d..f496e4d3a 100644 --- a/wiki/MCP-Tools-and-Resources.md +++ b/wiki/MCP-Tools-and-Resources.md @@ -44,6 +44,8 @@ Requires `trips:read` or `trips:write` scope. | `create_trip_guest` | Add a travelling companion who has no TREK account. Assignable to budget splits, packing and day participants; never signs in, never emailed. Owner only. | | `rename_trip_guest` | Rename a guest on a trip. Owner only. | | `delete_trip_guest` | Delete a guest and hand their share of each expense to the others in its split. Refused while the guest paid for an expense or is part of a recorded payment. Owner only. | +| `get_trip_addons` | The trip addons of one trip (lists, costs, files, collab, road trip, tours) and whether each applies to it: `enabled` is what applies here, `instanceEnabled` the instance setting, `overridden` whether the trip owner chose it. An addon that is off for a trip has its tools refused for that trip. | +| `set_trip_addon` | Switch one trip addon on or off for this trip only, or pass `enabled: null` to follow the instance again. Owner only. Data of an addon switched off is kept. See [Trip-Settings](Trip-Settings#addons). | | `copy_trip` | Duplicate a trip (days, places, itinerary, packing, budget, reservations). Packing items reset to unchecked. | | `export_trip_ics` | Export the trip itinerary and reservations as iCalendar (`.ics`) text. `dayEvents: false` leaves out the all-day summary per day. | | `get_share_link` | Get the current public share link for a trip and its permission flags. Requires `trips:share`. | diff --git a/wiki/Trip-Settings.md b/wiki/Trip-Settings.md index 7c3a3b324..2be6bcd39 100644 --- a/wiki/Trip-Settings.md +++ b/wiki/Trip-Settings.md @@ -1,6 +1,6 @@ # Trip Settings -**Trip settings** gathers who is on a trip, how others get in, and which journal the trip shows, in one dialog with three areas: **People**, **Sharing** and **Journal**. The trip's own details (title, description, dates, currency, cover) are edited with **Edit Trip** instead; see [Creating-a-Trip](Creating-a-Trip). +**Trip settings** gathers who is on a trip, how others get in, and which journal the trip shows, in one dialog with its areas: **People**, **Sharing**, **Journal** and, for the trip's owner, **Addons**. The trip's own details (title, description, dates, currency, cover) are edited with **Edit Trip** instead; see [Creating-a-Trip](Creating-a-Trip). ## Opening it @@ -67,6 +67,18 @@ A member the journal is closed to, and who can do nothing about the link, does n The [AI Assistant](AI-Assistant) can propose the link as a card too (*Show the journal in this trip*), which you apply like any other change. +## Addons + +*Switch features on or off for this trip only. It applies to everyone on the trip.* + +Only the trip's owner sees this area. It lists the trip addons (**Lists**, **Costs**, **Documents**, **Collab**, **Road trip** and **Tours**, as far as they are installed), each with its switch. The administrator's setting in [Admin-Addons](Admin-Addons) is where every trip starts; the owner can then turn an addon off for a trip that does not need it, or on for one trip although it is off for the instance. + +- A switch the owner set apart from the instance is marked **This trip only**. +- Turning it back to what the instance says drops the trip's own choice, so a later change by the administrator reaches the trip again. +- The choice holds for everyone on the trip, in the planner, on the phone, in the public link, in the offline copy and for the [AI Assistant](AI-Assistant) and [MCP](MCP-Overview) tools of that trip. Members see the result, not the switches. +- Switching an addon off hides it; nothing is deleted. Switching it on again brings back what was there. +- Changing a switch needs a connection; offline TREK says so and leaves the switch as it was. + ## See also - [Trip-Members-and-Sharing](Trip-Members-and-Sharing)