=== Instant Schema ===
Contributors: 3daystudio
Tags: schema, structured data, json-ld, seo, rich results
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds the Instant Schema structured-data loader to your site so search engines can find accurate Schema.org / JSON-LD markup for every page.

== Description ==

[Instant Schema](https://instantschema.app) generates Schema.org structured data (JSON-LD) for your site automatically. This plugin does exactly one thing: it adds the Instant Schema loader script to your site's `<head>`, using the Site ID from your Instant Schema dashboard.

Everything else — which schema is generated, when it updates, and whether it's live — is managed in the Instant Schema dashboard, not in WordPress.

Full setup walkthrough: [instantschema.app/integrations/wordpress](https://www.instantschema.app/integrations/wordpress)

= What this plugin does =

* Adds one settings field: your **Site ID**.
* Verifies the Site ID with Instant Schema when you save it.
* Outputs the loader script tag in `wp_head` once a Site ID is saved.
* Shows a connection status: Connected, Site ID not recognized, or not verified.
* Links back to your Instant Schema dashboard.

= What this plugin does not do =

* It does not edit, preview, or generate any structured data itself.
* It does not add a second settings screen, a dashboard widget, or any admin-wide notices.
* It does not modify or suppress structured data from any other plugin.

= Compatibility with SEO plugins =

Many SEO plugins (Yoast SEO, Rank Math, All in One SEO) already output their own JSON-LD for things like breadcrumbs, articles, and products. Instant Schema's markup is generated separately and can overlap for some schema types. If a supported SEO plugin is detected active, this plugin shows a one-line, non-blocking notice on its own settings page (Settings → Instant Schema) — nothing is shown elsewhere in wp-admin, and nothing about your SEO plugin's output is changed.

== External services ==

This plugin connects to the Instant Schema API (instantschema.app), which is required for the plugin's core purpose — structured data for your site is generated and served by that service, not by this plugin.

* **What is sent, and when:** When you save a Site ID in Settings → Instant Schema, the plugin sends that Site ID, a fixed `source` value of `wordpress`, and the plugin version to `https://api.instantschema.app/v1/integration-ping`. This does two things: your Instant Schema dashboard shows the integration as configured without waiting for the next scheduled site crawl, and the response verifies the Site ID so the settings page can show Connected / not recognized. The request has a 3-second timeout and fails open — if the service is unreachable, your setting is still saved and the status simply shows as not verified.
* **What is loaded on your site's public pages:** once a Site ID is saved, every page's `<head>` includes `<script src="https://app.instantschema.app/v1/loader.js" data-project-id="YOUR_SITE_ID" async>`. On each page view, that script (served from instantschema.app) fetches the JSON-LD for the current URL from the Instant Schema API and inserts it into the page. No visitor data beyond the standard HTTP request (URL, user agent, IP address) is sent by this mechanism.
* Instant Schema's Terms of Service: [https://instantschema.app/terms](https://instantschema.app/terms)
* Instant Schema's Privacy Policy: [https://instantschema.app/privacy](https://instantschema.app/privacy)

== Installation ==

1. Install and activate the plugin.
2. Go to **Settings → Instant Schema**.
3. Enter your **Site ID** (find it in your Instant Schema dashboard → Integration) and click **Save**.
4. The loader script is now added to every page automatically.

== Frequently Asked Questions ==

= Where do I find my Site ID? =

In your Instant Schema dashboard, under Integration.

= Does this plugin generate the schema itself? =

No. This plugin only adds the loader script. Schema generation, editing, and delivery all happen through the Instant Schema service.

= Will this conflict with my SEO plugin's schema output? =

It can, for overlapping schema types (see "Compatibility with SEO plugins" above). This plugin detects Yoast SEO, Rank Math, and All in One SEO and shows a one-line heads-up on its own settings page when one is active — it does not change what that plugin outputs.

= Does this work with WordPress Multisite? =

Yes. Activate it per-site (not network-wide) and set a separate Site ID on each site, since each site is typically its own Instant Schema project.

== Changelog ==

= 0.1.0 =
* Initial release: Site ID setting, loader script output, status display, dashboard link, SEO-plugin overlap notice.

== Upgrade Notice ==

= 0.1.0 =
Initial release.
