=== HSArticle Image SEO Audit ===
Contributors: hsarticle
Tags: image seo, alt text, image audit, seo, media
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Bulk-edit image alt text, title and description. Score every post on image SEO health. Works with Yoast, Rank Math, AIOSEO and SEOPress.

== Description ==

**HSArticle Image SEO Audit** gives you a complete picture of your site's image SEO health, then lets you fix everything from one clean dashboard — no opening posts one by one.

**Tab 1 — Alt Text Audit**

Scans your entire media library in batches so it never times out, even on large sites. Every image shows three editable fields inline — Title, Alt Text, and Description — saved together with one click. Results are categorised into:

* Missing — no alt text at all
* Weak — filename-based, single word, or over 125 characters
* Duplicate — same alt text used on multiple images
* Good — properly written

Also detects post-level alt text overrides — when an image's alt text inside a post differs from the media library value, something most plugins miss entirely.

**Tab 2 — Per-Post SEO Score**

Scores every published post and page (not a sample — all of them, fetched in batches) on:

* Featured image presence
* All images have alt text
* No weak or filename-based alt texts
* No duplicate alt texts on the same page
* At least one image has a caption
* Focus keyword set and present in alt text (requires SEO plugin)
* Meta title and meta description set (requires SEO plugin)

Automatically detects your active SEO plugin (Yoast SEO, Rank Math, All in One SEO, or SEOPress). If none is installed, it shows install recommendations and still runs all the basic image checks. If a plugin is active but a post has no focus keyword, that's flagged individually rather than silently failing the whole score.

Each post card shows word count, image count, publish date, and post type at a glance, with direct Edit and View links.

== Installation ==

1. Upload the `hsarticle-image-seo-audit` folder to `/wp-content/plugins/`
2. Activate through **Plugins → Installed Plugins**
3. Go to **Image SEO** in your admin sidebar

== Frequently Asked Questions ==

= Does it work without an SEO plugin? =
Yes. The Alt Text Audit tab works fully without any SEO plugin. The Per-Post Score tab runs all basic image checks regardless, and unlocks keyword/meta checks once a supported SEO plugin is active.

= Which SEO plugins are supported? =
Yoast SEO, Rank Math, All in One SEO (AIOSEO), and SEOPress.

= Will it slow down my site? =
No. All scans run only when you click a button inside the admin, in small batches. Zero impact on your frontend.

= Does it edit images automatically? =
No. You type the values and click Save. You stay in full control.

= Does it score all my posts or just a sample? =
All published posts and pages, fetched in batches to avoid timeouts on large sites.

== Screenshots ==

1. Alt Text Audit — image grid with inline Title, Alt Text, and Description editing
2. Per-Post Score — score ring, stat cards, and detailed per-post breakdown
3. No SEO plugin detected — install recommendations with direct links

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release.
