=== Volteruno – AI Blog Auto-Publish ===
Contributors: vargyasandras
Tags: ai, woocommerce, seo, blog, auto-publish
Requires at least: 5.6
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

More buyers from your blog — while you drink your coffee. AI writes SEO posts, links your WooCommerce products inside, and publishes 100% on autopilot.

== Description ==

**Stop bleeding traffic to competitors who blog and you don't.**

Volteruno turns your WordPress site into a sales machine that runs without you. The AI writes ready-to-rank SEO articles, links your WooCommerce products inside every post, adds internal links to your existing pages, and publishes the whole thing automatically — while you focus on actually running your business.

You don't write a single word. You don't open Yoast. You don't hire an agency.
You just see new posts going live, ranking, and sending buyers to your products.

= What you actually get =

* **AI writes and publishes for you** — 3, 10, or 30 posts a month, fully on autopilot.
* **Your WooCommerce products linked inside every article** — every blog post becomes a silent salesperson with image, price and a "Buy" button.
* **Internal links to your existing pages** — the AI reads your site and weaves in links to your services, categories and key landing pages, so Google sees a real, connected site (not orphan posts).
* **Technical SEO at the level of a senior agency** — clean meta title & description, schema-friendly structure, H1/H2 hierarchy, optimized featured image, alt tags, slug, excerpt. Yoast or Rank Math become optional.
* **25 native languages** — Hungarian, German, French, Spanish, Italian, Polish, Romanian and 18 more, written by AI that actually sounds local. One account, global traffic.
* **Connect in 30 seconds** — paste a Connection Code, click Save. No API keys, no FTP, no developer.
* **You stay in control** — preview, edit, schedule or unpublish anything. Nothing goes live behind your back.

= Why it makes you money =

Most WordPress sites have a blog that's either empty or 3 years old. Google rewards fresh, structured, internally-linked content with product context — exactly what Volteruno produces. Every published article:

* pulls organic traffic from long-tail searches your competitors ignore,
* sends that traffic straight to your WooCommerce products via in-article links,
* signals authority to Google through clean technical SEO and internal linking,
* keeps working for you 24/7, in 25 languages, without a single extra hour of your time.

= Risk-free to try =

Free trial on volteruno.com — no credit card. Your first article can be live within 5 minutes of installing this plugin.

= How it works (3 steps) =

1. **Connect** your WordPress site with one Connection Code.
2. **Pick** the products and topics you want covered.
3. **Autopilot ON** — sit back, posts publish on schedule.

== Installation ==

1. Search "volteruno" in **Plugins → Add New** and click **Install Now**, then **Activate**.
2. Go to **Settings → Volteruno** in your WordPress admin.
3. Open your [Volteruno dashboard → Integrations](https://volteruno.com/integrations) and copy the **Connection Code** for your site.
4. Paste the code, click **Save & Connect**. Done — your site is live-linked.

== Frequently Asked Questions ==

= How much does it cost? =

The plugin is free. The Volteruno account that powers it has a free trial (no credit card) and paid plans starting at the price of a few coffees per month — far less than a single freelance article.

= Am I really listed as the author? =

Yes. Posts are published under your WordPress user, with your name as author. To Google, to your readers, to your customers — it's your blog. We're invisible.

= What if I don't like a generated article? =

Every article can be previewed and edited before going live. You can schedule, unpublish or delete anything from your normal WordPress admin. Nothing is locked.

= Does it really link my WooCommerce products? =

Yes — that's the whole point. The AI reads your product catalog (titles, prices, images) and naturally embeds the most relevant 1–3 products inside each article with image, price and a buy link. Plus it adds internal links to your existing pages and categories.

= Will it ruin my SEO? =

The opposite. Each article ships with a clean meta title and description, proper H1/H2 structure, optimized slug, alt tags on images, an excerpt, internal links and a featured image. This is the technical SEO setup most agencies charge €500/month for.

= Is the connection secure? =

Yes. The plugin creates a dedicated WordPress Application Password (named "Volteruno Auto-Publish") so your real admin password is never shared. One click in **Settings → Volteruno → Disconnect** revokes it instantly.

= Will it touch my existing posts? =

Never. The plugin only **creates new** posts via the official WordPress REST API. It never edits, overwrites or deletes anything you already published.

= Do I need WooCommerce? =

No. Volteruno works on any WordPress site. But if you do run WooCommerce, you unlock the in-article product recommendations — and that's where the real money is.

== Screenshots ==

1. **Find it in WordPress.** Search "volteruno" in Plugins → Add New and click Install Now. No ZIP upload, no FTP.
2. **Activate in one click.** Hit Activate — the Volteruno Connector menu appears under Settings instantly.
3. **Paste your Connection Code.** Grab the code from your Volteruno dashboard, paste it in, click Save & Connect.
4. **Connected and ready.** Green check confirms your site is live-linked to Volteruno and ready to receive AI articles.
5. **Real article, real SEO.** Featured image, table of contents, key takeaways, meta description — published automatically, ready to rank.
6. **WooCommerce products inside articles.** AI-recommended products with image, price and buy link, embedded naturally inside the post.

== Changelog ==

= 2.5.0 =
* New: 3-step onboarding screen for new installs — clear instructions on where to get your Connection Code, with a one-click deep-link to your Volteruno dashboard.
* New: Post-connection "You're connected" screen that shows exactly what to do next: generate an idea, write an AI article, turn on Autopilot. Available on every plan, including the free one.
* New: Steady-state health screen with relative "last heartbeat" timing so you can tell at a glance whether the site is talking to Volteruno.
* Improved: Deterministic 3-state admin UI — the plugin page always shows exactly the right guidance for where you are in the setup (empty → just connected → steady).
* Improved: Real Volteruno community count shown as social proof (rounded, no personal data).
* Improved: Reconnecting an already-connected site no longer re-triggers the welcome celebration screen.

= 2.4.2 =
* Fixed: "Cannot redeclare volteruno_migrate_connected_at()" fatal error when two plugin folders were present during an upgrade. A load-guard now prevents double-registration.

= 2.4.1 =
* Improved: Soft advisory checks (like REST API loopback) no longer block or worry the user on the connection screen — only real blockers are shown. Green "All environment checks passed" appears when the site is reachable.

= 2.4.0 =
* New: Deterministic 3-state admin UI (Onboarding → 24h "You're connected" celebration → Steady-state health screen).
* New: Real Volteruno community count shown as social proof (rounded, no personal data).
* New: Full localization into 25 languages — the admin UI follows your WordPress site language automatically.
* Improved: Migration hook backfills connection timestamps for existing installs so the health screen shows accurate "last heartbeat" timing.

= 2.3.1 =
* Fixed: Self-healing heartbeat check on the `init` hook ensures reporting starts even when `register_activation_hook` is skipped during a ZIP upgrade.
* Fixed: Admin role detection in AJAX/REST contexts now falls back to a direct database check so background heartbeats no longer report a false `admin_role: false`.

= 2.3.0 =
* New: 15-minute heartbeat system — the plugin proactively reports plugin/WP/PHP versions and environment check results to Volteruno so the dashboard always mirrors the real site state.
* New: Public `/wp-json/volteruno/v1/status` endpoint for credential-less connectivity checks.
* New: HMAC-signed `/wp-json/volteruno/v1/handshake` reverse-probe proves the paired site is really this WordPress install.
* Improved: More robust connection code storage and clean deactivate/uninstall lifecycle.

= 2.3.2 =
* New: Public `/wp-json/volteruno/v1/status` endpoint — Volteruno can now verify plugin state without credentials, eliminating "split-brain" cases where the plugin UI and the dashboard disagreed about connection health.
* New: HMAC-signed `/wp-json/volteruno/v1/handshake` reverse-probe proves the paired site is really this WordPress install.
* New: Every 15 minutes, the plugin sends a lightweight heartbeat (plugin version, WP/PHP version, environment check results) to Volteruno so the dashboard always reflects the real state of this site.
* Improved: Deactivating the plugin now cleanly unschedules the heartbeat cron. Reactivating restores it automatically.

= 2.2.3 =
* Fixed: REST API loopback check no longer shows a false-positive red warning on hosts that block self-loopback requests (cPanel, Cloudflare, strict firewalls). When the connection itself succeeds, the warning is suppressed and falls back to two probe URLs.
* Fixed: Deactivating the plugin no longer wipes your saved Connection Code. Reactivating restores the connection instantly — no need to paste the code again. Full cleanup still happens on uninstall.
* Improved: REST API check uses both pretty-permalink and ?rest_route= fallback URLs for higher accuracy.

= 2.2.2 =
* New: Cashvertising-style plugin description and updated WordPress.org banner & icon featuring the official Volteruno brand.
* Improved: Documentation now clearly highlights in-article WooCommerce product linking, automatic internal linking and senior-grade technical SEO.

= 2.2.1 =
* WooCommerce store integration highlighted: AI now reads your product catalog and recommends products inside every article.
* Save & Connect UX overhaul: pre-flight environment checks, structured error messages, no more silent page reloads.
* Added full translations for all 24 official EU languages — the plugin admin UI follows your WordPress site language automatically.
* Added "Copy diagnostic info" button for faster support.

= 2.0.3 =
* Added "External services" section to readme documenting the Volteruno API connection.
* Added vargyasandras to the contributors list.

= 2.0.1 =
* First public release on WordPress.org.
* Full internationalization (i18n) support.
* Added clean uninstall: removes all plugin options and the Volteruno Application Password on plugin deletion.

== Upgrade Notice ==

= 2.5.0 =
Recommended update. Brand-new 3-step onboarding, a post-connect screen that guides you to your first article, and a cleaner steady-state health view — with real relative timings.

== External services ==

This plugin connects your WordPress site to **Volteruno**, a third-party SaaS service operated by Volteruno (https://volteruno.com), so AI-written blog posts created in your Volteruno dashboard can be published to your site automatically.

**What is sent and when:**

* **On connection (only when you click "Save & Connect"):** the plugin sends your site URL, the connecting admin's email/username, the Connection Code you pasted, and a freshly generated WordPress Application Password (named "Volteruno Auto-Publish") to the Volteruno API endpoint at `https://iaifmquygwpugdhrqmpr.supabase.co/functions/v1/wordpress-connect`. This is required so Volteruno can authenticate future publishing requests to your site.
* **Every 15 minutes (heartbeat, only after you connect):** the plugin sends the Connection Code, site URL, plugin/WordPress/PHP version and the results of the local environment checks (HTTPS, Application Passwords, REST API, outbound HTTPS) to `https://iaifmquygwpugdhrqmpr.supabase.co/functions/v1/wordpress-heartbeat`. This lets the Volteruno dashboard show the real health of this site. No post content, user data or credentials are sent.
* **On publishing (only when you trigger a publish from the Volteruno dashboard):** Volteruno sends the post content (title, body, featured image, tags, categories, excerpt, SEO metadata) back to your site via the standard WordPress REST API.
* **WooCommerce product sync (only if WooCommerce is active and only when Volteruno requests it):** Volteruno reads your product catalog (titles, descriptions, prices, images, categories, currency) via the plugin's `/wp-json/volteruno/v1/products` endpoint, authenticated with your Connection Code. This data is used solely to recommend your own products inside articles generated for your site. No customer data, orders, or personal data are ever read.

No data is sent to Volteruno unless you explicitly install this plugin, paste a Connection Code and click **Save & Connect**. The plugin does not send any analytics or telemetry.

The Volteruno backend is hosted on Supabase infrastructure, which is why the API endpoint above is on a `supabase.co` subdomain.

* Service: Volteruno — https://volteruno.com
* Terms of Service: https://volteruno.com/terms
* Privacy Policy: https://volteruno.com/privacy

== Privacy ==

This plugin sends your site URL, the connecting admin's email/username and an auto-generated WordPress Application Password to the Volteruno API (https://volteruno.com) once, when you click **Save & Connect**. After that, the Volteruno service uses those credentials to publish articles you create in your Volteruno dashboard. No analytics or tracking data is collected by the plugin itself. See the [Volteruno Privacy Policy](https://volteruno.com/privacy) for full details.
