# WordPress Plugin

Connect your WordPress site to InstaRank for AI-powered SEO optimization, programmatic page generation, and comprehensive site analysis.

## Requirements

- **PHP**: 7.4+
- **WordPress**: 5.6+
- **HTTPS**: Required

## Installation

1. ### Download & Install  
   Download the plugin from your InstaRank dashboard or upload the ZIP file directly to WordPress.
   
   WordPress Admin → Plugins → Add New → Upload Plugin → Choose ZIP → Install Now

2. ### Activate the Plugin  
   After installation, click "Activate" to enable the plugin. You'll see a new "InstaRank" menu item in your WordPress admin sidebar.

3. ### Connect to InstaRank  
   Navigate to InstaRank → Dashboard and click "Connect to InstaRank". You'll be redirected to authenticate with your InstaRank account.
   
   The OAuth connection generates a secure API key that's stored encrypted in your WordPress database.

4. ### Configure Settings  
   Visit InstaRank → Settings to configure which change types to allow, webhook notifications, and other preferences.

## Core Features

### SEO Management

- **AI-powered SEO recommendations** from InstaRank and apply them to your WordPress site with a single click.
- **Change Approval Workflow**: Review, approve, or reject SEO changes before they're applied.
- **90-Day Rollback**: Undo any change with full before/after comparison.
- **Meta Tag Optimization**: Title tags, meta descriptions, Open Graph, Twitter Cards.
- **Schema Markup**: Auto-generated structured data for better SERP visibility.

### Programmatic SEO

**Note:** Starting with v2.0, the Programmatic SEO interface has moved to [app.instarank.com](https://app.instarank.com/) for a better experience. The WordPress plugin handles backend operations.

- Generate thousands of SEO-optimized pages from datasets. The plugin receives pages from the SaaS platform and creates WordPress posts automatically.
- **Multiple Data Sources**: CSV, Google Sheets, Airtable, Notion, RSS feeds.
- **Page Builder Support**: Works with templates from any page builder.
- **AI Auto-Mapping**: Automatically map dataset columns to template fields.
- **Batch Operations**: Bulk publish, update, or delete generated pages.

### Site Analysis

- **Comprehensive crawling and analysis** of your WordPress site to identify SEO issues and opportunities.
- **50+ SEO Checks**: Technical, on-page, and content analysis.
- **Issue Detection**: Broken links, missing tags, duplicate content.

## Supported Integrations

### SEO Plugins

- Yoast SEO
- Rank Math
- All in One SEO (AIOSEO)
- SEOPress
- The SEO Framework

### Page Builders

- Kadence Blocks
- Elementor
- Gutenberg (Block Editor)
- Bricks Builder
- Divi, Oxygen, Beaver Builder

### E-commerce & Fields

- WooCommerce
- Advanced Custom Fields (ACF)

### Indexing & More

- IndexNow (instant indexing)
- WPML (multi-language)

## Spintax Engine

Create content variations with our advanced spintax processor. Supports nested syntax, weighted options, and anchors for consistency.

- **Basic Syntax**: `{option1|option2|option3}`
- **Nested Spintax**: `{big {house|home}|small apartment}`
- **Weighted Options**: `{common=70|rare=30}` (70% chance of "common", 30% chance of "rare")
- **Anchors (Consistency)**: `{anchor:city}{London|Manchester}` (Same anchor name always picks the same option)
- **Variables**: `{{field_name}}` (Replace with dataset column values)

## Admin Dashboard

The plugin adds a minimal, responsive dashboard to your WordPress admin with three tabs:

### Dashboard

- Connection status, site stats, pending changes preview

### Pending Changes

- Review and approve/reject SEO recommendations

### Settings

- API config, allowed change types, webhooks

### Supercharge WordPress with AI Agent

Take your WordPress SEO to the next level. Use natural language commands to manage content, optimize pages, and automate SEO tasks.

- Natural language control
- 40+ powerful tools
- Multi-step execution

## FAQ

### What happens to my pages if I deactivate the plugin?

All generated pages remain in WordPress as regular posts. SEO metadata stays intact. You can reactivate the plugin anytime to restore the connection.

### Is the plugin free?

Yes, the WordPress plugin is free. You'll need an InstaRank account (free tier available) to use it.

### Does it work with my SEO plugin?

Yes! InstaRank automatically detects and works with Yoast, Rank Math, AIOSEO, SEOPress, and The SEO Framework.

## Ready to Get Started?

Download the plugin and connect your WordPress site to InstaRank.