=== Hemmingway AI Writing ===
Contributors: hemmingwayai
Tags: writing, rewrite, ai, gutenberg, dictation
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Improve your writing in the block editor with private previews, guarded Undo and dictation. Connect your existing Hemmingway AI account.

== Description ==

Improve your writing in WordPress. Create stronger drafts and improve clarity, flow and tone. Polish, Shorten, Make warmer, Make more professional, or provide your own writing instruction. Write from a brief, edit the preview, then decide what to use. Every rewrite starts with a preview. You choose whether to apply it; normal WordPress autosave may then save your editor changes.

Use selected text or a selected paragraph or heading block. Apply rewrite checks that the captured block has not changed. Undo restores the exact original only if the applied version is still present. Mixed inline formatting and selections containing images or other embedded objects can be previewed and copied; automatic replacement requires a text-only, uniformly formatted selection so objects, links and emphasis are not silently discarded. Other block types, Classic Editor and third-party page builders are not supported for automatic replacement in this release.

Open the Hemmingway AI sidebar in the WordPress block editor. Connect your existing Hemmingway AI account on hemmingway.io, approve the displayed WordPress site, and paste the one-time connection code back into WordPress. Your password is not shared with WordPress. Existing Hemmingway account allowances and subscriptions apply; free usage is limited. Continued service use may require a paid Hemmingway account. This plugin does not provide a separate unlimited AI service or API credit balance.

Dictation starts only when you choose Start recording and allow microphone access. Stop and transcribe sends audio; Cancel discards the recording without sending it. After Stop has sent audio, Ignore transcription discards only the eventual result; it cannot unsend the audio. Review the editable transcript before using it as a draft or instruction. Dictation needs HTTPS (or a supported localhost environment), browser microphone support and permission. Limits: two minutes and 4 MB per recording, 12,000 characters per draft and 500 per instruction.

= External service and privacy =

This plugin uses Hemmingway AI, https://hemmingway.io/, for account connection, writing and audio transcription. It does not contact Hemmingway until you explicitly start a connection or request a connected action. It sends the site address to identify your connection, the text/brief/style/instruction you submit when you choose Preview, and audio only when you choose Stop and transcribe. It does not send your WordPress password, automatically scan posts or publish content. Network metadata is processed in providing the service.

The connection credential is encrypted in per-user WordPress metadata using the site's authentication salt and that user's identity. Keep control of your WordPress server; site administrators can control code running there. Connections expire within 30 days and also depend on the linked Hemmingway login session. Disconnect removes local credentials and requests server revocation. Signing out of the linked Hemmingway session also invalidates its connection. Uninstall removes this plugin's connection metadata; unused server connections expire or can be invalidated by signing out of Hemmingway.

Privacy policy: https://hemmingway.io/privacy/#wordpress-writing
Terms: https://hemmingway.io/terms/
Support: https://hemmingway.io/contact/

= Updates =

For the directly downloaded release, download the latest ZIP from https://hemmingway.io/wordpress/ and use Plugins > Add New > Upload Plugin to replace the installed version when WordPress prompts you. This release does not silently phone home for plugin update checks.

== Installation ==

1. Download the plugin ZIP from https://hemmingway.io/wordpress/.
2. In WordPress, open Plugins > Add New > Upload Plugin. Select the ZIP, install and activate it.
3. Open a post or page in the block editor and open the Hemmingway AI sidebar.
4. Choose Start account connection. Open Connect on Hemmingway, sign in, review the site and approve. Paste its code into WordPress and choose Finish connecting.
5. Select text or a paragraph/heading block, load it into Hemmingway, and choose Preview. Review before applying. Save or publish your post yourself when ready.

A site administrator must permit plugin installation. WordPress.com sites need a plan that supports installing plugins. Each editor connects their own Hemmingway account; credentials are not shared across WordPress users.

== Frequently Asked Questions ==

= Does this publish or autosave my post? =
The plugin never publishes your post or calls a save endpoint. Applying changes edits your block editor draft, and WordPress's ordinary autosave behavior still applies. You control publishing.

= Does it work offline? =
No. Writing and transcription require a network connection to Hemmingway and available account allowance.

= Why was a preview refused? =
If the service cannot safely preserve a greeting or signature name, it keeps the original and refuses that preview. It does not automatically retry. You can clarify your instruction and choose Preview again.

= What if I edited the document while a preview was running? =
Apply checks the original block and post. Newer edits are kept. Load the selection again before applying a new preview.

== Changelog ==

= 1.0.5 =
* Keep button hover/focus states and form controls consistent with the Hemmingway brand palette.

= 1.0.4 =
* Match Hemmingway’s website palette and Geist typography, with a consistent ink brand mark and clearer success/error states.

= 1.0.3 =
* Lead with improving writing quality, clarity, flow and tone. No permission or processing changes.

= 1.0.2 =
Protects inline images and embedded rich-text objects from automatic replacement. Makes Apply unavailable for unsupported mixed-format or object selections.

= 1.0.1 =
Clarifies recording cancellation versus ignoring an already submitted transcription. Uses the complete plugin prefix in uninstall variables.

= 1.0.0 =
Initial release: account pairing, selected-text and block writing previews, four styles, custom instructions, guarded Apply/Undo, Copy and explicit dictation.
