=== Mentionwell ===
Contributors: mentionwell
Tags: mentionwell, ai, llm, content, webhook, ai-bots, crawlers, rtl
Requires at least: 6.0
Tested up to: 6.5
Requires PHP: 8.0
Stable tag: 0.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Receive Mentionwell publish webhooks and pipe AI-bot crawl logs back to Mentionwell.

== Description ==

Mentionwell connects your WordPress site to the Mentionwell content platform.

* Receives signed publish webhooks from Mentionwell and creates or updates posts (slug-keyed, idempotent).
* Sideloads featured images, applies category mapping, and stores JSON-LD schema.
* Logs AI-bot crawler hits (GPTBot, ClaudeBot, PerplexityBot, and more) and forwards them to Mentionwell every minute.
* Wraps Hebrew and Arabic posts in `dir="rtl"` automatically.

All requests are HMAC-SHA256 signed using the secret distributed during the Mentionwell Connect flow and verified with `hash_equals` constant-time compare.

== Installation ==

1. Download `mentionwell-wordpress.zip` from Mentionwell, then use **Plugins → Add New → Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Settings → Mentionwell** and paste your PAT (`mw_pat_*`) and the auto-generated webhook secret from the Mentionwell admin.
4. In Mentionwell choose the WordPress CMS adapter, paste the displayed webhook URL, save, and run **Test connection**.

== Frequently Asked Questions ==

= What WordPress version do I need? =
WordPress 6.0 or newer, PHP 8.0 or newer.

= Does this plugin require Composer? =
No. Pure WordPress + PHP standard library.

= Where are bot crawls stored? =
In a custom table `wp_mw_bot_crawls`. Rows are flushed once per minute via `wp-cron` and removed if you uninstall the plugin.

= Does it work with Yoast or Rank Math? =
Yes. If either is active, Mentionwell defers to them for JSON-LD output.

== Screenshots ==

1. assets/screenshot-1.png – Settings page under Settings → Mentionwell.
2. assets/screenshot-2.png – Bot crawl log preview.
3. assets/screenshot-3.png – RTL article rendering.

== Changelog ==

= 0.1.0 =
* Initial release: signed publish webhook receiver, AI-bot crawl logger, RTL wrapper, settings UI.

== Upgrade Notice ==

= 0.1.0 =
First public release.
