=== MiniBook Dashboard ===
Contributors: pd5dj
Donate link: https://pd5dj.nl
Tags: hamradio, radio, dashboard, qrz, live, realtime, minibook, frequency, dx
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.8.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A real-time MiniBook radio dashboard for WordPress with QRZ-compatible static HTML snapshot output.

== Description ==

The MiniBook Dashboard plugin displays live radio information inside WordPress
and provides a dedicated **QRZ HTML Snapshot** for safe embedding on QRZ.com.

The plugin receives secure POST updates from the MiniBook Desktop Application
and uses the same incoming data for two outputs:

1. A live WordPress dashboard (shortcode or widget)
2. A static HTML snapshot designed specifically for QRZ.com iframe embedding

Displayed information includes:

- Frequency
- Band (payload-based)
- Mode
- Callsign and operator
- Locator (Maidenhead grid)
- Radio label
- LIVE / OFF AIR status with timeout handling

Each dashboard and snapshot is uniquely identified using an ID.

The MiniBook Desktop Application is available at:
https://pd5dj.nl

== QRZ HTML Snapshot ==

For every valid update received from MiniBook, the plugin automatically generates
a static HTML file for QRZ.com usage.

Snapshot directory:

/wp-content/uploads/minibook/

Snapshot filename format:

qrz-YOURID.html

Example:

/wp-content/uploads/minibook/qrz-YOURID.html

The snapshot:
- contains pure HTML with inline CSS
- does not execute PHP
- does not depend on WordPress themes
- is safe for external embedding
- is automatically updated on every POST update

== Using the Snapshot on QRZ.com ==

Edit your QRZ.com biography or HTML section and insert the following iframe:

<iframe
  src="https://yourdomain.com/wp-content/uploads/minibook/qrz-YOURID.html"
  width="100%"
  height="500"
  frameborder="0"
  scrolling="no">
</iframe>

Adjust the height if required.

== Shortcode Usage ==

Basic usage:

[minibook_dashboard id="YOURID"]

Multiple dashboards can be used simultaneously by assigning different IDs.

== Available Styles ==

default – Standard dashboard view with band icons  
compact – Smaller version optimized for sidebars  
cards – Card-based layout with separated blocks  
dark – Dark themed dashboard  
text – Text-only view (no band icons)  
text-compact – Minimal text-only layout for small areas  

== Style Examples ==

[minibook_dashboard id="YOURID" style="cards"]  
[minibook_dashboard id="YOURID" style="dark"]  
[minibook_dashboard id="YOURID" style="compact"]  
[minibook_dashboard id="YOURID" style="text"]  

== Bands ==

The `bands` attribute controls which band icons are visible.
If omitted, all supported bands are displayed.

Important:
Band display is entirely based on the transmitted `band` payload
received from the MiniBook Desktop Application.
No frequency-to-band calculation is performed anywhere in this plugin.

=== Supported band groups ===

hf  → 160m, 80m, 60m, 40m, 30m, 20m, 17m, 15m, 12m, 10m  
vhf → 6m, 4m, 2m, 1.25m  
uhf → 70cm, 33cm  
shf → 23cm, 13cm  

=== Individual band selection ===

Individual bands can be specified using comma-separated values:

bands="20,40,80"  
bands="2,70,23"  

=== Combining band groups and individual bands ===

Band groups and individual bands can be freely combined.
The dashboard will display the union of all specified entries.

Examples:

[minibook_dashboard id="YOURID" bands="hf"]  
[minibook_dashboard id="YOURID" bands="vhf,shf"]  
[minibook_dashboard id="YOURID" bands="hf,13"]  
[minibook_dashboard id="YOURID" bands="hf,23,13"]  
[minibook_dashboard id="YOURID" bands="uhf,shf,20"]  

Text-only example:

[minibook_dashboard id="YOURID" style="text" bands="hf,shf"]

Band highlighting always reflects the currently active band
reported by the MiniBook Desktop Application.

== Installation ==

1. Upload the plugin ZIP via Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Open Settings → MiniBook Dashboard.
4. Copy the generated API key into the MiniBook Desktop Application.
5. Place the shortcode on any page, post, or widget area.
6. (Optional) Embed the QRZ snapshot file on QRZ.com using an iframe.

== Frequently Asked Questions ==

Does the dashboard refresh automatically?
Yes. It updates automatically whenever MiniBook sends POST updates.

Can I run multiple dashboards at once?
Yes. Each dashboard and QRZ snapshot requires a unique YOURID.

Are the API communications secure?
Yes. A unique API key is required for all POST updates.

How are bands detected?
Bands are provided directly by the MiniBook application via the band payload.
No frequency-based detection is used.

What happens when no updates are received?
The dashboard and snapshot switch to OFF AIR after the configured timeout.

== Screenshots ==

1. Default dashboard layout
2. Compact view
3. Text-only display
4. Card-based layout
5. Admin settings (API key)
6. Band icon highlighting

== Changelog ==

= 1.8.1 =
* Added QRZ-compatible static HTML snapshot feature.
* Unified YOURID usage across MiniBook, WordPress, and QRZ.
* Added professional QRZ iframe documentation.
* Documentation fully aligned with current plugin behaviour.

= 1.8.0 =
* Removed deprecated layout styles.
* Band handling fully payload-based.
* Added support for 1.25m and 33cm bands.
* Improved compact layout behaviour.

= 1.7.0 – 1.7.7 =
* Added shortcode band filtering.
* Improved text-only styles.
* Enhanced SHF band handling.
* General layout and UI improvements.

== Upgrade Notice ==

= 1.8.1 =
Recommended update for QRZ.com users.
Adds static HTML snapshot support and improved documentation.
