Title: Boat Position
Author: Niels Olsen
Published: <strong>31. mai, 2026</strong>
Last modified: 31. mai, 2026

---

Søk i utvidelser

![](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

 Av [Niels Olsen](https://profiles.wordpress.org/pcio/)

[Last ned](https://downloads.wordpress.org/plugin/boat-position.zip)

 * [Detaljer](https://nb.wordpress.org/plugins/boat-position/#description)
 * [Omtaler](https://nb.wordpress.org/plugins/boat-position/#reviews)
 *  [Installering](https://nb.wordpress.org/plugins/boat-position/#installation)
 * [Utvikling](https://nb.wordpress.org/plugins/boat-position/#developers)

 [Brukerstøtte](https://wordpress.org/support/plugin/boat-position/)

## Beskrivelse

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.

## Skjermbilder

 * [[
 * Live map — current boat position with directional arrow on OpenSeaMap.
 * [[
 * Logbook — calendar sidebar, trip list, and route drawn on the map.

## Installasjon

 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.

## Ofte stilte spørsmål

### 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.

## Vurderinger

Det er ingen omtaler av denne utvidelsen.

## Bidragsytere og utviklere

«Boat Position» er programvare med åpen kildekode. Følgende personer har bidratt
til denne utvidelsen:

Bidragsytere

 *   [ Niels Olsen ](https://profiles.wordpress.org/pcio/)

[Oversett «Boat Position» til ditt språk.](https://translate.wordpress.org/projects/wp-plugins/boat-position)

### Interessert i utvikling?

[Bla gjennom koden](https://plugins.trac.wordpress.org/browser/boat-position/), 
sjekk ut [SVN-repositoriet](https://plugins.svn.wordpress.org/boat-position/), eller
abonner på [utviklingsloggen](https://plugins.trac.wordpress.org/log/boat-position/)
med [RSS](https://plugins.trac.wordpress.org/log/boat-position/?limit=100&mode=stop_on_copy&format=rss).

## Endringslogg

#### 1.0

 * Initial release.

## Meta

 *  Versjon **1.0.0**
 *  Sist oppdatert **1 uke siden**
 *  Aktive installasjoner **Færre enn 10**
 *  WordPress-versjon ** 6.2 eller nyere **
 *  Testet opp til **7.0**
 *  PHP-versjon ** 8.1 eller nyere **
 *  Språk
 * [English (US)](https://wordpress.org/plugins/boat-position/)
 * Stikkord
 * [Boat](https://nb.wordpress.org/plugins/tags/boat/)[gps](https://nb.wordpress.org/plugins/tags/gps/)
   [logbook](https://nb.wordpress.org/plugins/tags/logbook/)[map](https://nb.wordpress.org/plugins/tags/map/)
   [tracking](https://nb.wordpress.org/plugins/tags/tracking/)
 *  [Avansert visning](https://nb.wordpress.org/plugins/boat-position/advanced/)

## Vurderinger

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/boat-position/reviews/#new-post)

[Se alle omtalene](https://wordpress.org/support/plugin/boat-position/reviews/)

## Bidragsytere

 *   [ Niels Olsen ](https://profiles.wordpress.org/pcio/)

## Brukerstøtte

Har du noe å si? Trenger du hjelp?

 [Vis brukerstøtteforumet](https://wordpress.org/support/plugin/boat-position/)

## Donér

Vil du støtte videreutviklingen av denne utvidelsen?

 [ Doner til denne utvidelsen ](https://www.paypal.com/donate/?hosted_button_id=DFM2JV8JKTTM6)