Title: Boat Position
Author: Niels Olsen
Published: <strong>31.05.2026</strong>
Last modified: 31.05.2026

---

Търсене на разширения

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

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

[Изтегляне](https://downloads.wordpress.org/plugin/boat-position.zip)

 * [Детайли](https://bg.wordpress.org/plugins/boat-position/#description)
 * [Оценки](https://bg.wordpress.org/plugins/boat-position/#reviews)
 *  [Инсталиране](https://bg.wordpress.org/plugins/boat-position/#installation)
 * [Разработка](https://bg.wordpress.org/plugins/boat-position/#developers)

 [Поддръжка](https://wordpress.org/support/plugin/boat-position/)

## Описание

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.

## Снимки на разширението

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

## Инсталиране

 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.

## ЧЗВ

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

## Отзиви

There are no reviews for this plugin.

## Сътрудници и разработчици

“Boat Position” е софтуер с отворен код. Към разширението са допринесли следните
хора:

Сътрудници

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

[Превеждане на “Boat Position” на вашия език.](https://translate.wordpress.org/projects/wp-plugins/boat-position)

### Имате интерес към разработване?

[Преглеждане на кода](https://plugins.trac.wordpress.org/browser/boat-position/),
разглеждане на [SVN хранилище](https://plugins.svn.wordpress.org/boat-position/),
или абонамент към [програмната история (log)](https://plugins.trac.wordpress.org/log/boat-position/)
чрез [RSS](https://plugins.trac.wordpress.org/log/boat-position/?limit=100&mode=stop_on_copy&format=rss).

## Списък с промени

#### 1.0

 * Initial release.

## Мета

 *  Version **1.0.0**
 *  Last updated **Преди 1 седмица **
 *  Active installations **По-малко от 10**
 *  WordPress version ** 6.2 или по-висока **
 *  Tested up to **7.0**
 *  PHP version ** 8.1 или по-висока **
 *  Language
 * [English (US)](https://wordpress.org/plugins/boat-position/)
 * Tags
 * [Boat](https://bg.wordpress.org/plugins/tags/boat/)[gps](https://bg.wordpress.org/plugins/tags/gps/)
   [logbook](https://bg.wordpress.org/plugins/tags/logbook/)[map](https://bg.wordpress.org/plugins/tags/map/)
   [tracking](https://bg.wordpress.org/plugins/tags/tracking/)
 *  [Разширен изглед](https://bg.wordpress.org/plugins/boat-position/advanced/)

## Оценки

No reviews have been submitted yet.

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

[See all reviews](https://wordpress.org/support/plugin/boat-position/reviews/)

## Сътрудници

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

## Поддръжка

Имате да кажете нещо? Имете нужда от помощ?

 [Разглеждане на форумите за поддръжка](https://wordpress.org/support/plugin/boat-position/)

## Дарение

Бихте ли желали да подкрепите успеха на разширението?

 [ Направете дарение за това разширение ](https://www.paypal.com/donate/?hosted_button_id=DFM2JV8JKTTM6)