=== HeadlessNext Connector ===
Contributors: aarudhnextgen
Tags: headless, decoupled, webhook, revalidate, api
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Point WordPress at a decoupled front end and automatically notify it when content changes.

== Description ==

HeadlessNext Connector adds headless/API-friendly capabilities to **any**
active WordPress theme. It does not require, and is not required by, any
particular theme.

Features in this release:

* A **Settings → HeadlessNext Connector** page where you can configure the
  base URL of a decoupled front end (for example a Next.js or Nuxt app),
  the path that accepts revalidation requests, and an optional shared
  secret.
* An **on-demand revalidation webhook**: when enabled, the plugin fires a
  fire-and-forget `POST` request to your configured frontend every time a
  post or page is published or updated, so your frontend can revalidate its
  own cache for that content. WordPress's own save/publish flow is never
  slowed down waiting for a response.
* When no Frontend URL is configured, the plugin makes **zero outgoing
  requests** — it is completely inert out of the box.

This plugin does not modify your site's public-facing templates, register
any custom post types, or gate any feature behind a license key. It is
free and fully functional standalone.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/headlessnext-connector`
   directory, or install the plugin through the WordPress Plugins screen
   directly.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Go to Settings → HeadlessNext Connector and enter your frontend's URL.
4. Check "Automatically ping the frontend..." if you want revalidation
   requests to fire automatically on publish/update.

== Frequently Asked Questions ==

= Does this plugin require a specific theme? =

No. It works with any active theme, including the default WordPress themes.

= What does the plugin actually send to my frontend? =

A JSON POST body containing the post ID, post type, slug, permalink, the
triggering action, and the site's home URL, plus an
`X-HeadlessNext-Secret` header if you've set a shared secret.

= Does this plugin phone home or require a license key? =

No. There is no license gating, tracking, or paid tier in this plugin.

= How do I verify the request came from my WordPress site? =

Set a Revalidation Secret in the settings page, then check the
`X-HeadlessNext-Secret` header on your frontend's revalidation endpoint
before honoring the request.

== Screenshots ==

1. The Settings → HeadlessNext Connector page.

== Changelog ==

= 1.0.0 =
* Initial public release: settings page, on-demand revalidation webhook.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
