=== InstaRank ===
Contributors: instarank
Tags: seo, optimization, meta tags, search engine, ai, programmatic seo, custom post types
Requires at least: 5.6
Tested up to: 6.8
Stable tag: 1.3.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WordPress site to InstaRank for AI-powered SEO and programmatic content. Automatically apply SEO improvements and sync custom post types generated by InstaRank's AI engine.

== Description ==

InstaRank is the official WordPress plugin for the InstaRank platform. It enables seamless integration between your WordPress site and InstaRank's AI-powered SEO optimization engine and programmatic SEO tools.

= Key Features =

* **Easy Connection**: Connect your WordPress site to InstaRank with a simple API key or one-click OAuth
* **AI-Powered SEO**: Receive intelligent SEO recommendations powered by advanced AI
* **Programmatic SEO**: Create and sync custom post types between InstaRank and WordPress
* **Bidirectional Sync**: Sync post types from InstaRank to WordPress and vice versa
* **Custom Post Type Management**: Register, update, and manage custom post types directly from InstaRank
* **Review Before Apply**: Review all suggested changes before they're applied to your site
* **Safe Rollback**: Easily rollback any changes if needed
* **Change History**: Track all SEO modifications with a complete audit log
* **SEO Plugin Detection**: Automatically detects and integrates with popular SEO plugins like Yoast SEO, Rank Math, and All in One SEO
* **Flexible Approval**: Choose between manual review or automatic approval of changes

= Supported Change Types =

* Meta titles and descriptions
* Open Graph tags (og:title, og:description, og:image)
* Post content optimization (NEW in v1.1.0)
* Image alt text optimization
* Canonical URLs
* Focus keywords
* Robots meta tags
* Post titles

= How It Works =

**Easy OAuth Connection (NEW in v1.2.1):**

1. Install and activate the plugin
2. Click "Connect with InstaRank" button in WordPress admin
3. Sign in to your InstaRank account (popup window)
4. Select the project to connect
5. Done! Your WordPress site is connected

**Or use the manual API key method:**

1. Install and activate the plugin
2. Copy the generated API key from the plugin dashboard
3. Connect your site from your InstaRank account at instarank.com
4. InstaRank analyzes your site and generates SEO improvements
5. Review and approve changes from your WordPress dashboard
6. Changes are applied automatically to your content

= Privacy & Data =

This plugin communicates with the InstaRank platform (https://instarank.com) to:

* Send site information and content for SEO analysis
* Receive SEO optimization recommendations
* Sync change status and results

For more information, see our [Privacy Policy](https://instarank.com/privacy) and [Terms of Service](https://instarank.com/terms).

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to Plugins > Add New
3. Search for "InstaRank"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin ZIP file
2. Log in to your WordPress admin panel
3. Navigate to Plugins > Add New > Upload Plugin
4. Choose the downloaded ZIP file and click "Install Now"
5. Activate the plugin

= After Installation =

1. Go to InstaRank in your WordPress admin menu
2. Copy the API key displayed on the dashboard
3. Log in to your InstaRank account at https://instarank.com
4. Add your WordPress site using the API key
5. Start receiving AI-powered SEO recommendations!

== Frequently Asked Questions ==

= Do I need an InstaRank account? =

Yes, you need an active InstaRank account to use this plugin. Sign up at https://instarank.com

= Is this plugin free? =

The plugin itself is free, but it requires an InstaRank subscription to function. Visit https://instarank.com/pricing for subscription details.

= Which SEO plugins are compatible? =

InstaRank works with:

* Yoast SEO
* Rank Math
* All in One SEO Pack
* The SEO Framework
* SEOPress
* Or as a standalone SEO solution

= Can I review changes before they're applied? =

Yes! By default, all changes require manual approval. You can optionally enable auto-approval in the settings.

= Can I rollback changes? =

Absolutely. Every change is tracked and can be rolled back with a single click from the Pending Changes page.

= How is my data used? =

Your site content is sent to InstaRank's servers for SEO analysis. We do not share your data with third parties. See our [Privacy Policy](https://instarank.com/privacy).

= What happens if I deactivate the plugin? =

All SEO changes that were applied remain on your site. The plugin will stop communicating with InstaRank, and you won't receive new recommendations.

= Where can I get support? =

For support, visit https://instarank.com/support or email support@instarank.com

== Screenshots ==

1. Dashboard showing connection status and API key
2. Pending Changes page with approval options
3. Settings page for configuring plugin behavior
4. Change history with rollback options

== Changelog ==

= 1.3.2 =
* Feature: Programmatic SEO - Create and register custom post types from InstaRank
* Feature: Bidirectional custom post type sync between InstaRank and WordPress
* Feature: Update custom post types created in InstaRank directly from the dashboard
* API: New POST endpoint to register custom post types from InstaRank
* API: New PUT endpoint to update existing custom post types
* API: Sync all WordPress post types to InstaRank with preserved metadata
* Enhancement: Auto-register stored custom post types on WordPress init
* Enhancement: Persistent storage of InstaRank-created post types across WordPress restarts
* Security: Validation to prevent external post types from being modified via API
* UX: Seamless integration for programmatic SEO workflows

= 1.2.4 =
* Fix: Corrected API URL to point to main app (https://instarank.com) instead of API subdomain
* Fix: OAuth connection now works properly with correct endpoint URLs
* Enhancement: Added clear documentation about API URL configuration

= 1.2.3 =
* Fix: Corrected text domain from 'instarank-seo' to 'instarank' for WordPress.org compliance
* Security: Added proper sanitization and unslashing for POST data
* Security: Added phpcs:ignore with explanation for already-escaped output
* Compliance: Fixed all Plugin Check errors for WordPress.org submission

= 1.2.2 =
* Fix: State synchronization bug - WordPress now properly detects when integration is disconnected from InstaRank dashboard
* Enhancement: Added server-side verification endpoint to check integration status
* Enhancement: "Check Status" button now verifies with InstaRank backend and clears stale connection state
* Security: Improved connection validation and cleanup
* UX: Better error messages when connection is removed from dashboard

= 1.2.1 =
* Feature: OAuth-style popup connection flow (connect with one click!)
* Feature: "Connect with InstaRank" button for easy setup
* Feature: Automatic project selection during connection
* Feature: Modern, redesigned admin dashboard with enhanced UI/UX
* Enhancement: Improved button styles with hover animations
* Enhancement: Better status badges with modern design
* Enhancement: Enhanced notification system with auto-dismiss
* Security: OAuth token-based authentication with 15-minute expiration
* Security: HTTPS enforcement for WordPress sites
* UX: Popup window auto-closes after successful connection
* UX: Real-time connection status updates

= 1.1.0 =
* Feature: Added support for post content updates (low_word_count fixes)
* Feature: Added bulk approve/reject API endpoint for external integrations
* Enhancement: Improved change type handling for all SEO optimization types
* API: New /changes/bulk endpoint for batch operations
* Compatibility: Full support for content length optimization

= 1.0.1 =
* Security: Fixed all output escaping issues for enhanced security
* Security: Added proper input sanitization with wp_unslash()
* Security: Sanitized all $_SERVER variable access
* Code Quality: Replaced date() with gmdate() for timezone-safe operations
* Code Quality: Removed debug error_log() calls from production code
* Code Quality: Added comprehensive PHPCS ignore comments for custom database tables
* Compliance: Updated to pass all WordPress.org Plugin Check requirements with zero errors
* Compliance: Shortened plugin description to meet 150 character limit
* Fix: Added missing languages directory referenced in plugin headers

= 1.0.0 =
* Initial release
* WordPress site connection via API key
* SEO change review and approval system
* Automatic detection of popular SEO plugins
* Change rollback functionality
* Comprehensive change history and audit log
* Support for meta tags, Open Graph, and content optimization
* Settings for auto-approval and change type filtering

== Upgrade Notice ==

= 1.3.2 =
Major update! Programmatic SEO features - Create and sync custom post types between InstaRank and WordPress. Bidirectional sync support and seamless integration for programmatic content workflows. Highly recommended for all users.

= 1.2.2 =
Critical bug fix! Resolves state synchronization issue where WordPress showed "connected" even after disconnecting from InstaRank dashboard. Recommended for all users.

= 1.2.1 =
Major update! New one-click OAuth connection flow makes setup easier than ever. Modern UI redesign with enhanced UX. Highly recommended for all users.

= 1.1.0 =
New features: Post content optimization support and bulk operations API. Recommended update for all users.

= 1.0.0 =
Initial release of InstaRank plugin.

== Third Party Services ==

This plugin connects to the InstaRank service (https://instarank.com) to provide its functionality. By using this plugin, you agree to InstaRank's:

* Terms of Service: https://instarank.com/terms
* Privacy Policy: https://instarank.com/privacy

Data transmitted to InstaRank includes:

* Site URL and basic WordPress information
* Published posts and pages
* Current SEO meta data
* Plugin activation/deactivation events