=== 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.