=== Allable Connector ===
Contributors:      flexyma
Tags:              ai, mcp, connector, automation, agent
Requires at least: 6.9
Tested up to:      7.0
Requires PHP:      7.4
Stable tag:        0.13.3
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Official companion plugin that lets Allable manage your WordPress site safely and in one click.

== Description ==

**Allable Connector** is the official WordPress companion plugin for [Allable](https://allable.ai). It bundles the WordPress MCP Adapter, exposes Allable-owned REST endpoints under `/wp-json/allable/v1/*`, and ships a small "Connected to Allable" admin panel so site owners always know what Allable is doing.

The plugin is designed to be **fail-safe by construction**: it self-deactivates on any uncaught error rather than risking a fatal on your site, every REST endpoint is authenticated with a WordPress Application Password and gated by capability checks, and the bundled MCP adapter is namespace-isolated by [Jetpack Autoloader](https://github.com/Automattic/jetpack-autoloader) so it never collides with other plugins shipping the same library.

Key features:

* One-click connection — install one plugin, not three
* Authoritative `/site-info` and `/health` endpoints — no more guessing PHP version or memory limit
* SEO metadata read/write for Rank Math, SEOPress, and Yoast, exposed as MCP abilities
* Programmatic permalink-flush — fixes the dreaded `rest_no_route` 404 without admin hand-holding
* Self-deactivating safety shield — a PHP fatal in our code never takes down your site
* WordPress Application Password authentication with capability checks on every call
* Top-level **Allable** admin page showing status, last action, and a one-click Disconnect

Allable Connector is developed and maintained by [Flexyma](https://flexyma.com).

= Privacy =

The plugin never sends your post content, customer data, or any database content to Allable without an explicit, authenticated request from your Allable workspace. The plugin collects no telemetry or analytics and sends nothing in the background.

== External services ==

This plugin connects to the Allable platform (operated by Flexyma). It is the official connector for that platform, so connecting your site to Allable is the plugin's core purpose. The service it contacts is described below, including what data is sent and when.

**Allable platform (allable.ai / studio.allable.ai)**

When you click **Connect to Allable**, the plugin sends your browser to `https://studio.allable.ai/plugins/wp/connect-from-wp` to authorise the connection. Connecting creates a dedicated WordPress Application Password for Allable. After that, your Allable workspace makes authenticated requests to your site's REST API to read and write the data you ask it to manage (for example post and page content, SEO metadata, and site information). Data leaves your site to Allable **only** in response to such an authenticated, user-initiated request — nothing is sent in the background.

This service is required for the plugin to function. By connecting you agree to Allable's terms and privacy/GDPR policy:

* Terms of Service: https://www.allable.ai/terms-of-service/
* Privacy & GDPR policy: https://www.allable.ai/gdpr/

== Installation ==

= From the WordPress plugin directory (recommended) =

1. In WordPress, go to **Plugins → Add New** and search for "Allable Connector".
2. Click **Install Now**, then **Activate**.
3. Go to **Allable** in the admin menu and click **Connect to Allable** — or start the connection from your Allable workspace. Connecting creates a dedicated Application Password for Allable; no keys to copy by hand.

= Manual upload =

1. Download the plugin .zip from this plugin's WordPress.org page.
2. In WordPress: **Plugins → Add New → Upload Plugin**, choose the .zip, then **Install Now** and **Activate**.
3. Visit **Allable** in the admin menu and click **Connect to Allable**.

= Updates =

Updates are delivered through WordPress in the normal way: you are notified on the **Plugins** and **Dashboard → Updates** screens when a new version is published, and you can enable automatic updates for the plugin like any other. The plugin does not fetch updates from any third-party source.

= Requirements =

* WordPress 6.9 or higher
* PHP 7.4 or higher
* WordPress Abilities API (available in WordPress 6.9+ — without it the MCP adapter sits idle but the plugin still runs safely)

== Frequently Asked Questions ==

= Is this plugin safe to install on a production site? =

Yes. The plugin is designed against a "no fatal error on a customer site" contract: a `Requires PHP` / `Requires at least` loader header blocks activation on incompatible hosts, the activation hook wraps bootstrap in try/catch, and a global shutdown handler self-deactivates the plugin if a PHP fatal ever escapes our code (instead of taking the site down). Every release passes a PHP 7.4–8.3 × WP 6.9–latest CI matrix before publishing.

= Does it work with Rank Math, SEOPress, and Yoast? =

Yes. SEO metadata read/write is exposed as MCP abilities for Rank Math, SEOPress, and Yoast SEO, so a connected AI client can read and update titles, descriptions, focus keywords, and more on the SEO plugin you already use.

= Does it work with WooCommerce? =

Yes. WooCommerce abilities (products, orders, and customers — HPOS-compatible) and The Events Calendar abilities (events, venues, and organizers) are bundled. Because they touch commerce and customer data, they ship disabled by default — enable the ones you want on the **Abilities** admin tab. Each registers only when the corresponding plugin is active.

= Multisite? =

The plugin loads cleanly on multisite. Site-by-site activation is the supported configuration in v1.

= Where do I get support? =

Email [support@allable.ai](mailto:support@allable.ai) or open a ticket from your Allable workspace.

= How do I disconnect? =

Visit **Allable** in the WordPress admin menu and click **Disconnect from Allable**. The plugin revokes the Application Password it was using, clears its stored connection state, and deactivates itself.

== Screenshots ==

1. The Allable admin page showing connection status, last action, and disconnect button.
2. The Abilities tab listing available MCP tools with toggle controls and destructive/opt-in badges.

== Changelog ==

= 0.13.3 - 2026-06-22 =
* Tweak: Updated readme.txt for the WordPress.org listing — added Screenshots section and standardized changelog entry prefixes to WordPress.org conventions.

= 0.13.2 - 2026-06-19 =
* New: Initial public release.
