=== BlazeHive Connect ===
Contributors: yassineblazehive
Tags: seo, landing pages, content, publishing, automation
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish ranked, full-layout SEO pages from BlazeHive straight into WordPress — theme-independent, hands-free, no copy-paste.

== Description ==

**BlazeHive Connect** links your WordPress site to [BlazeHive](https://www.blazehive.io), an SEO content service that researches keywords and writes conversion-focused SEO pages for your product or service. Once connected, finished pages are published to your site automatically — you never copy-paste HTML or fight your page builder.

Landing pages are published as a **standalone, theme-independent layout**: a keyword-specific hero, alternating image-and-text sections, a plain-English explainer, an FAQ, and repeated calls to action — the bottom-of-funnel structure that ranks and converts. The plugin renders each page from structured data stored in post meta, so the design is consistent on **every** WordPress theme and can be restyled later from a single stylesheet without touching your content.

= What it does =

* **Publishes automatically** — BlazeHive pushes finished pages to your site through a secure REST endpoint. No manual export/import.
* **Full side-by-side layout** — hero, alternating image splits, dividers, FAQ, and CTAs, rendered pixel-for-pixel the same on any theme (the plugin loads its own self-contained stylesheet and steps out of your theme's way on landing pages only).
* **Its own URL space** — landing pages live under `/solutions/` (a post-type archive that lists them all, plus automatic inclusion in your WordPress sitemap). If your site already uses `/solutions/`, the plugin picks a free path automatically and tells you which one.
* **Clean SEO head** — per-page `<title>`, meta description, Open Graph, and Twitter tags; canonical and robots handled by WordPress core.
* **Zero layout shift** — every image ships with intrinsic width/height, so pages score well on Core Web Vitals.
* **Never breaks your site** — if anything is malformed, the page renders a safe fallback (heading + description + call to action) rather than a blank screen. Your other post types are completely untouched.

= Other BlazeHive page types =

The plugin also registers post types for BlazeHive's other formats — alternatives, "vs" pages, comparisons, and listicles — published as standard WordPress content.

= External service =

This plugin is a connector for the **BlazeHive** service and requires a BlazeHive account to do anything. It does not generate content on your server.

* **What the service is:** BlazeHive ([https://www.blazehive.io](https://www.blazehive.io)) researches keywords and generates SEO pages and articles.
* **What is sent to BlazeHive:** when you connect, you paste the plugin's generated API key and your site URL into BlazeHive. BlazeHive then calls your site's REST endpoint to create/update posts; the content it sends (copy, image URLs, metadata) originates from BlazeHive and is written into your posts. The plugin itself does not transmit your visitors' data.
* **When it happens:** only when you connect the site in BlazeHive and when BlazeHive publishes a page you approved.
* Terms of Service: [https://www.blazehive.io/terms-of-service/](https://www.blazehive.io/terms-of-service/)
* Privacy Policy: [https://www.blazehive.io/privacy-policy/](https://www.blazehive.io/privacy-policy/)

== Installation ==

1. In WordPress, go to **Plugins → Add New → Upload Plugin**, choose `blazehive-connect.zip`, and click **Install Now**, then **Activate** (or install directly from the WordPress.org directory).
2. Go to **BlazeHive** in your admin sidebar and copy your **Site URL** and **API Key**.
3. In [BlazeHive](https://www.blazehive.io) → **Integrations → WordPress**, paste both values and click **Test connection**.
4. That's it. Pages you approve in BlazeHive publish to your site automatically, at `https://yoursite.com/solutions/<slug>/`.

== Frequently Asked Questions ==

= Do I need a BlazeHive account? =
Yes. The plugin is a connector — it publishes and renders content from BlazeHive. Without an account it registers the post types but has nothing to publish.

= Will these pages look different from my theme? =
Landing pages are intentionally rendered as a standalone, theme-independent layout so they look identical on every site and stay on-brand across your whole landing set. All your other content and post types use your theme normally.

= What URL do landing pages use? =
`/solutions/<slug>/` by default, with a `/solutions/` archive listing them all. If another plugin or page already owns `/solutions/`, BlazeHive Connect automatically uses the next free path (offerings, products, uses, or features) and shows you which one in the connection screen.

= Does it slow down my site? =
No. Live pages render from data stored in your database — no external calls on the visitor's request. Images are served with explicit dimensions to avoid layout shift.

= What happens if something goes wrong with a page? =
The plugin renders a safe fallback (heading, description, and call to action) instead of a blank page, and it never affects your theme or other posts.

= How do I update the plugin? =
Through WordPress as usual — **Dashboard → Updates**, or the **Update** link on the Plugins screen. BlazeHive will also nudge you from your dashboard when a new version is available.

== Screenshots ==

1. A complete landing page published to WordPress — keyword hero, alternating image sections, SEO explainer, and FAQ, all theme-independent.
2. A landing page for a SaaS product (AI meeting notes), with a keyword-specific hero and product mockup.
3. A landing page for a local service (mobile car detailing).
4. A landing page for a professional service (freelance bookkeeping).
5. A landing page for a consumer app (sleep coaching).

== Changelog ==

= 2.3.0 =
* Article pages (alternatives, vs, comparison, listicle) now render with the same clean, theme-independent styling as landing and FAQ pages: consistent typography, spacing, tables, images, and code blocks on every theme.
* Article pages get a proper H1 (the post title) and social preview (Open Graph/Twitter) tags, using the first body image when available.

= 2.2.0 =
* Post type keys renamed from the generic `bh_` prefix to the distinctive `blaz_` prefix (`blaz_landing`, `blaz_faq`, ...), per WordPress.org plugin review.
* Existing content is migrated automatically on upgrade — every page keeps its URL, status, and content.
* The publish API still accepts the old post type names, so no BlazeHive-side change is needed.

= 2.1.0 =
* New: FAQ pages. BlazeHive can now publish one-question-one-answer pages, each rendered as a clean, theme-independent page with a breadcrumb back to the FAQ hub.
* New: automatic `/faq/` archive — a styled hub listing every published question as a card grid, ordered alphabetically (falls back to `/faqs/` if your site already uses `/faq/`).
* FAQ pages get the same per-page SEO head (title, meta description) as other BlazeHive content.
* New: social preview (Open Graph/Twitter) tags on FAQ pages and the FAQ archive.
* Fix: on block themes, landing pages (and the new FAQ pages) no longer output a duplicate <title> tag.

= 2.0.6 =
* All admin and front-end CSS/JS now loads through the WordPress enqueue system (no inline style/script tags).
* JSON-LD output hardened: script-safe encoding so stored markup can never break out of the tag.
* Rendered-page cache now sets an explicit expiration.
* Removed an unnecessary core file include; admin menu moved to a standard position.
* Internal functions and constants renamed to the full blazehive prefix.
* Refined landing page spacing and image framing.

= 2.0.5 =
* Landing pages render as a full, theme-independent side-by-side layout (hero, image splits, results, FAQ, CTA) from structured post meta.
* Automatic `/solutions/` archive as an internal-link hub, with slug-collision fallback if the path is already taken.
* Per-page SEO head (title, meta description, Open Graph, Twitter) and zero-CLS images.
* Safe fallback rendering so a malformed page never white-screens.
* Fix: block data containing quotation marks is now stored and rendered correctly.
* Distributed and updated through WordPress.org.

== Upgrade Notice ==

= 2.3.0 =
Alternatives, vs, comparison, and listicle pages now look polished on every theme, matching the landing and FAQ page treatment.

= 2.2.0 =
Internal rename of post type keys (bh_ to blaz_) for WordPress.org compliance. Existing pages migrate automatically; URLs are unchanged.

= 2.1.0 =
Adds FAQ pages: a styled /faq/ hub plus theme-independent question pages published straight from BlazeHive.

= 2.0.6 =
Hardening and polish: enqueued assets, script-safe JSON-LD output, cache expiration, and refined landing page spacing. Recommended for all BlazeHive users.
