=== OnlyaClick SEO ===
Contributors: onlyaclick
Tags: seo, meta description, title tag, open graph, ai
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Optimized titles and meta descriptions for every page — written for you by AI in one click, with a live Google preview.

== Description ==

OnlyaClick SEO optimizes how every page of your site appears in search results and when shared on social media.

* **Generate with AI** — one click writes an optimized SEO title and meta description from the page's own content. Add an optional focus keyword to target a specific term. (Requires an OnlyaClick SEO key; see External Services below.)
* **Per-page control** — set the SEO Title and Meta Description on any page or post, with a live Google-style snippet preview and character counters.
* **Smart automatics** — pages without custom values still get an optimized "Page Title | Site Name" title and a clean description generated from their content, so every page is covered from day one.
* **Homepage & separator settings** — hand-write the homepage title/description and choose the title separator.
* **Social sharing tags** — Open Graph and Twitter card tags (with the featured image) so links look right on Facebook, X, LinkedIn and iMessage.
* **At-a-glance status** — an SEO column on the Pages and Posts lists.
* **Plays it safe** — warns if another SEO plugin is active (to avoid duplicate tags) and cleans up fully on uninstall.

The core features (titles, descriptions, automatics, social tags) work entirely on your own site with no external connection. Only the optional AI features (the "Generate with AI" button, and the key-status check on the settings page once a key is saved) contact the OnlyaClick service.

== External services ==

This plugin's optional **Generate with AI** feature connects to the OnlyaClick SEO generation service to write a title and meta description for a page.

* **What it is / what it's for:** an AI service, hosted by OnlyaClick, that returns an optimized SEO title and meta description for the page you are editing.
* **When it sends data:** when a logged-in editor clicks the "Generate with AI" button on a specific page; and, only once a key is saved, when an administrator opens Settings → OnlyaClick SEO, to check that key's status (cached, at most every few minutes). Never on the front end, and never without a key.
* **What data is sent:** the page's title, its text content, its URL, your site name, an optional focus keyword you type, and the OnlyaClick SEO key you configured. No visitor or personal data is sent.
* **Where it is sent:** https://app.onlyaclick.com/seo/generate
* **License check:** when a key is configured, the Settings → OnlyaClick SEO page asks https://app.onlyaclick.com/seo/status whether that key is valid and when it expires, sending only the key and your site URL (cached for 6 hours).
* **Buying a key:** the "Get OnlyaClick AI" button opens the OnlyaClick checkout at https://app.onlyaclick.com/seo/upgrade in a new tab (payment is handled by PayPal on that page, never inside WordPress). The link carries only your site address, and, for the Renew button, your existing key so the same key is extended.
* Service provider: OnlyaClick — Terms: https://www.onlyaclick.com/terms — Privacy: https://www.onlyaclick.com/privacy

If no OnlyaClick SEO key is configured, the plugin never contacts any external service.

== Installation ==

1. Upload the plugin through **Plugins → Add New → Upload Plugin**, or copy the `onlyaclick-seo` folder to `/wp-content/plugins/`.
2. Activate it through the **Plugins** menu.
3. (Optional) Open **Settings → OnlyaClick SEO** and paste your OnlyaClick SEO key to enable the **Generate with AI** button.
4. Edit any page or post — the **OnlyaClick SEO** box appears with the title, description, preview and AI button.

== Frequently Asked Questions ==

= Does it work without the AI key? =
Yes. Titles, meta descriptions, the automatic generation, the snippet preview and social tags all work with no key and no external connection. The key only enables the one-click "Generate with AI" writing.

= Will it conflict with Yoast or Rank Math? =
Running two SEO plugins outputs duplicate tags. OnlyaClick SEO shows a warning if another SEO plugin is active — deactivate one of them.

= What does the AI base the title and description on? =
The page's own content first, plus the page title, your site name, and an optional focus keyword you provide. It never invents facts that aren't in your content.

== Changelog ==

= 1.3.0 =
* AI upgrade can now be purchased directly ($49/year per site, via PayPal); the key is emailed automatically.
* Settings shows live key status: active until date, expiring-soon and expired states with a Renew button.
* Clearer messages when a key is expired or registered to another site.

= 1.2.2 =
* Tested with WordPress 7.1; readme and code hardened for the WordPress.org directory.

= 1.2.1 =
* AI tier priced at $49/year; upsell copy updated. AI generation now runs on a fast, low-cost model.

= 1.2.0 =
* Freemium: free users now see the AI feature as an "Unlock AI" upgrade (branded), instead of it being hidden. Settings shows plan status and an upgrade call-to-action.

= 1.1.0 =
* New: "Generate with AI" button on each page — writes an optimized title and meta description from the page content (optional focus keyword), via the OnlyaClick service. Rate-limited to protect usage.

= 1.0.0 =
* Initial release: per-page titles and meta descriptions, live snippet preview, smart auto-generation, homepage settings, Open Graph/Twitter tags, SEO status column.
