Title: Boat Position Author: Niels Olsen Published: 31 Maj, 2026 Last modified: 31 Maj, 2026 --- Kërkoni te shtojca ![](https://ps.w.org/boat-position/assets/banner-772x250.png?rev=3555344) ![](https://ps.w.org/boat-position/assets/icon-256x256.png?rev=3555344) # Boat Position Nga [Niels Olsen](https://profiles.wordpress.org/pcio/) [Shkarkim](https://downloads.wordpress.org/plugin/boat-position.zip) * [Hollësi](https://sq.wordpress.org/plugins/boat-position/#description) * [Shqyrtime](https://sq.wordpress.org/plugins/boat-position/#reviews) * [Instalim](https://sq.wordpress.org/plugins/boat-position/#installation) * [Zhvillim](https://sq.wordpress.org/plugins/boat-position/#developers) [Asistencë](https://wordpress.org/support/plugin/boat-position/) ## Përshkrim 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 two 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. * **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. 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. ## Foto ekrani * [[ * Live map — current boat position with directional arrow on OpenSeaMap. * [[ * Logbook — calendar sidebar, trip list, and route drawn on the map. ## Instalim 1. Upload the `boat-position` directory to `/wp-content/plugins/`. 2. Activate the plugin in **Plugins** in the WordPress admin. 3. Go to **Settings Boat Position** to set a secret API key and find the router configuration instructions. 4. Follow the router setup guide in **Plugins Boat Position About** to configure your router’s `sendgps.sh` script and cron job. 5. 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. ## PBR ### 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`, and `gps_time` fields to the REST endpoint will work. The About page documents the exact format. ### Where are the public pages? The plugin registers two pages automatically — no WordPress pages or shortcodes are needed: * Live map: `https://yoursite.com/boat-position/map` * Logbook: `https://yoursite.com/boat-position/history` ### 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_positions` table. 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. ## Shqyrtime Për këtë shtojcë s’ka shqyrtime. ## Kontribues & Zhvillues “Boat Position” është software me burim të hapur. Në këtë shtojcë kanë dhënë ndihmesë personat vijues. Kontribues * [ Niels Olsen ](https://profiles.wordpress.org/pcio/) [Përkthejeni “Boat Position” në gjuhën tuaj.](https://translate.wordpress.org/projects/wp-plugins/boat-position) ### Ju intereson zhvillimi? [Shfletoni kodin](https://plugins.trac.wordpress.org/browser/boat-position/), shkarkoni [depon SVN](https://plugins.svn.wordpress.org/boat-position/), ose pajtohuni përmes [RSS-je](https://plugins.trac.wordpress.org/log/boat-position/?limit=100&mode=stop_on_copy&format=rss) te [regjistri i zhvillimeve](https://plugins.trac.wordpress.org/log/boat-position/). ## Regjistër ndryshimesh #### 1.0 * Initial release. ## Të tjera * Version **1.0.0** * Përditësuar së fundi më **7 ditë më parë** * Instalime aktive **Më pak se 10** * Version WordPress-i ** 6.2 ose më i madh ** * E provuar deri me **7.0** * Version PHP-je ** 8.1 ose më i madh ** * Gjuhë * [English (US)](https://wordpress.org/plugins/boat-position/) * Etiketa * [Boat](https://sq.wordpress.org/plugins/tags/boat/)[gps](https://sq.wordpress.org/plugins/tags/gps/) [logbook](https://sq.wordpress.org/plugins/tags/logbook/)[map](https://sq.wordpress.org/plugins/tags/map/) [tracking](https://sq.wordpress.org/plugins/tags/tracking/) * [Pamje e Thelluar](https://sq.wordpress.org/plugins/boat-position/advanced/) ## Vlerësime S’është parashtruar ende ndonjë përshtypje. [Your review](https://wordpress.org/support/plugin/boat-position/reviews/#new-post) [Shihni krejt shqyrtimet](https://wordpress.org/support/plugin/boat-position/reviews/) ## Kontribues * [ Niels Olsen ](https://profiles.wordpress.org/pcio/) ## Asistencë Keni diçka për të thënë? Ju duhet ndihmë? [Shihni forum asistence](https://wordpress.org/support/plugin/boat-position/) ## Dhuroni Do të donit të përkrahnit shpënien më tej të kësaj shtojce? [ Dhuroni për këtë shtojcë ](https://www.paypal.com/donate/?hosted_button_id=DFM2JV8JKTTM6)