mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-06-19 13:21:46 +00:00
Julien G.
da3cba2de3
* fix(mcp): replace relative oauth constent redirect by absolute redirect derived from APP_URL (#987) * feat(journey): convert HEIC/HEIF uploads to JPEG for cross-platform compatibility HEIC is an Apple-only format not recognised as an image by many browsers and platforms. heic-to (lazy-loaded) now converts HEIC/HEIF files to JPEG before upload in both the gallery and entry editor photo pickers. Embedded metadata (EXIF, GPS) may be lost during conversion — documented in the Journey Journal wiki page. * fix(journey): skip heic-to import for non-HEIC files to avoid test env failures * fix(notifications): prevent double-escaping HTML in password reset emails buildPasswordResetHtml passed a pre-built HTML block to buildEmailHtml, which then escaped it again — rendering raw tags as plain text in the email.
63 lines
3.5 KiB
Markdown
63 lines
3.5 KiB
Markdown
# Journey Journal
|
|
|
|
Journey is a photo-first travel journal. Each journey is linked to one or more of your trips and contains per-day entries with text, photos, mood, and weather.
|
|
|
|
> **Admin:** enable Journey in [Admin-Addons](Admin-Addons).
|
|
|
|
<!-- TODO: screenshot: journal entries view with photos and mood indicators -->
|
|
|
|
|
|
|
|
## What Journey is
|
|
|
|
Journey lets you write a narrative account of your travels alongside your trip plan. Entries are tied to specific days and can include prose, photos, a mood rating, weather conditions, and verdict cards. Completed journeys can be shared publicly with a read-only link.
|
|
|
|
## Accessing Journey
|
|
|
|
When the admin has enabled the Journey addon, a **Journey** entry appears in the main navigation. The Journey list page shows all your journals as cards with cover images, entry counts, photo counts, and place counts.
|
|
|
|
## Creating a journey
|
|
|
|
From the Journey list, click **Create journey**. Give it a title and optional subtitle, then select one or more existing trips to link. Linking a trip imports the trip's places as location anchors for your entries. You can link additional trips later from the journal settings.
|
|
|
|
## Journal entries
|
|
|
|
Each entry corresponds to a day in your journey. The entry editor provides:
|
|
|
|
- **Title** — a short heading for the day.
|
|
- **Story** — free-form text that supports Markdown formatting.
|
|
- **Mood** — choose one of four values:
|
|
|
|
| ID | Label | Color |
|
|
|---|---|---|
|
|
| `amazing` | Amazing | Pink |
|
|
| `good` | Good | Amber |
|
|
| `neutral` | Neutral | Grey |
|
|
| `rough` | Rough | Violet |
|
|
|
|
- **Weather** — choose one of six values: Sunny, Partly cloudy, Cloudy, Rainy, Stormy, Cold.
|
|
- **Photos** — attach photos to the entry. The first photo becomes the card thumbnail in list views.
|
|
> **Note on HEIC files:** HEIC is an Apple-only format that many browsers and platforms do not recognise as an image. To ensure broad compatibility, HEIC/HEIF files are automatically converted to JPEG before upload. This conversion may result in the loss of embedded metadata (EXIF data such as GPS coordinates, camera information, etc.).
|
|
- **Pros / Cons** — optional verdict cards. Add items to a **Pros** list (thumbs-up) or a **Cons** list (thumbs-down) to summarise what you loved or what could have been better. These are stored in the `pros_cons.pros` and `pros_cons.cons` arrays on the entry.
|
|
- **Tags** — free-form labels (e.g. "hidden gem", "best meal").
|
|
- **Location** — pin the entry to a map location.
|
|
- **Time** — optionally record a time of day for the entry.
|
|
|
|
## Mobile timeline
|
|
|
|
On mobile, entries are displayed in a horizontal scrolling timeline of card thumbnails. Tap a card to open the full entry view in a modal sheet. Each card shows the entry's first photo (or a placeholder pin), date, day number, mood icon, and weather icon.
|
|
|
|
## Map view
|
|
|
|
The journey detail page includes a map on the right (desktop) or an integrated map-timeline (mobile) showing all entry locations alongside the places from linked trips.
|
|
|
|
## Public sharing
|
|
|
|
You can share a journey with a read-only public link. When creating the link you can independently toggle which sections are visible to visitors: **Timeline** (entries and stories), **Gallery** (photos), and **Map**. Visitors can only see the sections you have enabled, and no TREK account is required. See [Public-Share-Links](Public-Share-Links) for details on the separate journey share token mechanism.
|
|
|
|
## See also
|
|
|
|
- [Addons-Overview](Addons-Overview)
|
|
- [Admin-Addons](Admin-Addons)
|
|
- [Public-Share-Links](Public-Share-Links)
|