=== LevelUpStats.com Connector ===
Contributors: 314media
Tags: seo, metadata, internal links, automation, search console
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 0.6.21
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect WordPress to LevelUpStats.com so approved SEO missions can be reviewed, applied, verified, and rolled back.

== Description ==

LevelUpStats.com Connector connects a WordPress site to the LevelUp Stats service. After an administrator connects the site with a one-time key from LevelUpStats.com, the plugin can pull approved SEO jobs from LevelUp Stats and apply supported changes inside WordPress.

Current features:

* Connect a WordPress site to LevelUpStats.com with a one-time setup code.
* Pull approved SEO title and meta description jobs from LevelUp Stats.
* Support SEO title and meta description fields for Yoast SEO, Rank Math, and All in One SEO.
* Create draft page jobs when approved in LevelUp Stats.
* Verify draft pages and published pages so LevelUp Stats can separate draft progress from completed mission rewards.
* Support guided internal link placement and live internal link verification.
* Insert approved page-copy enhancement blocks for local intent and content refresh missions.
* Add approved schema JSON-LD to supported pages.
* Keep a recent fix log with before and after values.
* Roll back supported SEO field changes from the plugin queue screen.
* Run jobs manually, through a scheduled WordPress cron pull, through the signed one-click apply endpoint used by Level Up Stats, or with the Pull & Apply Approved Fixes button.

This release does not include a custom plugin updater. Updates should be installed through the standard WordPress plugin upload/update process while the plugin is being prepared for directory submission.

== External Service ==

This plugin relies on the LevelUp Stats service when a site administrator connects the plugin to a LevelUp Stats account. The service is required for connection, capability checks, pulling approved jobs, and sending job completion results.

Service: https://levelupstats.com
Privacy Policy: https://levelupstats.com/privacy.php
Terms: https://levelupstats.com/terms.php

Data sent during connection and scheduled check-ins can include the site URL, site name, WordPress version, PHP version, REST API base URL, detected SEO adapter, and supported connector capabilities.

Data sent when jobs are completed or verified can include the mission/job ID, success status, completion message, affected post ID, post status, slug, live URL, edit URL, and before/after values for fields changed by the approved job.

The plugin does not send this data until an administrator enters a LevelUp Stats app URL and one-time connection key/setup code.

== Installation ==

1. Upload the plugin ZIP in Plugins > Add New > Upload Plugin.
2. Activate LevelUpStats.com Connector.
3. Go to LevelUp Stats > Settings.
4. Paste your LevelUp Stats setup code.
5. Click Connect site.
6. Review approved jobs under LevelUp Stats > Queue.

== Frequently Asked Questions ==

= Is a LevelUp Stats account required? =

Yes. The plugin is a connector for the LevelUp Stats service and does not generate missions by itself.

= Which SEO plugins are supported? =

LevelUpStats.com Connector currently supports Yoast SEO, Rank Math, and All in One SEO for SEO title and meta description fields.

= Does it change normal WordPress post titles? =

No. The plugin updates supported SEO plugin fields for title and meta description jobs. Draft page jobs can create draft content when approved in LevelUp Stats.

= Can changes be rolled back? =

Supported SEO field changes can be rolled back from the Queue screen. Rollback availability depends on the saved before value and the type of job that was applied.

= How are jobs authorized? =

The plugin uses a site token created during the one-time connection flow. LevelUp Stats uses that token when checking connector status and sending approved jobs.

= Does uninstall remove data? =

On uninstall, the plugin removes its stored connector settings, database version option, and scheduled cron hook. The fix log table is kept so site owners do not accidentally lose audit history.

== Changelog ==

= 0.6.18 =
* Added a protected one-click apply REST endpoint so Level Up Stats can queue approved content fixes and ask WordPress to process them immediately.
* Reports one-click apply capability during connector check-ins.
* Keeps the existing Fix Queue fallback if the remote apply request is blocked by hosting, security plugins, or firewall rules.

= 0.6.17 =
* Documented intentional WordPress core content-filter usage for rendered verification text.
* Tuned the one-post mission lookup and documented its bounded meta-query exception for Plugin Check.
* Documented the custom queue-table update caching exception used when processing fixes.

= 0.6.16 =
* Renamed the visible connector title to LevelUpStats.com Connector.
* Replaced customer-facing admin status wording with Connector Status.
* Added stricter sanitization for approved jobs before they are stored or processed.

= 0.6.10 =
* Added Return to Site button beside Apply All Pending Fixes.
* Bumped admin asset cache version.


= 0.6.8 =
* Renamed the connector title to LevelUpStats.com Connector.
* Updated plugin author branding to levelupstats.com.
* Removed the custom connector updater from the plugin for submission readiness.
* Updated readme and external service copy to match current capabilities.

= 0.6.6 =
* Bumped the connector package version so WordPress sites running 0.6.5 can detect a native update from Level Up Stats.
* No connection, queue, or verification behavior changed in this test release.

= 0.6.5 =
* Added native WordPress plugin update support through the Level Up Stats app manifest and package endpoints.
* Added optional automatic connector update setting that respects WordPress native auto-update behavior.
* Added update status details to the connector settings screen.

= 0.6.4 =
* Added draft-page and published-page verification support for LevelUp Stats.
* Added post status and slug reporting for completed jobs.

= 0.6.3 =
* Fixed WordPress.org Plugin Check header issue by using a plugin-specific Plugin URI that differs from the Author URI.

= 0.6.2 =
* Cleaned up WordPress Plugin Check findings for nonce/sanitization, dynamic SQL identifiers, textdomain loading, and readme compatibility metadata.

= 0.6.0 =
* Updated plugin version, readme stable tag, and internal database version to match.
* Moved admin CSS into an enqueued stylesheet for WordPress.org review compatibility.
* Added privacy policy suggested text for the external LevelUp Stats service.
* Improved external service disclosure in the readme.
* Changed manual job run and rollback actions to nonce-protected POST forms.
* Added same-site URL checks before live internal link verification fetches a page.
* Added WordPress.org normal-size icon and banner assets.

See changelog.txt for earlier release notes.
