mirror of https://github.com/seanmorley15/AdventureLog.git synced 2026-07-31 07:49:07 -04:00

Files

Sean Morley 36631886a2 Add Wanderer author fields and enhance integration with API key authentication

- Introduced `wanderer_author_username` and `wanderer_author_domain` fields to the Trail model for better integration with the Wanderer API.
- Updated TrailSerializer to include new fields and ensure proper backfilling of author information from the Wanderer API.
- Enhanced import/export functionality to handle new author fields for backward compatibility.
- Migrated Wanderer integration to use API key authentication, removing username and token fields for improved security.
- Updated documentation to reflect changes in the Wanderer integration setup and usage.
- Added utility functions for handling GeoJSON data from GPX files and improved error handling in related services.
- Refactored views and serializers to accommodate the new integration structure and ensure seamless user experience.

2026-06-01 20:08:20 -04:00

2.6 KiB

Raw Blame History

Wanderer Integration

Wanderer is a self-hosted trail database. Integrating Wanderer with AdventureLog allows you to import trails directly into your locations, making it easier to plan and track your outdoor adventures.

Wanderer Integration Setup

In your Wanderer instance, create an API key (format: wanderer_key_...).
Navigate to the AdventureLog settings page.
Click on the Integrations tab.
Find the Wanderer section and enter your Wanderer server URL and API key.
Click Connect to Wanderer to save and verify the connection.

AdventureLog stores your API key securely on the server and uses it only to call the Wanderer API on your behalf. The key is never returned to the browser after it is saved.

Important Notes

The URL to the Wanderer server must be accessible from the AdventureLog server. Values like localhost or 127.0.0.1 often fail when AdventureLog runs in Docker or on another host.
If you upgrade from the older username/password integration, you must disconnect and reconnect with an API key. Existing Wanderer links on locations will not carry over automatically.
If your API key is revoked or invalid, update it in Settings → Integrations → Wanderer (Edit).

Importing Wanderer Trails

Open the create/edit location popup in AdventureLog.
Navigate to the Media tab and scroll down to the Trail Management section.
Click the Add Wanderer Trail button.
A search input will appear. Type the name of the trail you want to import.
Select the desired trail from the search results and click the link icon to import it into your location.
The imported trail will be added to your location's trails list, and you can view its details, including distance, elevation gain, and more.

Open in Wanderer links

Wanderer trail pages use this URL pattern:

{your-server}/trail/view/@{author-username}@{author-domain}/{trail-id}

Example: https://wanderer.seanmorley.com/trail/view/@seanmorley15@wanderer.seanmorley.com/25145802f15fe7a

AdventureLog stores wanderer_author_username and wanderer_author_domain on each linked trail (from expand.author on the Wanderer API). The API response includes wanderer_link built from those fields plus your connected server URL.

Older linked trails without author metadata are backfilled automatically the next time they are loaded (AdventureLog calls GET /api/v1/trail/{id}?expand=author).

Enjoy exploring new trails with Wanderer and AdventureLog! If you encounter any issues or have questions about the integration, feel free to reach out to the AdventureLog community!

2.6 KiB Raw Blame History