=== Filikod – ALT Text Audit & Bulk Management === Contributors: lyode Plugin URI: https://filikod.com/ Tags: alt text, accessibility, seo, alt audit, media library Requires at least: 5.8 Tested up to: 7.0 Requires PHP: 7.4 Stable tag: 1.1.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Audit your media library, get an ALT Quality Score (0–100%), and fix missing, generic or duplicated ALT text in bulk. No external API required. == Description == Most WordPress sites have broken ALT text, and most site owners have no way to measure it. Missing, generic, duplicated or too-short ALT text quietly hurts your accessibility score and your image SEO. The problem stays invisible until it is too late. **Filikod scans your entire media library, gives you an ALT Quality Score from 0 to 100%, and gives you the tools to fix everything in bulk, directly inside WordPress.** No external API. No credits to buy. No complex setup. You write the ALT text. You stay in control. https://www.youtube.com/watch?v=C-yLjXhtwMs [Full documentation and guides on filikod.com](https://filikod.com/) --- = Who is Filikod for? = Filikod is built for: * **SEO professionals** who want ALT text treated as a measurable ranking signal, not an afterthought * **Accessibility-focused teams** who need a structured audit to meet WCAG guidelines * **Content managers** with large media libraries who need to fix issues fast, in bulk * **Agencies** managing multiple WordPress sites who need a repeatable quality process * **Anyone who wants full control** over their ALT text quality at scale, without external services or paid credits --- = ALT Text Audit and Quality Score = Filikod scans your entire media library and instantly flags: * **Missing ALT**: images with no ALT attribute at all * **Generic ALT**: meaningless values like "image", "photo", "logo", "thumbnail", "untitled" * **Too Short ALT**: descriptions too brief to be useful for accessibility or SEO * **Duplicated ALT**: the same ALT text reused across multiple images You get a clear **ALT Quality Score from 0 to 100%** plus a breakdown by issue type, so you always know exactly what to fix first. This turns ALT text from a vague, invisible problem into a measurable system you can actually improve, like a health score for your media library. --- = Bulk ALT Management = Editing ALT text one image at a time is the reason most people never finish. Filikod lets you: * Filter images by issue type (missing, generic, short, duplicated) * Edit ALT text inline, directly from the audit view * Save instantly without leaving the page * Fix dozens or hundreds of images in minutes Built for real media libraries with thousands of images, not tidy demos with five. --- = Context-Based Editing = Good ALT text requires context. What is this image actually about on this page? Filikod shows you **where each image is used** (which post or page) so you can jump directly to the content and write accurate, relevant ALT text. No guesswork. --- = Native Media Library (Media > Library) = See ALT health **where you already work**: Filikod adds **ALT Status** badges directly in **Media > Library**, in both list and grid views. * **List view**: a dedicated **ALT Status** column with one badge per issue, or a green **Alt: OK** when everything is fine * **Grid view**: badges as an overlay on each thumbnail so you can scan your entire library at a glance * **Attachment details**: an **ALT Status** field that updates live as you type, so you see the result before saving Multiple badges can appear on the same image when several issues apply. The cache refreshes automatically whenever ALT text is changed anywhere in WordPress. --- = Optional Automation = For teams who need to process large volumes, Filikod includes optional automation tools, all disabled by default: * Generate ALT from filename (only for images that have no ALT yet) * Remove special characters from ALT text (slashes, dashes, underscores) * Remove title attribute from images (reduces redundancy, improves accessibility) * Bulk process your entire existing media library in one click Execution order is always enforced: generate ALT from filename, clean special characters, then remove title. Predictable. Consistent. Always yours to control. --- = How Filikod Compares = Most ALT text plugins do one thing: auto-generate ALT on upload, often using a paid credit system. Filikod is an ALT audit and bulk management system. It works on your existing library, gives you a measurable quality score, and lets you fix issues at scale with full editorial control. What only Filikod does: * ALT Quality Score (0 to 100%) across your entire library * **ALT Status badges in the native Media Library** (list column, grid overlay, attachment details) with live updates after save * Detects generic ALT values like "photo", "image", "logo" * Detects duplicated ALT text reused across multiple images * Detects ALT text that is too short to be useful * Bulk filtering by issue type (missing, generic, short, duplicated) * Works on images already in your media library * No external API, no credits, no subscription required * Full editorial control: you write and validate every ALT text If you want full visibility and control over your ALT text quality at scale, Filikod is exactly that. --- = Compatibility = * Works with any theme * Compatible with Elementor, Divi, Gutenberg, WPBakery and most major page builders * Single site and multisite supported * No external services required, runs entirely inside WordPress [Learn more at filikod.com](https://filikod.com/) --- == Installation == 1. Install from **Plugins > Add New** (search "Filikod") or upload the plugin zip manually 2. Activate Filikod 3. Go to **Filikod > Dashboard** to see your ALT Quality Score 4. Go to **Filikod > ALT Audit** to find and fix issues by type 5. Open **Media > Library** to see **ALT Status** in list or grid view, and in each image's attachment details 6. Configure optional automation in **Filikod > Settings** --- == Frequently Asked Questions == = Does Filikod generate ALT text automatically? = Yes, but it is optional and filename-based. Filikod generates ALT from the image filename only for images that have no ALT text yet. Its core strength is structured ALT audit and bulk management, so you always stay in control of your content. = Does Filikod use AI to write ALT text? = Not currently. ALT generation is based on the image filename. The core philosophy of Filikod is editorial control: you decide what each image means in context. Filikod gives you the visibility and tools to write accurate ALT yourself, or to review and validate what automation produces. = How is Filikod different from Image Attributes Pro or BIALTY? = Image Attributes Pro and similar filename-based plugins set ALT text automatically from the filename. They do not audit your existing library, detect generic or duplicated ALT, or give you a quality score. Filikod gives you a structured audit across your entire media library and the tools to fix issues in bulk, including images uploaded before you installed the plugin. = Does it work on images already in my media library? = Yes. Filikod scans and processes your entire existing media library, including images uploaded before installation. You can run a bulk process from the Settings page at any time. = Does Filikod modify my image files? = **No.** Filikod only changes the `_wp_attachment_image_alt` meta in WordPress. It never touches your binary image files. = What is the ALT Quality Score? = It is a score from 0 to 100% that reflects the overall ALT text health of your media library. It takes into account the proportion of images with missing, generic, too-short, and duplicated ALT attributes. It gives you a single measurable number you can track and improve over time, like an SEO or accessibility health metric. = Can I bulk edit ALT text? = Yes. The ALT Audit page lets you filter images by issue type (missing, generic, short, duplicated) and edit ALT text inline. Changes save instantly without reloading the page. = Is it compatible with Elementor, Divi, WPBakery, and Gutenberg? = Yes. Filikod manages ALT attributes directly in the WordPress media library, independently from your theme or page builder. Compatibility is universal. = Does it work on multisite installations? = Yes. Filikod supports WordPress multisite. = Is Filikod an image optimizer like Smush or Imagify? = No. Filikod does not compress images, convert to WebP, or serve images via CDN. It focuses entirely on ALT text quality: the audit, the score, and the tools to fix issues at scale. You can use a dedicated image optimizer alongside Filikod without any conflict. = Where can I find documentation? = Full documentation is available at [filikod.com](https://filikod.com/). --- == Screenshots == 1. **Dashboard**: ALT Quality Score (0–100%) with donut gauge and legend, issue counts (missing, generic, too short, **too long**, duplicated, **decorative**), optional **Media Size Savings** impact, and **Library Overview** (total images, total size, average size). Optional automation toggles summarized on the side. 2. **ALT Audit**: Filter tabs for Missing, Generic, Too short, **Too long**, Duplicated, and **Decorative**; table with thumbnail, filename, **Context** (where the image is used), editable **ALT** field, issue label, a dedicated **Decorative** column with a toggle switch (auto-saved), and a per-row **Save** action. Duplicated ALT grouped for fast fixes. 3. **Settings: Accessibility / SEO**: Toggles for automatic ALT from filename, optional title-attribute removal, and special-character cleanup; **Process Existing Images** for bulk apply; **Save Changes**. 4. **Attachment details**: Native media modal/sidebar with **Alternative Text** and Filikod **ALT Status** (e.g. green **Alt: OK** when rules pass), so you see health next to the field while you edit. 5. **Media Library (grid)**: Thumbnails with **ALT Status** badges (e.g. **Alt: OK** on qualifying images) for a quick scan of library-wide ALT health. --- == Changelog == = 1.1.1 = • **AI-generated image detection (Generic ALT)**: ALT text inherited from default AI export filenames is now flagged as **Generic** in the audit. Two new universal patterns cover the most common cases: - `Gemini_Generated_Image_*` → e.g. *"Gemini Generated Image i90nz7i90nz7"* - `ChatGPT Image *` → e.g. *"ChatGPT Image Jul 7, 2024 at 02_30_00 PM"* These ALT values look meaningful but carry zero accessibility or SEO value, so Filikod now surfaces them in the **Generic** tab of the ALT Audit and in the **Alt: Generic** badge across the Media Library (list, grid, attachment details). Detection is applied to the normalized ALT, so casing, underscores, dashes and dates do not bypass the rule. • **Audit cache**: transient bumped to `filikod_alt_audit_v4` so the new detection rule applies immediately on first load after update; previous `v3` (and earlier) transients are explicitly cleared by `invalidate_cache()`. • **Performance – Dashboard media stats**: the Dashboard counters (total images, total size, optimized count, original/optimized size) are now computed in a single batched loop and cached for 15 minutes (`filikod_media_size_stats_v1`). The cache is auto-invalidated on attachment add/delete and after each automatic resize, removing repeated heavy queries on every Dashboard page load. • **Security – ALT save endpoint**: the AJAX endpoint `filikod_save_alt` now checks `current_user_can( 'edit_post', $attachment_id )` per attachment, verifies that the target is an actual image (`wp_attachment_is_image()`), and truncates ALT text longer than 1000 characters before saving. • **Accessibility – SVG sanitizer**: the strict SVG whitelist now allows ``, `<desc>` and accessibility attributes (`role`, `aria-label`, `aria-labelledby`, `aria-describedby`, `aria-hidden`, `tabindex`, `preserveAspectRatio`). These elements are non-executable and required for WCAG-compliant inline SVG; the security posture against scripts, event handlers and external references is unchanged. • **Settings UX**: the *Maximum image width* setting now displays an explicit admin error notice when a value outside the supported range (100–10000 px) is submitted, instead of silently rejecting the input. • **Multisite hygiene**: the uninstall routine now also deletes per-site Filikod transients (`_transient_filikod_*` and their timeouts) on every sub-site of a multisite network, preventing orphaned cache entries after plugin removal. • **Production log hygiene**: non-critical `error_log()` calls in the SVG sanitization and image resizer paths are now gated behind `WP_DEBUG`, avoiding noise in production `debug.log` files. • **Code cleanup**: removed two dead-code paths (no-op rewrite-rule flush on `init`; SVG security headers hook that never fired because static SVG files bypass `template_redirect`). No user-visible behavior change. = 1.1.0 = • **Detailed badge tooltips**: every ALT badge (list view, grid overlay, modal, ALT Audit Issue column) now exposes a contextual `title` tooltip explaining the status and the recommended action (e.g. *“ALT text exceeds 125 characters. Long ALTs are poorly read by screen readers and dilute SEO signals…”*). Tooltips are translatable and parameterized with the actual character thresholds. A dotted underline (`cursor: help`) signals the tooltip on the Issue label • **New issue: Too long ALT**: detection of ALT text exceeding **125 characters** (after normalization). Dedicated tab on the ALT Audit page, dedicated count on the Dashboard, dedicated **Alt: Too long** badge in the Media Library (list, grid, modal). Score impact: **70/100** (reported but less critical than duplicate, generic, too short, or missing) • **Decorative action**: mark an image as **decorative** (intentional `alt=""` per WCAG). Decorative images are **fully excluded from the ALT score** (neither numerator nor denominator) so logos, dividers and purely visual icons stop dragging your score down. Dedicated **Decorative** column on the ALT Audit page with a **toggle switch** that auto-saves on change; dedicated **Decorative** tab to review and revert; dedicated **Alt: Decorative** badge in the Media Library • **ALT Audit UI**: decorative action moved out of the Action column into its own column with a toggle switch (auto-save on change, keyboard-accessible). The Action column now only holds the **Save** button for a cleaner row layout • **Badge colors refresh**: new palette for the Media Library ALT Status badges. **Alt: Generic** in amber (`#FFC736`) and **Alt: Too short** in teal (`#0DBB9C`) for clearer visual differentiation • **Dashboard**: two new counters, **Too long** and **Decorative**, both linking to the matching ALT Audit tab • **Audit cache**: transient bumped to `filikod_alt_audit_v3` (auto-rebuilt on first load); invalidation hooks now also listen to the new `_filikod_decorative` post meta • **i18n**: new translatable strings (`Too long`, `Decorative`, `Marked as decorative.`, `Image restored as a regular image, please add an ALT text.`, "too long" description with parameterized character threshold) • **Public API**: new helpers `Filikod_Alt_Audit::is_decorative()`, `Filikod_Alt_Audit::set_decorative()`, new constants `TOO_LONG_MIN_LEN`, `META_DECORATIVE`, `AUDIT_TRANSIENT` • **Backwards compatibility**: existing audit results still load; `collect_alt_issue_codes()` gains an optional fourth parameter `$is_decorative` defaulting to false = 1.0.9 = • **ALT Status labels**: badges in the native Media Library (list, grid, attachment details) now use an **Alt:** prefix on every status (e.g. **Alt: OK**, **Alt: Duplicated**, **Alt: Missing**) via a translatable `Alt: %s` string • **OK badge**: removed the checkmark character; the passing state reads **Alt: OK** • **Attachment details modal**: new stylesheet `media-modal-alt-status.css` enqueued **after** `media-views` (`wp_enqueue_media`) so the **ALT Status** label stays aligned with other field labels and with the badges, including under the **900px** responsive rules • **Readme**: description, screenshots captions, and changelog aligned with the above = 1.0.8 = • **Native Media Library**: **ALT Status** column in list view; badge overlay on grid thumbnails (top-left); **ALT Status** field in attachment details modal/sidebar • **Modal UX**: ALT Status label aligned with badges; multiple issue badges on **one horizontal row** in attachment details (list column still stacks badges for readability) • **Live updates**: status refreshes after saving ALT text (AJAX save handlers) and while typing (server-side preview); dashboard and audit cache stay in sync when `_wp_attachment_image_alt` changes • **Multi-issue badges**: an image can show several tags at once (e.g. Generic + Too short + Duplicated) when multiple rules apply; single green **Alt: OK** when there are no issues • **Reliability**: audit transient cache key bumped (`filikod_alt_audit_v2`); normalized cache keys for object caches; `attachment_fields_to_save` ensures `image_alt` is persisted on `save-attachment-compat` like the classic uploader; invalidation hooks on post meta, attachment save, and related paths • **Performance**: cached global map of normalized ALT → occurrence count (`filikod_alt_norm_counts_v1`); duplicate preview in the media modal avoids scanning every attachment per request; full audit rebuild reuses that index • **Admin JS**: shared batch runner for accessibility and bulk jobs (`runFilikodBatchedJob`) • **Documentation**: FAQ and feature list updated; default behavior is ALT meta only, no image file changes = 1.0.7 = • Accessibility: "Remove Title Attribute" now works for new uploads (clears post_title after use); execution order enforced: generate ALT (from title then filename) → clean special chars → remove title (same order in bulk process) • ALT Audit page: Duplicated tab lists media sorted alphabetically by ALT so duplicates are grouped; saving an ALT in Duplicated tab reloads the list so media that are no longer duplicated disappear • Security & coding standards: escaped outputs (menu icon via wp_localize_script; pagination printf), all variables in ALT audit view prefixed with filikod_ (PrefixAllGlobals) = 1.0.6 = • Readme and positioning update: ALT audit & bulk management first • Clarified automation messaging (optional, controlled) • Improved "Generic ALT" detection with additional real-world patterns (e.g. device/app filenames, placeholders, thumbnails) • Reduced false positives in generic ALT classification (better normalization and matching) = 1.0.5 = • Added content context column in ALT audit (see where each image is used) • Improved bulk ALT editing workflow • Enhanced admin interface clarity = 1.0.4 = • Fix audit score calculation • Adjusted description text = 1.0.3 = • Dashboard redesign with ALT Quality Score (0–100%) • Multi-language generic ALT detection • Donut gauge visualization for ALT Score • Media Size Savings module and progress bars • New audit utilities and filters = 1.0.2 = • Improved dashboard readability • Added ALT coverage percentage • Clarified resize behavior messaging = 1.0.0 = • Initial public release • ALT automation (filename-based) • Title removal & character cleanup • Bulk processing for existing images • Secure SVG sanitization • Optional extended file types • Modern tab-based dashboard --- == Upgrade Notice == = 1.1.1 = Recommended update: ALT inherited from AI export filenames (`Gemini_Generated_Image_*`, `ChatGPT Image *`) is now detected as **Generic** in the audit and in the Media Library badges. Includes Dashboard stats caching, hardening of the ALT save endpoint, WCAG-friendly SVG sanitizer (title/desc/aria), better per-site multisite uninstall, and an explicit error notice for out-of-range *Maximum image width*. Audit cache auto-rebuilds on first load (`filikod_alt_audit_v4`). = 1.1.0 = Adds Too long ALT detection (>125 chars) with its own tab, badge and Dashboard counter; new Decorative toggle (dedicated column, auto-saved) to flag intentional alt="" images and exclude them from the score; refreshed badge colors; audit cache v3 (auto-rebuilt). = 1.0.9 = Recommended update: **Alt:** prefix on all Media Library ALT Status badges; **Alt: OK** without checkmark; modal label alignment fix (stylesheet loaded after `media-views`); readme aligned. = 1.0.8 = Recommended update: ALT Status in the Media Library (list, grid, modal) with live refresh; modal layout polish; faster duplicate detection while typing; internal JS refactor for bulk jobs. = 1.0.7 = Extended generic ALT detection, logo+domain exception, "Remove Title" fix for new uploads, Duplicated tab sorted by ALT with list refresh on save, removed Clear/Export CSV, security and coding standards fixes. = 1.0.6 = Positioning and documentation update focused on ALT audit & bulk management. Improves "Generic ALT" detection. = 1.0.5 = Adds context visibility in ALT audit and improves bulk editing experience. = 1.0.4 = Fixes audit score calculation and improves messaging. = 1.0.3 = Dashboard redesign with ALT Quality Score, detailed audit and Media Size Savings module. = 1.0.0 = First stable release with ALT automation, SVG security and extended file support. --- Filikod is developed by [Sébastien](https://lyode.fr/), freelance WordPress developer.