Title: Boat Position
Author: Niels Olsen
Published: <strong>2026년 5월 31일</strong>
Last modified: 2026년 7월 4일

---

플러그인 검색

![](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.1.3.0.zip)

 * [세부사항](https://ko.wordpress.org/plugins/boat-position/#description)
 * [평가](https://ko.wordpress.org/plugins/boat-position/#reviews)
 *  [설치](https://ko.wordpress.org/plugins/boat-position/#installation)
 * [개발](https://ko.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 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.

The plugin also adds a **boat log** built on ordinary WordPress posts: place a post
in the _Boat Log_ category, give it coordinates (or default to the boat’s latest
known position), and it appears as a marker on the live map. Your theme handles 
all writing and display, and the `[boat_log_map_link]` shortcode links a post back
to the map and animates to its location.

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.⌉⌊Live map—
current boat position with directional arrow on OpenSeaMap.⌉[

Live map — current boat position with directional arrow on OpenSeaMap.

[⌊Logbook — calendar sidebar, trip list, and route drawn on the map.⌉⌊Logbook — 
calendar sidebar, trip list, and route drawn on the map.⌉[

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.

## 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`,
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 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`

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

## 후기

이 플러그인에 대한 평가가 없습니다.

## 기여자 & 개발자

“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/)
를 확인하시거나, [개발 기록](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.3

 * **Live current track** — the live map now draws the boat’s ongoing trip as it
   happens (solid blue line, with red dashed segments where GPS data was missing).
 * **Route editors** — a dedicated _Manage routes_ capability replaces the generic
   editing permission. Grant it to any Author, Editor or Administrator from **Settings
   Boat Position  Route editors**. Administrators get it automatically; the capability
   is cleaned up on uninstall.
 * **Boat Log by default** — new posts now default to the _Boat Log_ category automatically(
   works in the block editor, classic editor and Divi), so journal entries land 
   on the map without changing the category by hand.
 * **Mobile logbook** — on phones the logbook view stacks into a compact bottom 
   panel: the calendar and legend are hidden, the trip list is condensed, and the
   selected route’s details sit beside it. The desktop layout is unchanged.

#### 1.2

 * **Boat log** — write voyage journal entries as ordinary WordPress posts (so your
   theme / Divi handles all writing and display).
    - Posts placed in the **Boat Log** category appear as markers on the live map.
    - Location meta box in the post editor with a mini map: set coordinates manually
      or click **Use current boat position**.
    - Boat-log posts with no location default automatically to the boat’s latest
      known position on save.
    - New `[boat_log_map_link]` shortcode links a post back to the live map and 
      animates to its location.
    - Public REST feed `GET /wp-json/boat-position/v1/blog-posts` exposes the boat-
      log markers.
    - **Blog** toggle on the live map to show or hide boat-log markers.
    - The _Boat Log_ category is created automatically on activation.

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

## 기초

 *  버전 **1.3.0**
 *  최근 업데이트: **19시간 전**
 *  활성화된 설치 **10보다 적음**
 *  워드프레스 버전 ** 6.2 또는 그 이상 **
 *  다음까지 시험됨: **7.0**
 *  PHP 버전 ** 8.1 또는 그 이상 **
 *  언어
 * [English (US)](https://wordpress.org/plugins/boat-position/)
 * 태그:
 * [Boat](https://ko.wordpress.org/plugins/tags/boat/)[gps](https://ko.wordpress.org/plugins/tags/gps/)
   [logbook](https://ko.wordpress.org/plugins/tags/logbook/)[map](https://ko.wordpress.org/plugins/tags/map/)
   [tracking](https://ko.wordpress.org/plugins/tags/tracking/)
 *  [고급 보기](https://ko.wordpress.org/plugins/boat-position/advanced/)

## 평점

아직 제출된 리뷰가 없습니다.

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

[모든  리뷰 보기](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)