mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-10-18 21:16:47 +00:00
docs(wiki): add Collections addon page (#1081)
New wiki/Collections.md in the style of the other addon pages (lists, status, categories, adding/bulk-adding places, place detail, filters + bulk actions, fusion sharing with member roles, dashboard widget). Add it to the Addons overview table + the sidebar navigation.
This commit is contained in:
@@ -22,6 +22,7 @@ The following addons are registered in the system (defined in `server/src/db/see
|
||||
| `atlas` | global | Interactive world map showing countries and regions you have visited, plus a bucket list. See [Atlas](Atlas). |
|
||||
| `collab` | trip | Notes, polls, and live chat for trip collaboration. See [Real-Time-Collaboration](Real-Time-Collaboration). |
|
||||
| `journey` | global | Trip tracking and travel journal — check-ins, photos, and daily stories. See [Journey-Journal](Journey-Journal). |
|
||||
| `collections` | global | A personal, server-wide library of saved places in named lists, with idea/want/visited status, categories, and fusion sharing with per-member roles. See [Collections](Collections). |
|
||||
| `naver_list_import` | trip | Import places from shared Naver Maps lists directly into a trip. |
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,81 @@
|
||||
# Collections
|
||||
|
||||
Collections is a personal, server-wide library of saved places that lives outside of any single trip. Keep multiple named lists of places you have discovered — a "Norway road trip" wishlist, "Best coffee in Lisbon", "Someday" — each with a want-to-go / visited status, and share a list with other users.
|
||||
|
||||
> **Admin:** enable Collections in [Admin-Addons](Admin-Addons).
|
||||
|
||||
<!-- TODO: screenshot: the /collections page with the lists rail, a list hero and the places -->
|
||||
|
||||

|
||||
|
||||
## What Collections is
|
||||
|
||||
A place you save to a trip only exists inside that trip. Collections is the opposite: a place library that belongs to *you*, independent of any trip, so a spot you find while planning one trip is still there for the next one. Places are copied into and out of trips (never linked), so editing a saved place never changes a trip and vice versa.
|
||||
|
||||
## Accessing Collections
|
||||
|
||||
When the admin has enabled the addon, a **Collections** entry appears in the main navigation (and a bottom-tab on mobile). Opening it shows your lists on the left, the active list's places in the middle, and a map on the right.
|
||||
|
||||
The dashboard also gains a **Collections widget** that surfaces your lists as compact badges. Each user can hide that widget from their own dashboard under [Display Settings](Display-Settings) without affecting anyone else.
|
||||
|
||||
## Lists
|
||||
|
||||
- **Create a list** from the "New list" action in the rail. A list has a name, a colour, an optional cover image (upload your own or search Unsplash), a description and a set of links.
|
||||
- **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
|
||||
|
||||
Every saved place carries a status you can cycle with one tap:
|
||||
|
||||
- **Idea** — something you noted but haven't committed to.
|
||||
- **Want to go** — on the shortlist.
|
||||
- **Visited** — been there.
|
||||
|
||||
Status is a Collections concept and is not carried into a trip when you copy a place.
|
||||
|
||||
## Categories
|
||||
|
||||
Places can be assigned a **category** from the same admin-defined set used across TREK (see [Admin: Categories](Admin-Categories)). Category colours and icons show on the place avatar, the place detail and the list rows, and you can filter a list by category.
|
||||
|
||||
## Adding places
|
||||
|
||||
- **Search and add** — the "+" action opens a search; pick a result and set the name, category, status, a markdown description and links before saving, all in one step.
|
||||
- **Save from a trip** — the place inspector and the trip place context menu both offer **Save to collection**, which toggles that place in or out of each of your lists.
|
||||
- **Bulk-add from a trip** — in the trip place list, enter select mode, tick several places, and use the **Save to collection** action in the selection bar to copy them all into a chosen list at once. Duplicates (by name or coordinates) are skipped automatically.
|
||||
|
||||
## Place detail
|
||||
|
||||
Clicking a saved place opens a detail sheet showing a cover photo (fetched automatically when the place has none of its own), its category, a live status control, a markdown description, and links. From there you can edit the place, **copy it into a trip**, or remove it from the list.
|
||||
|
||||
## Filtering and bulk actions
|
||||
|
||||
Above the places sit two compact filters — by **status** and by **category** — plus a **Select** toggle. In select mode you can:
|
||||
|
||||
- **Select all** the currently filtered places.
|
||||
- **Copy to trip** — copies the selected places into any of your trips (carrying their name, description, category, notes, price, coordinates, photo and tags).
|
||||
- **Move** or **Duplicate** the selection into another of your lists.
|
||||
- **Delete** the selection.
|
||||
|
||||
## Sharing a list (fusion)
|
||||
|
||||
Lists are private by default. The owner can **share** a list by inviting other users, similar to Vacay fusion. Invited users see the list once they accept, and changes sync live over websocket.
|
||||
|
||||
### Member roles
|
||||
|
||||
When sharing, the owner assigns each member a permission role, and can change it at any time:
|
||||
|
||||
| Role | Can do |
|
||||
|---|---|
|
||||
| **Viewer** | View the list and copy its places into their own trips — no changes to the list. |
|
||||
| **Editor** *(default)* | Add new places and edit existing ones. |
|
||||
| **Admin** | Everything an editor can, plus delete places. |
|
||||
|
||||
The owner always has full control. The owner can also remove a member, and a member can leave a shared list themselves. Permissions are enforced on the server, so a role can only ever do what it is allowed to.
|
||||
|
||||
## See also
|
||||
|
||||
- [Addons-Overview](Addons-Overview)
|
||||
- [Admin-Addons](Admin-Addons)
|
||||
- [Admin: Categories](Admin-Categories)
|
||||
- [Dashboard Widgets](Dashboard-Widgets)
|
||||
@@ -63,6 +63,7 @@
|
||||
- [[Vacay]]
|
||||
- [[Atlas]]
|
||||
- [[Journey Journal|Journey-Journal]]
|
||||
- [[Collections]]
|
||||
- [[Dashboard Widgets|Dashboard-Widgets]]
|
||||
|
||||
## AI / MCP
|
||||
|
||||
Reference in New Issue
Block a user