TrailKit Documentation

🚀Getting Started

Requirements

Installation

1. Go to Plugins → Add New → Upload Plugin
2. Upload trailkit.zip and click Install Now
3. Click Activate
4. Go to Routes → Settings to configure URL slugs and map defaults
5. Go to Settings → Permalinks and click Save

Demo Data

TrailKit includes sample routes, POIs, and a guide to help you explore. Go to Routes → Settings → Demo Data and click Install Demo Data. Remove it with one click before going live.

Quick Navigation

🗺Routes

Routes represent hiking trails, trekking expeditions, kayak circuits, or any multi-point outdoor activity with measurable stats.

Meta Fields

GPS Points format

Paste a JSON array in the GPS & Map meta box:

[
  {"lat": 10.4806, "lng": -66.9036, "ele": 900},
  {"lat": 10.4900, "lng": -66.9100, "ele": 950}
]

Difficulty colours

📍Points of Interest

POIs represent specific natural or cultural landmarks: waterfalls, viewpoints, beaches, caves, lagoons, peaks.

Meta Fields

Default POI types

Created automatically on activation. Add custom types in POIs → POI Types.

👤Guides

Guide profiles showcase local certified guides with contact info, specialties, pricing, and service area map.

Contact & Details

Service Area

Specialties

[ ]Shortcodes

Place these shortcodes in any page, post, or widget. Assets (CSS/JS) are loaded automatically only on pages that use a TrailKit shortcode.

[tk_routes activity="hiking" difficulty="moderate" region="andes" limit="6" columns="3"]

[tk_pois type="waterfall,viewpoint" region="gran-sabana" limit="6" columns="3"]

[tk_guides featured="true" specialty="hiking" columns="2"]

[tk_map type="all" height="500px" zoom="6" lat="8.0" lng="-66.0"]

🎨Template Overrides

TrailKit uses a WooCommerce-style override system. Copy any template to your theme and edit it freely — plugin updates will never overwrite your changes.

How it works

wp-content/
  themes/
    your-theme/
      trailkit/            ← create this folder
        single-route.php   ← your override
        route-card.php     ← another override

Available templates

Available PHP variables

// In single-route.php / route-card.php
$post_id  // Current route post ID
$data     // Array: difficulty, distance, elevation, time,
          //        lat, lng, points, conditions_alert,
          //        gmaps_url, gallery, hero_position
$thumb    // URL of the featured image (full size)

// In single-guide.php / guide-card.php
$post_id  // Current guide post ID
$guide    // Array: whatsapp, email, instagram, price_from,
          //        specialties (JSON), photo_id,
          //        is_featured, lat, lng, radius_km

// Check Pro status in any template
if ( tk_is_pro() ) {
    // Show Pro-only feature
}

✏️CSS & Styling

All TrailKit styles are scoped to .tk-* class names — zero conflicts with your theme. Customise via CSS custom properties.

Brand tokens (global)

Surface tokens (inherit from theme.json)

Override in your theme

/* In Appearance → Customize → Additional CSS */

/* Change brand accent */
:root {
  --tk-primary: #ff6b00;
  --tk-primary-dim: rgba(255,107,0,.12);
}

/* Override card surfaces */
.tk-card, .tk-single, .tk-grid {
  --tk-bg-card: #fafafa;
  --tk-border:  #d1d5db;
}

🔑License & Pro

Lite vs Pro

License plans

Activating a license

1. Go to Routes → Settings → Pro License
2. Paste your key (format: TK-XXXX-XXXX-XXXX-XXXX)
3. Click Activate License

Free Trial

Try all Pro features free for 14 days — no credit card required. Go to Routes → Settings and enter your email in the Start 14-Day Trial section. One trial per domain.

❓FAQ & Troubleshooting