=== Clarity SEO ===
Contributors: pluginjoy
Tags: seo, schema, meta tags, sitemap, robots.txt
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 2.2.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight free SEO plugin with metas, schema, sitemap, robots.txt, readability, keywords, redirects, and more advanced features.

== Description ==

Clarity SEO is a lightweight WordPress SEO plugin — delivering essential tools without bloat. Customize meta tags (title, description, keywords, Open Graph), add rich Schema.org markup, generate dynamic XML sitemaps, manage robots.txt, score readability, optimize with focus keywords, and handle redirects—all in under 100KB.

### It's featues Clarity SEO Plugin:
* **Per-Page Meta Tags**: Edit title, description, keywords, and OG images via Gutenberg sidebar. Auto-fills from content/excerpt.
* **Advanced Schema Support**: 20+ types (Article, Product, LocalBusiness, etc.) via input—dynamic for Org/WebPage/Service/FAQ/Video.
* **Readability Analysis**: Real-time Flesch-Kincaid scoring in the editor (60+ is good!).
* **Focus Keywords**: Add up to 5 keywords with density analysis for on-page optimization.
* **Dynamic Sitemap**: `/sitemap.xml` with images, priorities, changefreq, video/news—includes posts/pages/products.
* **Redirect Manager**: Advanced 301/404 handling with regex, monitoring, logging, export.
* **Robots.txt**: Virtual editor with sitemap reference.
* **SEO Audit**: 30+ point site-wide check under Tools > SEO Audit (HTTPS, permalinks, alt tags, etc.).
* **GSC Integration**: Fetch Search Console errors and index status in settings (manual API key).
* **Internal Linking Suggestions**: Auto-recommend links based on content (in metabox).
* **Global Settings**: One-page setup for site-wide defaults (logo, social links, contact info).
* **Image SEO**: Auto-generate alt/title/caption, bulk find/replace.
* **Local SEO**: Address/geo markup, LocalBusiness schema.
* **Keyword Tracking**: Position history, weekly email reports via GSC.
* **Breadcrumbs**: Shortcode with schema markup.
* **Setup Wizard**: Guided onboarding for quick configuration.
* **Import/Export**: From other seo plugins, settings CSV.
* **WooCommerce Integration**: Full metabox support for products; smart fallbacks for titles/descriptions.
* **Performance-First**: No database queries on frontend; Gutenberg-native; zero conflicts.

Perfect for small-medium sites (blogs, shops, portfolios) seeking premium features without the weight. Supports posts, pages, and WooCommerce products out-of-the-box.

### How to Use:
1. Install and activate.
2. Run the Setup Wizard (Settings > SEO Wizard) for initial config.
3. **Per-Post SEO**: Edit any post/page/product—use the "SEO Schema Settings" sidebar (auto-fills + readability/keywords tips).
4. **Global Setup**: Settings > SEO Optimizer for defaults and redirects.
5. **Audit**: Tools > SEO Audit for site checks.
6. **404 Monitor**: Tools > 404 Monitor for logs and export.
7. **Test**: View source for metas/schema; visit `/sitemap.xml` or `/robots.txt`.
8. **Advanced**: Hook into `seo_schema_add_metabox` for custom post types.

For pro features (AI suggestions, 20+ schemas, GSC dashboard), visit [PluginJoy](https://pluginjoy.com).

== External services ==

Clarity SEO optionally connects to Google services when the user explicitly enables and configures them:

1. Google Search Console API
   * Used for: Displaying top performing pages, average positions, and URL inspection status directly in the settings page and SEO Audit.
   * Data sent: The site URL (https://example.com or sc-domain:example.com), date range, dimensions (usually "page" or "query"), and the OAuth access token or API key entered by the user.
   * This only happens when the admin saves a valid token/key and loads the settings page.
   * Terms of Service: https://developers.google.com/terms
   * Privacy Policy: https://policies.google.com/privacy

2. Google Trends (embedded iframe)
   * Used for: Showing a small keyword interest graph inside the post editor sidebar.
   * Data sent: The focus keyword entered by the user (sent directly from the user’s browser to trends.google.com – no server-side request from WordPress).
   * Terms of Service: https://policies.google.com/terms
   * Privacy Policy: https://policies.google.com/privacy

== Installation ==

1. Upload the `clarity-seo` folder to `/wp-content/plugins/`.
2. Activate via Plugins menu.
3. Run the Setup Wizard under Settings > SEO Wizard.
4. Configure in **Settings > SEO Optimizer**.
5. Edit content—metabox appears automatically.

== Frequently Asked Questions ==

= Does it support WooCommerce? =
Yes! Metabox on products; metas/schema output on product pages; sitemap includes them.

= How accurate is readability scoring? =
Uses Flesch-Kincaid formula on content—aim for 60-70 for broad appeal. It's an approximation; refine manually.

= Can I add custom post types? =
Yes, filter `seo_schema_add_metabox` (e.g., add 'your_cpt' to the array).

= Conflicts with other SEO plugins? =
Runs at priority 1; disable their meta outputs to avoid duplicates.

= Why no Google Search Console integration? =
Free version focuses on core tools. Pro adds it.

== Screenshots ==

1. SEO Metabox with Readability & Keywords (Gutenberg)
2. Global Settings with Redirects
3. Schema Markup in Google Validator
4. Sitemap Output Example

== Changelog ==

= 2.2.3 =
* updated readme.txt.

= 2.2 =
* Expanded features: More schemas, advanced tools, integrations.

= 2.1 =
* Added SEO Audit dashboard (Tools > SEO Audit).
* Basic GSC integration (fetch errors in settings).
* Expanded schema to 16+ types via metabox dropdown.
* Internal linking suggestions in metabox.
* Bug fixes for blank editors.

= 2.0 =
* Added readability analysis (Flesch-Kincaid scoring).
* Introduced focus keywords with density tips.
* New redirect manager for 301/404 handling.
* WooCommerce support: Metabox on products + smart fallbacks.
* Bumped version for 2025 compatibility.

= 1.3 =
* Added global settings for organization details.
* Improved FAQ parsing for headings.
* Added text domain for translations.
* Enhanced sitemap with changefreq and images.

= 1.2 =
* Fixed JS dependencies for Gutenberg.
* Better fallback for OG images.

= 1.1 =
* Initial release with core features.

== Upgrade Notice ==

= 2.2.1 =
Major update: Audit, GSC, more schemas, linking suggestions. No data loss—backup recommended.