Route Finder Admin Documentation

Welcome to the administrative documentation for the Route Finder plugin. This comprehensive guide will help you configure, manage, and get the most out of your cycling route management system.

Quick Start

If you're setting up Route Finder for the first time, follow these steps:

1. Run the Setup Wizard - Navigate to Routes → Setup and complete the 8-step wizard
2. Configure your club groups - Set up rider ability levels in Routes → Config → Club Groups
3. Upload your first route - Go to Routes → Route Management → Add Route
4. Add destinations - Create tea stops and cafés in Routes → Destinations
5. View your route finder - Visit the automatically created route finder page on your website

Documentation Overview

Use the navigation on the left to jump to different sections. Here's a brief overview of what each section covers:

Setup & Configuration

• Setup Wizard - First-time installation guide with 8 configuration steps
• Configuration & Setup - Main plugin settings, map providers, and API keys

Route Management

• Route File Management - Uploading GPX files and processing routes
• Route Management - The All Routes table and editing routes
• Shortcode Management - Embedding routes using shortcodes

Filtering & Organisation

• Grouping & Filtering - Club groups, climbing profiles, activity types, and route shortcuts
• Location Discovery - The "Near a Place" sidebar filter, Location route shortcuts, location Gutenberg blocks, and Week Builder

Points of Interest

• Points of Interest - Managing destinations, custom markers, and proximity calculations

Additional Features

• External Services - Linking routes to Strava, Garmin, Komoot, and more
• Weather Feature - Weather overlays and forecasts on route maps
• Dark Mode - User preference for light/dark theme
• Access Control - Hiding routes, password protection, and permissions

Data Management

• Data Sync - Syncing routes and destinations from Google Sheets

Key Concepts

Routes

Routes are the core content type. Each route represents a cycling (or walking/running) route with a GPX track, distance, elevation, and optional tea stop destinations. Routes are stored as custom post types in WordPress.

Destinations

Destinations (also known as "tea stops") are curated locations such as cafés, bike shops, or points of interest that can be associated with routes. The plugin calculates which destinations are near each route automatically.

Markers

Markers are visual icons displayed on maps. There are different marker types (templates) that define appearance, and marker entities (actual locations) that use those types.

Groups & Profiles

Routes can be categorised by Club Groups (rider ability), Climbing Profiles (hilliness), and Activity Types (road, gravel, MTB, etc.). These enable powerful filtering on the route finder page.

Getting Help

If you need assistance:

• Browse through the documentation sections using the navigation on the left
• Look for the blue "Tip" boxes for helpful hints
• Check the yellow "Warning" boxes for important notices
• Contact your website administrator or the plugin developer for technical support