=== Turnkey Directories Reading Toolbar ===
Contributors: turnkeydirectories
Tags: text to speech, dark mode, reading toolbar, print, share
Requires at least: 5.9
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A clean reading toolbar for your articles: text-to-speech, dark mode, one-click summarize and translate links, share buttons, and a clean print view.

== Description ==

Turnkey Directories Reading Toolbar ("TKD Toolbar") adds a clean, floating toolbar to your blog posts — a lightweight set of reader tools that make your articles nicer to read, listen to, share, and print. It works with any theme, loads only on the post types you choose, and keeps things private: no visitor data collection, no database tables, and no external requests.

**Features:**

* **Text-to-Speech** - Let readers listen to your articles using the browser's own speech synthesis (no external service, no API key)
* **Dark Mode** - One-click reading toggle with smooth transitions, works with any theme
* **Print View** - A clean print stylesheet that strips the clutter for a tidy printout
* **Summarize Link** - A button that opens the current article in ChatGPT for a quick summary
* **Translate Links** - Language links that open a Google-translated copy of the article in a new tab
* **Share Buttons** - Share to X, Facebook, LinkedIn, Gmail, or copy the link
* **Glass-style Toolbar** - A beautiful floating toolbar above the article, with a compact mobile speed-dial
* **Theme Compatibility Profiles** - Dedicated tuning for Kadence, Astra, GeneratePress, Blocksy, Neve, OceanWP, Divi, Avada, Storefront, and block themes

The plugin is lightweight, works with any theme, and only loads on the post types you enable (posts only by default).

== Installation ==

1. Upload the `turnkey-directories-reading-toolbar` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to **TKD Toolbar** in the admin menu to configure features
4. Visit any blog post to see the toolbar in action

== Frequently Asked Questions ==

= Does the toolbar work with my theme? =

It is designed to work with any WordPress theme, and has been tested with popular themes including Twenty Twenty-Five, Kadence, Astra, GeneratePress, Blocksy, Neve, OceanWP, Divi, Avada, and Storefront.

= Does the plugin slow down my site? =

No. It only loads its assets on single post pages (or whatever post types you enable) and uses lightweight vanilla JavaScript with no external dependencies.

= Does the plugin collect any visitor data? =

No. The plugin stores only your settings. It creates no database tables, registers no REST endpoints, and initiates no requests to external services. Your dark-mode preference is kept in the visitor's own browser storage.

= How does the Translate feature work? =

The Translate button shows a list of language links. Clicking one opens a Google-translated copy of the article at translate.google.com in a new tab. No translation script is loaded on your site.

= How does the Summarize feature work? =

The Summarize button is a plain link that opens chatgpt.com in a new tab with a prompt asking for a summary of the article's public URL. Nothing is sent from your server, and no API key is needed.

== Third-party services ==

The plugin itself makes no outbound requests from your server or your visitors' browsers. The toolbar contains ordinary links that, when a visitor chooses to click them, navigate to third-party sites in a new tab:

* **ChatGPT (chatgpt.com)** — the Summarize link opens the article URL in ChatGPT. [Terms](https://openai.com/policies/terms-of-use/) / [Privacy](https://openai.com/policies/privacy-policy/)
* **Google Translate (translate.google.com)** — the Translate links open a translated copy of the article. [Terms](https://policies.google.com/terms) / [Privacy](https://policies.google.com/privacy)
* **Share targets** — the share buttons link to the standard share endpoints of X (twitter.com), Facebook, and LinkedIn.
* **Gmail (mail.google.com)** — the email share button opens Gmail's web compose window in a new tab with the article title and link pre-filled, so it works without a desktop mail app. [Terms](https://policies.google.com/terms) / [Privacy](https://policies.google.com/privacy)

In every case the visitor initiates the navigation by clicking a link; the plugin sends no data in the background.

== Screenshots ==

1. Floating toolbar with summarize, translate, listen, dark mode, print, and share actions
2. Mobile speed-dial with the same reading tools
3. Settings screen — toggle each feature independently

== Changelog ==

= 1.0.0 =
* Initial release.
