=== WTL - Missing Image ALT Checker ===
Contributors: wisetechlist
Tags: alt text, image alt, accessibility, media library, image seo
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.4.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find images with missing or empty ALT text and review Media Library, featured image, and post content usage from one dashboard.

== Description ==

WTL - Missing Image ALT Checker by WiseTechList helps you review image alternative text without an external service.

Features:

* View image ALT coverage in the Media Library.
* Find missing or empty ALT text, filter, search, and edit image ALT metadata.
* Bulk-save filled ALT descriptions on the current Media Library results page.
* Review stored image tags in posts and pages, including featured-image ALT metadata.
* Scan public post types in batches instead of one large request.
* Inspect each reported image usage with a thumbnail and link to the post editor.
* Update individual ALT attributes in classic post HTML with a confirmation step and content-change protection.
* Leave Gutenberg block markup unchanged and use Edit Post for block-content ALT changes.

Images that are purely decorative may correctly have empty alternative text (alt=""). The plugin identifies items for human review; it is not an accessibility compliance certificate and does not automatically fill every blank field.

Media ALT metadata and HTML ALT attributes stored inside post content are separate. Updating Media Library ALT does not necessarily update ALT attributes already stored in posts.

The full-content scan counts image *usages*, not unique files. The same image may appear in several posts and be counted more than once. Dynamic builder output, frontend-rendered theme images, and CSS background images are not included. Scan results are not saved after a page reload.

No account, AI service, paid API, or external tracking is required. Data is processed in the WordPress admin on your own website.

Developed by [WiseTechList](https://wisetechlist.com/).

== Installation ==

1. Upload the plugin ZIP via Plugins > Add New Plugin > Upload Plugin, or install it from the WordPress Plugin Directory once available.
2. Activate the plugin.
3. Open Media > ALT Checker in wp-admin.
4. Review missing Media Library ALT, or choose Scan All Content to audit post content and featured images.

== Frequently Asked Questions ==

= Will this automatically generate ALT text? =

No. You enter and review descriptions yourself. This helps avoid inaccurate text or unnecessary ALT on decorative images.

= Why are there more image usages than Media Library images? =

An image can be used in multiple articles or as a featured image. Each usage is counted separately.

= Does updating Media ALT update existing post HTML? =

Not always. Classic HTML occurrences can be edited from View Issues where supported. Gutenberg images should be edited in the post editor.

= Does it scan the rendered frontend? =

No. It inspects stored post HTML and featured image metadata, not CSS backgrounds or every image generated by themes or page builders.

= Does this plugin contact WiseTechList or send usage data? =

No. The author link is a normal link in plugin metadata and documentation; scans and ALT changes run on your own WordPress website.

== Screenshots ==

1. Dashboard overview with Media Library ALT statistics.
2. Scan All Content results for post and page image usages.
3. View Issues panel with image previews and review actions.
4. Media Library ALT editor and bulk save controls.

== Changelog ==

= 1.4.4 =
* Rebrand the plugin as WTL - Missing Image ALT Checker by WiseTechList.
* Align the plugin slug and text domain with the WTL product identity.
* No change to attachment ALT metadata or scanning logic.


= 1.4.1 =
* Correct inline script output using WordPress script tag API.
* Escape admin thumbnail markup and clarify read-only query parameters for Plugin Check.


= 1.4.0 =
* Set plugin author to WiseTechList with a clickable author website URL.
* Updated plugin directory metadata and documentation.
* Preserved tested v1.3 ALT editing and scanning features.

= 1.3.0 =
* Bulk-save ALT fields on the current Media Library page.
* Allow safe ALT edits in classic post HTML with concurrency checks.

= 1.2.0 =
* Clarified Media Library image counts and image usage counts.
* Added per-post View Issues and preview thumbnails.

= 1.1.0 =
* Added summary cards, featured-image checks, filters, and site-wide batched scans.

= 1.0.0 =
* Initial Media Library ALT audit and editing.

= 1.4.3 =
* Replace potentially slow missing-ALT meta queries with batched, cached WordPress attachment inventory.

= 1.4.2 =
* Replace direct database queries with WP_Query. Cache summary counts with invalidation after saving ALT.
* Update WordPress compatibility declaration for the 7.1 series; verify on a 7.1 installation before publishing.
