=== Harbor – Display Preferences ===
Contributors: harboraccessibility
Tags: accessibility, readability, contrast, font size, reduced motion
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A free panel that lets each visitor set text size, spacing, contrast and motion for themselves. It does not claim to make your site conformant.

== Description ==

Harbor adds a small "Display Preferences" button to every page of your site. A visitor who opens it can change how your pages look for them:

* Bigger text, plus more line height, letter spacing and word spacing
* High contrast, in a light or a dark version
* Less motion and animation
* Underlined links and a stronger outline on whatever has keyboard focus

Their choices are saved in their own browser and come back on their next visit, applied before the page first paints. Nobody else sees a change, and your pages are not touched.

Harbor follows the visitor's operating system first. If they already ask their device for reduced motion or higher contrast, Harbor starts from that. When Windows high contrast (forced colours) is already repainting the page, Harbor's own colour options switch off so they don't fight it. Text size, spacing and the other settings still work.

If bigger text would make the page scroll sideways on a narrow screen, Harbor steps the setting down until it fits, and tells the visitor it did. If your theme fixes its text size so the text control cannot reach it, the panel says so and points to the device's own zoom, rather than showing a setting that changed nothing.

= What it does not do =

This matters more than the feature list, so it comes first in our own documentation too.

* **It does not make your site conformant** with WCAG, the ADA, Section 508, the EAA or any other standard, and it never claims to. It changes presentation for one visitor in one browser.
* **It does not repair your pages.** No generated alt text, no invented headings, no injected ARIA, no rebuilt keyboard handling.
* **It does not reduce your legal exposure.** Treat it as a convenience for visitors, not a fix for a page that needs fixing. Real fixes come from testing your site and changing its code.
* **It does not profile visitors.** No cookies, no tracking, no advertising, and nothing leaves the visitor's browser.

= Setup =

There isn't any. Activate the plugin and the button appears. There is no account, no signup and no settings page.

= Privacy =

Everything runs in the visitor's browser from files this plugin installs on your own site. The plugin contacts no other server. If a visitor changes a setting, one `localStorage` entry named `harbor.v1` on your domain holds it, and it is never sent anywhere.

The plugin adds suggested wording to Settings > Privacy, so your own privacy policy can mention it.

= Source code =

The scripts in `assets/js/` are built with esbuild from the readable source in the plugin's `src/` folder. `head.js` and `panel.js` are the two entry points; every other file there is imported by one of them. To rebuild them from the plugin folder:

`npx esbuild src/head.js --bundle --minify --format=iife --target=es5 --outfile=assets/js/harbor-head.js`

`npx esbuild src/panel.js --bundle --minify --format=iife --target=es2020 --outfile=assets/js/harbor-panel.js`

== Frequently Asked Questions ==

= Does this make my site ADA or WCAG compliant? =

No. No widget can. Conformance depends on your site's own code and content. Harbor gives visitors a way to adjust presentation for themselves, which is useful, but it is not a remedy and we do not sell it as one.

= Does it cost anything? =

No. No account and no card.

= Does it slow my site down? =

The script that applies saved preferences before first paint is under 4 KB compressed. The panel, about 9 KB, loads deferred in the footer. Both are served from your own site and cached by the browser.

= Will it conflict with another accessibility widget? =

Running two is not a good experience for visitors. We suggest choosing one.

== Screenshots ==

1. The Display Preferences button on a page.
2. The open panel: text size and spacing come first, then colour and contrast, motion and reading aids.
3. A page with high contrast (dark) and bigger text switched on.

== Changelog ==

= 1.1.0 =
* The panel now ships inside the plugin. Nothing is loaded from any other server.

= 1.0.0 =
* First release.
