=== JitSEO Suite - Complete SEO toolkit with real-time scoring and keyword suggestions ===
Contributors: prosanjit
Tags: seo, schema, xml sitemap, content analysis, keyword research
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.1.1
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Complete SEO optimization with Google keyword research, content analysis, and real-time SEO scoring for WordPress.

== Description ==

**JitSEO Suite** is your complete SEO companion for WordPress. Get everything you need to rank higher in search results — from real-time keyword research with Google autocomplete to comprehensive content analysis, readability scoring, schema markup, and XML sitemaps.

Whether you're a blogger, content marketer, or SEO professional, JitSEO Suite makes it simple to optimize every post and page for maximum search visibility.

= Core Features =

**Google Autocomplete Keyword Research**
Real-time keyword suggestions powered by Google's autocomplete API. Simply start typing a focus keyphrase and discover what people are actually searching for — all without leaving WordPress.

**Related Keywords & Semantic Analysis**
Automatically discover semantically related keywords powered by the Datamuse API. Target multiple variations of your keyphrase with contextually relevant terms. Manually add keywords to track coverage and ensure comprehensive semantic optimization.

**Comprehensive SEO Analysis**
Get detailed feedback on over 16 SEO factors including:
* Keyphrase placement and density
* Content length and quality
* Title and meta description optimization
* Internal and external links
* Image alt text coverage
* Single H1 validation
* URL slug optimization

**Advanced Readability Analysis**
Ensure your content is easy to understand with checks for:
* Sentence and paragraph length
* Word complexity
* Transition words usage
* Passive voice detection
* Flesch Reading Ease score
* Subheading distribution

**Google Snippet Preview**
See exactly how your page will appear in search results with live desktop and mobile previews. Optimize your titles and descriptions in real-time.

**SEO Meta Box**
Professional SEO controls right in your post editor:
* Works with Gutenberg and Classic Editor
* Dynamic SEO title with variables (%%title%%, %%sitename%%, %%sep%%)
* Meta description with live character counter
* Focus keyphrase with Google suggestions
* URL slug editor to customize your permalink
* Traffic light indicators (Red/Orange/Green)

**Social Media Optimization**
Control how your content appears on social platforms:
* Open Graph tags for Facebook and LinkedIn
* Twitter Card support
* Custom social titles and descriptions
* Automatic image detection

**XML Sitemap Generation**
Automatic sitemap creation for all post types, categories, tags, and custom taxonomies. Your sitemap is instantly available at `/sitemap_index.xml` for quick indexing by search engines. Per-post-type include/exclude controls available in settings.

**Breadcrumb Navigation**
Add semantic breadcrumb navigation to your theme with just a shortcode or template function. Includes Schema.org markup for better search engine understanding.

**Schema.org Structured Data**
Automatic JSON-LD schema markup including Article, WebPage, and Organization schemas. Supports 11 schema types to enhance your search presence.

**Advanced SEO Controls**
Full control over:
* Custom canonical URLs
* Meta robots directives (noindex, nofollow) — per post and site-wide for archives, author pages, search results, and paginated pages
* Per post-type title and meta description templates
* og:type detection (website / article / product)

**Settings Import / Export**
Back up and migrate all your SEO settings to another site with one click. Export as JSON, import anywhere.

= Perfect For =

* Content creators and bloggers optimizing for SEO
* Small business owners improving online visibility
* Content marketing teams managing multiple posts
* SEO professionals auditing client sites
* WordPress sites aiming for higher search rankings

== External Services ==

This plugin connects to Google's Autocomplete service to provide real-time keyword suggestions.

= What is the service? =

Google Autocomplete API provides keyword suggestions based on what people are searching for on Google.

= What data is sent? =

Only the text you type in the "Focus Keyphrase" field in the post editor is sent to Google. No personal data, site content, or user information is transmitted.

= When is data sent? =

Data is sent only when you request keyword suggestions by typing in the Focus Keyphrase field (minimum 3 characters).

= Service Terms and Privacy =

This service is provided by Google LLC:
- Terms of Service: https://policies.google.com/terms
- Privacy Policy: https://policies.google.com/privacy

= Datamuse API =

Datamuse provides related keyword (LSI) suggestions based on semantic similarity.

= What is the service? =

Datamuse is a free word-finding API used to surface semantically related terms for a given focus keyphrase.

= What data is sent? =

Only the text in the "Focus Keyphrase" field is sent to Datamuse. No personal data, site content, or user information is transmitted.

= When is data sent? =

Data is sent only when you type a focus keyphrase of 3 or more characters in the post editor.

= Service Terms and Privacy =

This service is provided by Datamuse:
- API documentation and terms: https://www.datamuse.com/api/

== Getting Started ==

= Installation =

1. Log into your WordPress admin dashboard
2. Go to **Plugins > Add New**
3. Search for "JitSEO Suite"
4. Click **Install Now**, then **Activate**

= Quick Start =

1. After activation, visit any post or page to edit
2. Look for the **JitSEO Suite** meta box below the editor or the **JitSEO Suite** panel in the Gutenberg sidebar
3. Enter a focus keyphrase (minimum 3 characters) to see Google suggestions
4. Fill in your SEO title and meta description
5. Review your SEO and readability scores
6. Click **Analyze Content** for detailed recommendations

= Configure Settings =

Go to **SEO > Settings** to set up:
* Site name and separator character
* Homepage meta description
* Default robots settings
* Per-post-type title and meta description templates
* Sitemap include/exclude per post type
* Archive noindex settings
* Breadcrumb customization

== Frequently Asked Questions ==

= How does the Google keyword suggestion work? =

Type at least 3 characters in the Focus Keyphrase field and you'll instantly see suggestions from Google's autocomplete API. These are actual search terms people use, helping you target the right keywords.

= Will JitSEO Suite work with my theme? =

Yes! JitSEO Suite is fully compatible with any WordPress theme. It works with both the modern Gutenberg editor and the Classic Editor.

= Can I use this with other SEO plugins? =

We recommend using only one SEO plugin to avoid conflicts. If you're switching from another plugin, simply deactivate the old one before activating JitSEO Suite.

= Where is my XML sitemap? =

Your sitemap is automatically available at: `https://yoursite.com/sitemap_index.xml`

= How do I display breadcrumbs? =

Use the shortcode in posts/pages:
`[jit_seo_suite_breadcrumbs]`

The shortcode alias `[jitseo_breadcrumbs]` is also supported for compatibility.

Or in your theme template:
`<?php if (function_exists('jit_seo_suite_breadcrumbs')) jit_seo_suite_breadcrumbs(); ?>`

= Does this slow down my site? =

No. JitSEO Suite is optimized for performance. Plugin code only loads in the admin editor, keeping your frontend lightning fast.

= What SEO title variables can I use? =

In your SEO Title fields, use:
* `%%title%%` — Your post/page title
* `%%sitename%%` — Your website name
* `%%sep%%` — Separator character (configured in settings)
* `%%category%%` — Primary post category
* `%%author%%` — Post author display name
* `%%date%%` — Post publish date

= How is the SEO score calculated? =

Your SEO score is based on multiple quality factors:
* Focus keyphrase in title, description, and content
* Proper keyword density (1–2.5% optimal)
* Content length (300+ words recommended)
* Title length (30–60 characters ideal)
* Meta description (120–160 characters ideal)
* Content structure and headers
* Links and accessibility

**Score breakdown:**
* **80–100%** (Green): Excellent SEO optimization
* **50–79%** (Orange): Good, but room for improvement
* **Below 50%** (Red): Needs optimization

= What is the Flesch Reading Ease score? =

This measures how easy your content is to read on a scale of 0–100:
* **90–100**: Very easy (5th grade reading level)
* **60–89**: Easy (6th–8th grade level)
* **30–59**: Fairly difficult (10th–12th grade level)
* **0–29**: Very difficult (College level)

Aim for 60+ for most audiences.

= What about privacy and data collection? =

JitSEO Suite respects your privacy. We don't collect any personal data. The keyword suggestions feature sends your typed keywords to Google's API — that's all. Your site data never leaves your server.

= How do I import/export settings? =

Go to **SEO > Settings** and scroll to the Import/Export section. You can download your current settings as a JSON file and re-import them on any site running JitSEO Suite.

== Screenshots ==

1. JitSEO Suite Dashboard
2. JitSEO Suite SEO Panel
3. Google Keyword Suggestions
4. SEO Analysis
5. Readability Analysis
6. Open Graph or Social Cards
7. Schema Settings
8. Advanced Setting Panel
9. JitSEO Suite Sidebar

== System Requirements ==

* WordPress 5.0 or higher
* PHP 7.2 or higher
* MySQL 5.6 or higher

== Changelog ==

= 1.1.1 – UI Polish =

* Added JitSEO wordmark logo to the meta box title bar
* Added icons to Schema, Social, and Advanced tab buttons
* Redesigned settings page — left sidebar navigation with logo, section links, and scrollable card layout
* Redesigned Related Keywords widget — manual input always visible, coverage dots on targeted keywords
* Replaced SEO and Readability scrollable checklists with filter tabs (All / Issues / Warnings / Good)
* Robots.txt field is now editable — changes are saved and served via WordPress virtual robots.txt
* Fixed: info status dot color corrected from blue to amber — consistent red/amber/green palette across all checklists and Gutenberg sidebar
* Fixed: removed animations from SEO and Readability tab face indicators
* Fixed: Gutenberg sidebar face indicators now match meta box style

= 1.1.0 – Phase 1 Complete =

* Added taxonomy sitemaps — categories, tags, and custom taxonomies now included in the sitemap index
* Added per-post-type sitemap include/exclude toggles in settings
* Added archive noindex controls — globally noindex date archives, author pages, search results, and paginated pages
* Added per-post-type title and meta description templates with variables: {title}, {sitename}, {sep}, {category}, {author}, {date}
* Added dedicated OG image upload field per post (media library picker) with featured image fallback
* Added robots.txt viewer under Settings
* Added settings import/export (JSON)
* Added .pot translation template
* Updated plugin name to JitSEO Suite (consistent capitalisation throughout)
* Added custom SVG logo icon in WordPress admin sidebar
* Fixed: og:type now correctly outputs "website" on homepage, "article" on posts, "product" on WooCommerce products

= 1.0.0 =

**Initial Release**

* Real-time Google autocomplete keyword research
* Related keywords and semantic analysis via Datamuse API
* 16+ SEO quality checks and scoring
* Advanced readability analysis with Flesch score
* Google snippet preview (desktop & mobile)
* XML sitemap generation
* Schema.org structured data (JSON-LD)
* Breadcrumb navigation with markup
* Social media optimization (Open Graph, Twitter Cards)
* Gutenberg and Classic Editor support
* Per-page SEO controls (canonical, robots)
* Clean, modern admin interface
* Production-ready security hardening
* Optimized for performance

== Upgrade Notice ==

= 1.1.1 =
UI polish release: meta box logo, tab icons, redesigned settings page, editable robots.txt, filter tabs for checklists, and bug fixes. Safe to upgrade — no data migration required.

= 1.1.0 =
Major update: adds taxonomy sitemaps, per-post-type title templates, archive noindex controls, OG image upload, and settings import/export. Safe to upgrade — no data migration required.

= 1.0.0 =
Initial release.

== Support & Contributing ==

Have questions or feedback? We'd love to hear from you:

* **Bug Reports**: Report issues on our GitHub repository
* **Feature Requests**: Let us know what you'd like to see
* **General Support**: Visit our support documentation

== Credits ==

Developed with care for the WordPress community.

* Google Autocomplete API for real-time keyword suggestions
* Datamuse API for related keyword suggestions

== License ==

JitSEO Suite is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or any later version.

JitSEO Suite is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with JitSEO Suite. If not, see https://www.gnu.org/licenses/gpl-2.0.html
