=== Solvera AI Ads for Google and Meta ===
Contributors: solvera
Donate link: https://solvera.cz
Tags: advertising, woocommerce, google-ads, facebook, marketing
Requires at least: 6.3
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress site to Solvera: site snapshot, WooCommerce catalog sync, one-click signup or login, Meta and Google Ads.

== Description ==

**Solvera AI Ads for Google and Meta** connects your WordPress site to [Solvera](https://solvera.cz) — a platform for planning and running performance advertising in **Google Ads** and **Meta** (Facebook / Instagram), with AI-assisted workflows.

The plugin slug is `solvera-ai-ads-for-google-meta`. No Solvera account is required to install the plugin; you create or link an account when you complete the flow on Solvera.

= What the plugin does =

* Builds a structured **snapshot** of your site (name, home URL, description or tagline, locale, WordPress version, **administration email** for account matching, site mode).
* Sends the snapshot when an administrator starts the connection flow (registration or login on Solvera).
* For **WooCommerce** stores: includes product-related data in the snapshot and can expose a **token-protected product feed URL** for catalog use on the platform.
* Retrieves a **site key** after your Solvera account is linked (outbound HTTPS requests only) and can **push snapshot updates** to Solvera.
* Optional **daily** snapshot refresh when you enable the advertising schedule (useful for shops).

= Who develops this =

* **Product (platform):** [Solvera](https://solvera.cz) — this plugin connects your site to that service (**Plugin URI** in the main file).
* **Author / company:** [Solvera Pro](https://solvera.pro) — agency behind the product (**Author** / **Author URI** in the main file).
* **WordPress.org listing:** the *Contributors* field is the WordPress.org username allowed to commit releases (`solvera`). For product support, billing, or campaigns, use [solvera.cz](https://solvera.cz).

= Requirements =

* WordPress **6.3+**, PHP **7.4+**.
* HTTPS recommended so redirects and API calls behave reliably.
* Administrator access to use the plugin screen and start the connect flow.

= Technical notes =

* Default platform URL is `https://solvera.cz`. Developers may override with `SOLVERA_CONNECT_PLATFORM_URL` in `wp-config.php`.
* All outbound calls use the WordPress HTTP API (`wp_remote_post`) and JSON.
* User-facing strings are in **English** (source). A **Russian** translation source file is included in the `languages/` folder. Compile it to `.mo` (e.g. Poedit or `msgfmt`), place it in `languages/`, and set the site language to Russian or use your preferred translation workflow.

== Installation ==

= Automatic installation =

1. In wp-admin go to **Plugins → Add New**, search if the plugin is listed, or use **Upload Plugin** and choose the ZIP.
2. Click **Install Now**, then **Activate**.

= Manual installation =

1. Upload the `solvera-ai-ads-for-google-meta` folder to `/wp-content/plugins/` (or unpack the ZIP so that `solvera-ai-ads-for-google-meta.php` lives inside `wp-content/plugins/solvera-ai-ads-for-google-meta/`).
2. Activate the plugin through the **Plugins** screen.

= After activation =

1. Open **Solvera AI Ads** in the left admin menu (megaphone icon).
2. Optionally set **Site type** (auto-detect, services, or online store) and save.
3. Click **Create new Solvera account** if you are new to Solvera, or **I already have a Solvera account — sign in** if you already use Solvera.
4. On Solvera, use the **same email address** as *Settings → General → Administration Email Address* in WordPress so the site can be matched to your account.

== Frequently Asked Questions ==

= Do I need a Solvera account? =

Yes, to use Solvera’s dashboards and ads tools. You can register during the connect flow or sign in if you already have an account.

= Why must the email match? =

The snapshot includes your site’s **administration email**. Solvera uses it to securely match your WordPress site to your Solvera user when you register or log in. If the emails differ, the site may not link automatically.

= What is the difference between the two connect buttons? =

Both use the same secure handoff token. One opens Solvera **registration**, the other opens **login** for existing users. Pick the one that fits you.

= Does the plugin work without WooCommerce? =

Yes. Without WooCommerce, the snapshot uses simple/site mode. With WooCommerce active (or if you choose the store site type), shop-related data and the optional feed are included.

= Where is data stored on my site? =

A local snapshot (and related options) is stored in your WordPress database. See **External services** for what is sent to Solvera.

= Can I point the plugin to another Solvera environment? =

Yes. Define `SOLVERA_CONNECT_PLATFORM_URL` in `wp-config.php` to a base URL you control (staging or custom host). See the main plugin file header comment.

= Does the plugin add tracking scripts to my front end? =

No tracking scripts are added to the public site for this integration. Communication happens server-side via HTTPS.

= What happens when I uninstall? =

If the plugin includes an `uninstall.php`, removing the plugin via **Delete** can remove plugin-specific options and tables according to that file. Always back up your site before removing plugins you rely on.

== External services ==

This plugin relies on **third-party services** operated by Solvera.

* **Service:** Solvera platform API (default host: `solvera.cz`, HTTPS only in normal configuration).
* **Purpose:** Signup/login handoff with a one-time token, delivery of site snapshot JSON, polling for the site key after the account is linked, and optional ongoing ingest of snapshot updates.
* **Data sent:** As assembled by the plugin: site URL, site title, description or tagline, locale, WordPress version, administration email (for matching the account), site mode (simple vs shop), optional WooCommerce-related product summary and public feed URL, plugin version, and similar snapshot fields. Exact fields may evolve with plugin updates; the snapshot is built in code under `includes/collector.php`.
* **When:** When an administrator starts the connect flow, when polling for credentials, when pushing snapshot updates, and on optional scheduled refresh if enabled.
* **Terms / privacy:** Use [solvera.cz](https://solvera.cz) for terms of use, privacy policy, and support for the Solvera platform.

== Privacy ==

* This plugin stores snapshot and configuration data **in your WordPress database** on your server.
* It transmits snapshot-related data to **Solvera** over HTTPS as described under **External services**.
* If your site needs a privacy policy under GDPR or similar rules, you should mention that you use Solvera for advertising-related services and link to Solvera’s policy where appropriate.

== For developers ==

The plugin exposes filters you can use in a custom plugin or theme:

* `solvera_connect_intro_html` — HTML for the “What you get” block on the admin screen.
* `solvera_connect_pricing_html` — HTML for the plans / trial / store summary block.
* `solvera_connect_default_platform_url` — Default platform base URL if not overridden by constant or option.
* `solvera_connect_sync_url` — Ingest URL and snapshot when pushing data to the platform.

== Changelog ==

= 1.0.0 =
* Initial public release.

== Upgrade Notice ==

= 1.0.0 =
First release. Install when you want to connect your site to Solvera for Meta and Google Ads workflows.
