Grouping & Filtering

Club Groups

Found under the Club Groups tab, this feature allows you to define different rider groups within your club to help members find suitable routes.

Purpose of Club Groups

Club Groups are essentially difficulty or suitability grades based on rider ability. You define them based on characteristics like average speed, typical distance, and total elevation. When a route's statistics fall within the ranges you define for a group, it will automatically be associated with that group in the filter results.

Configuring Club Groups

1. Navigate to Routes → Config → Club Groups tab
2. You will see a table where you can define each group. For each row, fill in the details:
   • Group Name: The name of the group (e.g., "Social Rides", "Intermediate Group", "Chain Gang")
   • Average Speed: The expected lower and upper average speed for this group
   • Min/Max Distance: The typical ride distance range for this group
   • Min/Max Elevation: The typical elevation range for this group
   • Tooltip Text: A helpful description that appears when users hover over the group name
3. Unit Switching: Use the toggle at the top to enter values in either Metric (km/h, km, m) or Imperial (mph, mi, ft). The data is always saved in metric, but the toggle makes data entry easier.
4. Click "Save Changes" to save your groups.

Default Club Groups

The Setup Wizard creates three default groups:

• Leisurely - For relaxed, social pace rides
• Moderate - For steady-paced group rides
• Brisk - For faster-paced training rides

Climbing Profiles

Found under the Climbing Profiles tab, this feature allows you to categorise routes by their hilliness based on elevation gain.

Purpose of Climbing Profiles

Climbing Profiles help users quickly identify how hilly a route is. Unlike Club Groups which consider multiple factors, Climbing Profiles focus specifically on total elevation gain. They appear as quick filter buttons on the route finder page.

Configuring Climbing Profiles

1. Navigate to Routes → Config → Climbing Profiles tab
2. For each profile, configure:
   • Profile Name: The display name (e.g., "Flat", "Rolling", "Hilly", "Mountainous")
   • Min Elevation: The minimum elevation gain in metres
   • Max Elevation: The maximum elevation gain in metres
   • Tooltip: A description for users (e.g., "Mostly flat terrain with minimal climbing")
   • URL Key: A URL-friendly identifier (e.g., "flat", "rolling")
3. Use the drag handles to reorder profiles
4. Click "Save Changes"

Default Climbing Profiles

The Setup Wizard creates four default profiles:

Unit Conversion

When configuring climbing profiles:

• Values are stored internally in metres
• Use the unit toggle to switch between metric and imperial for easier entry
• The plugin automatically converts for display based on user preferences

Activity Types

Found under the Activity Types tab, this feature allows you to categorise routes by the type of activity they're designed for.

Purpose of Activity Types

Activity Types allow users to filter routes based on the kind of riding or activity. This is particularly useful if your club offers different types of routes beyond just road cycling.

Configuring Activity Types

1. Navigate to Routes → Config → Activity Types tab
2. For each activity type, configure:
   • Name: The display name (e.g., "Road Cycling", "Gravel", "MTB")
   • Icon: Optional Font Awesome icon
   • URL Key: A URL-friendly identifier
3. Click "Add Activity Type" to add new types
4. Use drag handles to reorder
5. Click "Save Changes"

Default Activity Types

The Setup Wizard creates the following default types:

• Road Cycling
• Gravel
• MTB (Mountain Biking)
• Touring
• Hiking
• Trail Running
• Walking
• Cross-Country Skiing
• Other

Assigning Activity Types to Routes

Activity types can be assigned to routes in several ways:

• During route upload via the GPX upload form
• In the route editor
• Via the modal editor on the All Routes page
• Directly in the All Routes table (inline editing)

Route Shortcuts (Filter Groups)

Found under the Route Types tab, this feature lets you create predefined filter buttons, referred to as "Route Shortcuts," which appear on your main route filtering page.

Purpose of Route Shortcuts

Route Shortcuts are buttons that allow users to quickly filter routes based on keywords found in the route titles. For example, you can create a shortcut called "Off Road" that, when clicked, instantly shows all routes with "Off Road", "Gravel", or "MTB" in their titles. This provides a much faster user experience than typing into the search box.

Configuring Route Shortcuts

1. Navigate to Routes → Config → Route Types tab
2. For each shortcut, provide:
   • Shortcut Name: The text that will appear on the button (e.g., "Hilly Rides")
   • Tooltip Text: A description that appears on hover
   • Key (for URL): A unique, URL-friendly key (e.g., hilly_rides)
   • Type: How the filter works (see below)
   • Filter Rules: Comma-separated keywords to match
3. Click "Save Changes"

Filter Types

Example Shortcuts

Automatic Route Grouping

The plugin can automatically group related routes together based on their names. This is useful when you have multiple variations of the same basic route.

How Grouping Works

Routes are grouped by finding common prefixes in their names. For example:

• "Brighton Loop - Short" and "Brighton Loop - Long" would be grouped under "Brighton Loop"
• "South Downs via Steyning (Easy)" and "South Downs via Steyning (Hard)" would be grouped under "South Downs via Steyning"

Group Display

When routes are grouped:

• They appear together in filter results
• Users can expand/collapse the group to see individual routes
• A dedicated group page shows all routes in the group with a combined map

Manual Grouping Override

You can manually control grouping:

• Assign routes to specific groups via the route editor
• Exclude routes from automatic grouping
• Create custom group names