=== Goupil ===
Contributors: remiconvertnative
Tags: seo, blog, content, publishing, ai
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connects your blog to Goupil, the SEO agent that writes, publishes and maintains your posts and their SEO descriptions.

== Description ==

[Goupil](https://goupil.ai) is an SEO agent for businesses without an SEO team: it finds what your customers search for, writes the articles, publishes them and keeps them up to date. This plugin connects your WordPress blog to your Goupil account with a dedicated key, so Goupil can work on your posts directly.

With the plugin, Goupil can:

* draft, update and publish blog posts, with their excerpt, featured image, categories and tags;
* create and edit categories and tags;
* upload the images of its articles to your media library;
* fill in the SEO title and meta description of your posts, categories and tags in Yoast SEO or Rank Math, and check that your SEO plugin really shows them on the page.

What it does not do:

* It never touches your pages, only blog posts.
* It never replaces an SEO description someone already wrote, unless you change it yourself from Goupil.
* It never sends anything on its own: Goupil calls your site, the plugin only answers.

You stay in control:

* You choose in Settings → Goupil which WordPress account signs the articles.
* The key only works over HTTPS, with the rights of the administrator who created it, and only for what this plugin offers. You can revoke it at any time from Settings → Goupil.
* The key is stored as a hash, never in clear, and never written to any log.

A Goupil account is required. Without this plugin, Goupil can still publish through the standard WordPress REST API with an application password; the plugin adds SEO descriptions and works on sites that disable application passwords.

== External services ==

This plugin connects your site to **Goupil** (https://goupil.ai), an SEO service operated by Goupil. It is needed for the plugin to do anything: the plugin exposes REST routes under `/wp-json/goupil/v1/` that only Goupil, holding the key you created, can call.

* **When**: only after you create a key in Settings → Goupil and paste it into your Goupil account, and only while that key is not revoked.
* **What Goupil reads**: your blog posts (title, content, excerpt, status, dates, categories, tags, featured image, author name), your categories and tags, the images Goupil uploaded, the SEO title and description of your posts and terms, the name of the SEO plugin you use, your WordPress and plugin versions, and the name and capabilities of the user tied to the key.
* **What Goupil writes**: the posts, categories, tags, images and SEO fields it creates or edits for you.
* **What the plugin itself sends**: nothing. It makes no outgoing request.

Goupil's [Terms of Service](https://goupil.ai/terms) and [Privacy Policy](https://goupil.ai/privacy) apply to the data Goupil processes.

== Installation ==

1. Install the plugin from Plugins → Add New (search for "Goupil"), or upload the zip from Plugins → Add New → Upload Plugin, then activate it.
2. Open Settings → Goupil. Choose who signs the articles, then create a connection key. It is shown only once: copy it.
3. In Goupil, open your blog settings, choose WordPress, then Edit the connection → Goupil plugin, and paste your site address and the key.

Your site must be served over HTTPS.

== Frequently Asked Questions ==

= Do I need a Goupil account? =

Yes. The plugin is the WordPress side of the connection; Goupil does the work.

= Which SEO plugins are supported? =

Yoast SEO and Rank Math, for posts, categories and tags. If both are active at the same time, Goupil does not write SEO descriptions until only one remains. Without an SEO plugin, Goupil still publishes your posts.

= Rank Math does not show the descriptions Goupil wrote. =

Rank Math prints nothing on your pages until its setup wizard is completed or skipped. Finish or skip it in Rank Math's dashboard, and Goupil will report the description as shown.

= Can Goupil edit my pages or settings? =

No. The key only opens what this plugin offers: blog posts, categories, tags, media and their SEO fields. It cannot reach pages, users, plugins, themes or settings.

= My site sits behind Cloudflare or another proxy and Goupil says HTTPS is required. =

WordPress has to know the request arrived over HTTPS. Most hosts set this up already. If yours does not, declare your proxy's addresses in `wp-config.php`, for example `define( 'GOUPIL_TRUSTED_PROXIES', '173.245.48.0/20' );`, so the plugin trusts its `X-Forwarded-Proto` header.

= How do I disconnect Goupil? =

Revoke the key in Settings → Goupil. Goupil stops working on your site at once. Deleting the plugin also removes its keys and settings.

== Screenshots ==

1. Settings → Goupil: choose who signs the articles and create a connection key.
2. A new key, shown once, ready to paste into Goupil.

== Changelog ==

= 1.0.0 =
* First release.

== Upgrade Notice ==

= 1.0.0 =
First release.
