Katrangan
Boat Position turns your WordPress site into a live tracking and logbook service for your boat.
The plugin is designed around the Teltonika RUTX50 router (*), a compact Linux-based 5G router with built-in GPS.
A shell script on the router sends a position to your site every minute. The plugin stores each position, runs a state machine to group positions into trips and legs, and serves three public pages:
- Live map (
/boat-position/map) — shows the current position on an OpenStreetMap/OpenSeaMap map with a rotating arrow icon when underway and an idle indicator when stopped. Visible voyage plans are drawn as dashed green routes with flag markers. - Logbook (
/boat-position/history) — calendar sidebar with trip history. Click any day to see the full route on the map. Logged-in editors can label harbour names and merge incorrectly split trips. - Voyage plans (
/boat-position/plans) — plan future voyages as ordered lists of waypoints with optional ETAs. Multiple plans are supported; each plan can be toggled visible/hidden on the map independently.
Over 150 Danish harbours are included as seed data so harbour names are detected automatically from GPS coordinates.
No third-party services or API keys are required beyond your own WordPress site. Maps are rendered using the free Leaflet.js library with OpenStreetMap and OpenSeaMap tiles.
(*) There are other alternatives to using the RTUTX50 router, any device that has access to a GPS and the internet can be configured as the source of position data.
E.g. a linux machine like Rasberry PI connected to either its own GPS or the boat NMEA data.
Gambar conto
Pemasangan
- Upload the
boat-positiondirectory to/wp-content/plugins/. - Activate the plugin in Plugins in the WordPress admin.
- Go to Settings Boat Position to set a secret API key and find the router configuration instructions.
- Follow the router setup guide in Plugins Boat Position About to configure your router’s
sendgps.shscript and cron job. - Send a test position from a command prompt to verify the endpoint is working before installing on the boat.
After activation, if /boat-position/map returns a 404, go to Settings Permalinks and click Save Changes to flush the rewrite rules.
FAQ
-
How do I use this plugin?
-
Install and activate the plugin, then go to Settings Boat Position. Set a secret API key, then follow the router configuration guide in the About page to set up your router’s cron job.
-
Does it only work with the RUTX50 router?
-
No. Any device that can send an HTTP POST request with
lat,lon,speed,course, andgps_timefields to the REST endpoint will work. The About page documents the exact format. -
Where are the public pages?
-
The plugin registers three pages automatically — no WordPress pages or shortcodes are needed:
- Live map:
https://yoursite.com/boat-position/map - Logbook:
https://yoursite.com/boat-position/history - Voyage plans:
https://yoursite.com/boat-position/plans
- Live map:
-
Can I avoid storing the secret key in the database?
-
Yes. Define the key as a constant in
wp-config.php:define( ‘PCIO_BOAT_POSITION_API_KEY’, ‘your-secret-key-here’ );
When this constant is present, the database option is ignored and the settings field is shown as read-only.
-
The logbook is empty — no trips appear.
-
Check that the router is sending data by looking at your database’s
wp_boat_positionstable. If rows are present but no trips appear, the trip engine may not have processed them yet — visit the ingest endpoint directly or check the About page for the manual trigger curl command.
Mācā ulang
There are no reviews for this plugin.
Contributors & Developers
“Boat Position” is open source software. The following people have contributed to this plugin.
Kontributor
Translate “Boat Position” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Caathetan Owahan
1.1
- Voyage plans (
/boat-position/plans) — new page for planning future voyages.- Create and manage multiple named plans, each with an optional description.
- Add waypoints with names, coordinates and optional ETAs (expected arrival dates).
- Drag-and-drop to reorder waypoints; inline editing of name and ETA per row.
- Rebase tool: shift all ETAs from a chosen waypoint onwards by a number of days.
- Delete individual waypoints or entire plans.
- Editable plan title and notes directly from the waypoint view.
- Eye icon toggle per plan: visible (blue) or hidden (grey).
Logged-in users save their choice to the database; anonymous visitors store it in browser localStorage. - All visible plans are drawn on the live map as dashed green routes with flag markers.
- Clicking empty water on the map allows editors to add a waypoint directly to the active plan.
- Quick-pick datalist when adding waypoints: suggests all known harbours and existing plan waypoints.
- Harbour management on the live map: all known harbours are shown as markers. Logged-in editors can click any harbour to rename or delete it, and can click empty water to add a new harbour at that location.
1.0
- Initial release with tracking and history logbook.