View File
Trip Planner Advanced
Trip Planner Advanced for phpVMS v7
Create multi-leg “free flight” trips that your pilots can bid on and fly, keeping them moving from airport to airport.
Clean UI, simple admin controls, and neutral branding that fits any VA.
Derived from Cardinal Horizon CHTrips and packaged for easy drop-in use.
✈️ Highlights
Multi-leg trips with custom name & description
“Next Flight” summary with aircraft group popover and quick actions
Progress tracking + completed PIREPs list
Equipment Category picker to attach subfleets (Airbus Narrow, Boeing Narrow, Airbus Wide, Boeing Wide, Regional, McDonnell/Other)
Optional rank-aware mode (honors phpVMS Rank/Type settings)
Smooth start option: Auto-reposition to the first departure after the first bid if “start anywhere” is allowed
Invisible, trip-owned flights to avoid conflicts with schedules
👨✈️ What Pilots Get
My Trips page with progress bar, description, created date, and compact action buttons
Trip Detail page: “Next Flight” card with quick actions (Info, New PIREP, SimBrief)
Add/Remove Bid button (with auto-reposition support)
Following flights and completed the PIREPs list
Automatic reposition message (only shown before the first PIREP if “start anywhere” is allowed)
⚙️ Admin Settings
Accessible at: Admin → Trip Planner Advanced → View Admin Module
Enforce VA Ranking
ON: Only subfleets allowed by pilot’s rank/type
OFF: Rank ignored; All SubFleets available
Lock to Current Pilot Location (default ON)
ON: First leg must depart the pilot’s current/home airport
OFF: Trips can start anywhere
Auto-Reposition on First Bid
ON: Auto-moves pilot to the first departure after their very first bid
OFF: No Auto-move pilot
Mandatory if “Lock to Current” is OFF
All settings are ability-guarded (admin, admin-access).
🔧 How It Works (Under the Hood)
Flights created with: Numbers 7000–7999 and route_code=TPA
Visible=False, owned by Trip
Leg order tracked in ch_flight_pirep_trip
PIREP Create Bridge (tripplanner.pireps.create) filters aircraft per trip
Bids handled via module routes (tripplanner.bid.add, phpvms.bids.removeBid())
📥 Installation
Copy folder → modules/TripPlannerAdvanced/
Admin → Addons → Modules: enable
Admin → YourVAaddress/pdate (run migrations)
Admin → Maintenance → Clear All Caches
Frontend menu: Trip Planner appears for logged-in users.
Future Updates: Upgrade: Replace folder → Run Update → Clear caches.
📝 Notes & Best Practices
If trips CAN start anywhere, enable Auto-Reposition to bypass & avoid “Not at Departure” errors.
If trips CAN start anywhere, repositioning only applies after the very first BID in a trip is placed.
Flights are invisible & uniquely tagged (TPA + 7000s) to avoid collisions.
Always clear caches after installation or upgrade.
📄 License & Attribution
License: BSD-3
Portions & Credits derived from CHTrips by Cardinal Horizon © 2024.
Submitter
William
Submitted
09/04/25
Category
Add-ons