=== RankWiz AI ===
Contributors: heatware
Tags: seo, content-optimization, google-search-console, ai-writing, recommendations
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bidirectional WordPress integration for RankWiz AI — publish AI-optimized content, track ROI, and keep your site in sync automatically.

== Description ==

RankWiz AI is a native WordPress plugin that creates a secure, bidirectional bridge between your WordPress site and the RankWiz AI application. Unlike one-way SEO tools that only read your content, RankWiz AI can **publish optimized drafts back to WordPress** and automatically notifies the app whenever your content changes.

**What makes RankWiz AI different:**

* **One-click publishing** — Push AI-optimized content rewrites directly from the RankWiz app to WordPress as a draft or live post.
* **Bidirectional sync** — Webhooks keep the RankWiz app updated whenever you create, edit, or delete posts in WordPress.
* **Conflict detection** — Safely handles simultaneous edits; detects and reports conflicts before overwriting your content.
* **Content version history** — Every publish creates a snapshot in the RankWiz app, giving you a complete version history and one-click rollback.
* **Dashboard widget** — See your pending SEO recommendations, recently applied changes, and ROI summary right from the WordPress dashboard.
* **Yoast SEO integration** — Reads your Yoast meta titles, meta descriptions, robots settings, and canonical URLs. Falls back gracefully when Yoast is not installed.
* **ROI tracking** — The dashboard widget shows click lift and CTR improvement from applied recommendations.

**Security-first design:**

* HMAC-SHA256 signed requests with replay protection and nonce validation
* Shared secret encrypted at rest using Libsodium (XSalsa20-Poly1305)
* 24-hour grace period during secret rotation for seamless key updates
* Rate limiting on all endpoints

== Installation ==

1. Upload the `rankwiz-ai` folder to `/wp-content/plugins/`
2. Activate the plugin through the **Plugins** menu in WordPress
3. Go to **Settings > RankWiz AI**
4. Enter the **Setup Token** from the RankWiz AI app
5. Save Changes, then return to the RankWiz AI app and click **Complete Connection**

For help, visit the **?** icon on the Settings page for step-by-step guidance.

== Frequently Asked Questions ==

= Does this work without Yoast SEO? =
Yes. When Yoast SEO is not installed, the plugin falls back to reading meta information from standard WordPress fields (post title, excerpt, and canonical URL).

= Can I use this with pages as well as posts? =
Yes. The plugin supports both `post` and `page` post types.

= What PHP version is required? =
PHP 8.1 or higher. The plugin uses modern PHP features including strict types, named arguments, and Libsodium encryption.

= Is my data secure? =
Yes. All communication is authenticated with HMAC-SHA256 signatures. Your shared secret is encrypted at rest. No content is sent without your explicit action in the RankWiz AI app.

== Changelog ==

= 1.0.0 =
* Initial release
* HMAC-SHA256 authentication with nonce replay protection
* Bidirectional sync: inventory, content, publish, webhooks
* Conflict detection on publish
* Yoast SEO integration with fallback
* Dashboard widget with pending recommendations and ROI summary
* Admin settings page with Test Connection, Secret Rotation, diagnostics
* Contextual help tabs with troubleshooting guide