Files
TREK/wiki/Trip-Members-and-Sharing.md
T
Maurice 5f77fa5cca feat(trips): trip invite links + optional trip binding on admin invites
Trip invite links (#1143): each trip can have one rotating invite link in its
Share panel. An existing, logged-in user who opens /join/<token> is added to
the trip as a member; an anonymous visitor is sent to the login page and
returned to the invite afterwards — there is no registration from this link.
Reading, rotating or disabling the link all require the share_manage permission.

Admin invite trip binding (#1402): the admin create-invite dialog can now bind
a registration invite to a trip. Someone who registers via that link is
auto-added to the trip as a member (password and OIDC paths), inside the same
atomic step that consumes the invite.

Adds a trip_invite_tokens table and a nullable invite_tokens.trip_id, a shared
owner-safe/idempotent add-by-id helper, the manage + join endpoints, the
JoinTripPage and Share-panel section, the admin trip picker, and the new i18n
keys across every locale. Wiki updated.

Discussion #1143
2026-07-02 15:18:04 +02:00

3.9 KiB

Trip Members and Sharing

Trip Members

Opening the Members Panel

  • From the dashboard: click the share/members icon on a trip card.
  • From the trip planner: click the Share button in the top navigation bar.

When you have the share_manage permission the modal opens to a two-column layout on wider screens (members on the left, share link on the right). Without that permission only the members column is shown. On narrow screens the columns always stack.

Members List

The left column lists everyone who has access to the trip.

  • The trip owner is marked with a crown badge.
  • Your own entry is labeled (you).
  • Each non-owner member shows a remove button.

Inviting Members

If you have the member_manage permission (default: trip owner), an invite control appears above the list. Select a user from the searchable dropdown and click Invite. The user is looked up by username or email on the server, added immediately, and the list refreshes. The invited user also receives an in-app notification.

Removing a Member

Click the remove icon next to any member's name. A confirmation prompt appears before the member is removed.

If you click the remove icon next to your own name, the action is labeled Leave trip and uses a "log out" icon. Leaving reloads the page and returns you to the dashboard.

The trip owner cannot be removed through this panel.

The right column is only visible to users with the share_manage permission (default: trip owner).

A share link creates a read-only, token-based URL:

<your-instance>/shared/<token>

Viewers do not need to log in. The link can be shared with anyone.

Click Create share link. A URL is generated and shown with a copy button.

Permission Toggles

Before or after creating the link, you can control what the link exposes. Toggle each section on or off with the pill buttons:

Toggle Default What it shows
Map Always on Trip map with place markers — cannot be disabled
Bookings On Reservations and accommodations
Packing Off Packing list
Budget Off Budget tab
Collab Off Read-only view of notes, chat, and polls

Changes to toggles take effect immediately for an existing link.

Click Delete link (red button below the URL) to revoke access. The token is invalidated and existing viewers are redirected.

Below the public share link, users with the share_manage permission can also create a trip invite link — a single rotating link that lets people join the trip as members:

<your-instance>/join/<token>

Unlike the read-only share link, this one is not anonymous:

  • Whoever opens it must have a TREK account and be signed in. If they are not, they are sent to the login page and returned to the invite afterwards — there is no registration from this link.
  • Anyone who opens it while signed in is added to the trip as a member (the same access a manually-added member gets). The owner and existing members are simply taken straight to the trip.
  • To invite people who do not yet have an account, use an admin invite link with an optional trip binding instead — see Invite-Links.

Creating and revoking

  • Click Create invite link to generate the link, then copy it with the copy button.
  • Click Regenerate to rotate the token — the previous link stops working immediately.
  • Click Disable to remove the link entirely.

Admin: To invite users who do not yet have an account, create invite links in the admin panel. See Invite-Links.