=== Smart Alt Manager === Contributors: smartdev2023, ishor Tags: alt text, accessibility, seo, images, media Requires at least: 5.8 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 3.3.6 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Bulk manage alt text for images with intelligent suggestions, frontend patching, page builder and WooCommerce support. == Description == Smart Alt Manager is a comprehensive solution for managing image alt text across your entire WordPress website. It helps you improve accessibility, boost SEO, and ensure compliance with WCAG standards. = Key Features = * **Bulk Alt Text Management** - Edit alt text for multiple images at once * **Bulk Actions** - Delete auto-generated alt text or copy from titles in one click * **Smart Filters** - Quick filter chips to view all, missing, manual, or generated alt text * **Quality Checker** - Real-time quality scoring with visual badges (Good/Fair/Poor) * **Dashboard Widget** - See alt text coverage and statistics at a glance * **Admin Bar Notifications** - Get notified about missing alt text with quick access * **Smart Search** - Find images by filename, title, or existing alt text * **Context-Aware Suggestions** - Get intelligent suggestions based on image usage and metadata * **Auto-Generation** - Automatically generate alt text from image titles, captions, and descriptions * **Visual Status Indicators** - Color-coded interface shows which images need attention * **Usage Tracking** - See where each image is used across your site * **Frontend Patch** - Automatically adds alt text to images missing it on the frontend * **Page Builder Support** - Works with Elementor, Divi, Beaver Builder, and more * **WooCommerce Integration** - Patches product description images automatically * **ACF Integration** - Full support for Advanced Custom Fields image fields * **Modern Material Design** - Beautiful, intuitive interface with smooth animations = Why Alt Text Matters = * **Accessibility**: Screen readers use alt text to describe images to visually impaired users * **SEO**: Search engines use alt text to understand and rank your images * **User Experience**: Alt text displays when images fail to load * **Legal Compliance**: Many countries require accessible websites (ADA, Section 508, WCAG) = Frontend Patch = The plugin automatically ensures all images on your website have proper alt text, even if it's missing in the HTML: * Scans all frontend images * Pulls alt text from the database * Works with WordPress core, Gutenberg, and custom HTML * No content modification - reads only = Supported Page Builders & Platforms = * Elementor * Divi Builder * Beaver Builder * WPBakery (Visual Composer) * Avada (Fusion Builder) * Oxygen Builder * Revolution Slider * Advanced Custom Fields (ACF) * WooCommerce (Product descriptions) = Modern Material Design Interface = * Beautiful gradient header with glassmorphism effects * Filter chips for quick access (All, Missing, Manual, Generated) * Modern dropdown menus with smooth animations * Quality badges with visual scoring system * Responsive design for all devices * Intuitive color-coded status system * Full-width layout for maximum productivity * Dashboard widget with statistics * Admin bar notifications = Quality Checker = The built-in quality checker analyzes your alt text and provides: * **Quality Score** - 0-100 rating for each image * **Visual Badges** - Good (green), Fair (orange), Poor (red) * **Issue Detection** - Identifies generic phrases, filenames, and length problems * **Inline Warnings** - Shows specific issues below each input field * **Best Practice Tips** - Helps you write better, more accessible alt text = Bulk Actions = Save time with powerful bulk operations: * **Delete Auto-Generated** - Remove all auto-generated alt text at once * **Copy from Title** - Automatically copy image titles to alt text for missing images * **Filter + Action** - Combine filters with bulk actions for targeted operations = Dashboard Integration = * **Dashboard Widget** - View alt text coverage percentage and statistics * **Admin Bar Notification** - See missing alt text count with one-click access * **Real-time Updates** - Statistics update automatically when you make changes * **Quick Access** - Click notifications to jump directly to filtered views == Installation == 1. Upload the plugin files to `/wp-content/plugins/pichautari-alt-manager/` 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Go to Media > Smart Alt Manager to start managing your alt text == Frequently Asked Questions == = How do I add alt text to my images? = Navigate to Media >Smart Alt Manager, find your images, type or edit the alt text in the input fields, and click "Save Alt Text". = What does "Generate Missing Alt" do? = It automatically creates alt text for images that don't have any, using the image title, caption, description, and the title of pages where it's used. = How do I use the filter chips? = Click any filter chip (All, Missing, Manual, Generated) to instantly view only those images. Filters work with search and pagination. = What do the quality badges mean? = * **Good** (green) - Well-written alt text (score 80-100) * **Fair** (orange) - Acceptable but could improve (score 50-79) * **Poor** (red) - Needs improvement (score 0-49) The quality checker detects issues like generic phrases, filenames, and improper length. = How do bulk actions work? = Click the "Bulk Actions" button, select an action (Delete Auto-Generated or Copy from Title), and it applies to all images in your current view/filter. = Where can I see alt text statistics? = Check your WordPress Dashboard for the "Alt Text Status" widget showing coverage percentage and counts. You'll also see missing alt text count in the admin bar. = Will this work with my page builder? = Yes! The plugin supports Elementor, Divi, Beaver Builder, WPBakery, Avada, Oxygen, Revolution Slider, ACF, and WooCommerce product descriptions. = Does the frontend patch modify my content? = No, it only reads alt text from the database and injects it when rendering images. Your actual content remains unchanged. = What's the difference between green, blue, and yellow backgrounds? = * Green: Manually added alt text (best quality) * Blue: Auto-generated alt text (needs review) * Yellow: Missing alt text (needs attention) = How long should alt text be? = Aim for 125 characters or less. Be descriptive but concise. = Should I use alt text for decorative images? = For purely decorative images, use empty alt text (alt="") so screen readers skip them. = Does this help with SEO? = Yes! Search engines use alt text to understand and rank your images in image search results. = Is this WCAG compliant? = The plugin helps you meet WCAG 2.1 Level AA requirements for text alternatives, but you're responsible for writing quality alt text. == Screenshots == 1. Main interface with color-coded status indicators 2. Context-aware suggestions based on image usage 3. Bulk edit multiple images at once 4. Search and filter images easily 5. Modern Material Design interface == Changelog == = 3.3.6 = * Fixed frontend patch not working on Gutenberg image blocks with empty alt="" * Rewrote img tag regex to correctly capture both closing forms (> and />) * Added size-suffix stripping (-1024x683) for URL-based attachment ID lookup * Batch processing: replaced get_all_images() memory load with single lean SQL query * Batch processing: reduced per-request size to 5 for shared hosting safety * Batch processing: added 3-retry back-off on AJAX errors in JS * Removed duplicate processBatch JS function that caused errors mid-batch * Alt generator: removed find_image_usage() per-image DB call during batch = 3.3.5 = * Fixed fatal error when ACF image field returns array instead of string * Added type checking to ACF HTML filter to handle all return formats * Added Settings link to plugin list page for easier access to dashboard * Improved compatibility with ACF Blocks and repeater fields = 3.3.2 = * Fixed critical bug where ACF image fields with URL/ID return format had src removed * Added safety check to prevent processing images with empty src attributes * Improved image tag processing to preserve all attributes correctly * Fixed ACF filter to only modify array-type returns, preserving URL and ID formats = 3.3.1 = * Major performance optimization for large media libraries (10,000+ images) * Replaced PHP loops with optimized SQL queries for statistics calculation * Only load images needed for current page instead of all images * Reduced page load time by up to 90% for sites with many images * Improved database query efficiency with proper indexing * Fixed bulk menu toggle not showing submenu * Moved toast notifications to bottom-right corner for better UX = 3.3.0 = * Added AJAX-based background processing for alt text generation to prevent 503 errors * Implemented no-reload interface - all actions now work without page refresh * Added real-time progress tracking for batch alt text generation * Added toast notification system for user feedback * Improved performance for large media libraries (1000+ images) * Enhanced user experience with smooth transitions and instant feedback * Fixed timeout issues when generating alt text for many images * All actions now work via AJAX: generate, save, filter, bulk actions, search, pagination = 3.2.1 = * Fixed WooCommerce detection timing issue - filters now register on plugins_loaded hook * Fixed WooCommerce product gallery alt text patching with proper filter priority * Fixed WooCommerce product short description alt text patching * Improved frontend patch to work correctly with all WooCommerce content areas * Enhanced filter registration to ensure compatibility with WooCommerce load order = 3.2.0 = * Added WooCommerce integration for product description images * Improved alt text generation to prioritize post/page context over image filename * Enhanced frontend patch to handle empty alt attributes (alt="") * Fixed frontend patch to only read from database (no auto-generation) * Updated all prefixes to meet WordPress.org naming requirements * Fixed nonce verification for all form submissions * Improved data sanitization and validation * Added proper translator comments for internationalization * Performance optimizations with better caching * Code quality improvements and WordPress Coding Standards compliance = 3.1.0 = * Added bulk actions (delete auto-generated, copy from title) * Added filter chips for quick filtering (All, Missing, Manual, Generated) * Added alt text quality checker with scoring system * Added dashboard widget showing alt text statistics * Added admin bar notification for missing alt text * Enhanced Material Design interface with modern chips and dropdowns * Improved search bar positioning and layout * Added quality badges with visual indicators * Added translator comments for better internationalization * Fixed bulk action dropdown visibility * Performance improvements with transient caching = 3.0.0 = * Complete OOP refactoring * Added modern Material Design interface * Added frontend patch for automatic alt text injection * Added support for 8 major page builders * Added ACF integration * Added context-aware suggestions * Added usage tracking * Added smart search functionality * Fixed save functionality after OOP migration * Improved performance and code organization = 2.0.0 = * Added bulk generation feature * Added visual status indicators * Improved UI/UX = 1.0.0 = * Initial release == Upgrade Notice == = 3.2.1 = Critical fix for WooCommerce users: Resolves product gallery and short description alt text patching. Highly recommended update. = 3.2.0 = Important update: WooCommerce support, improved alt text generation logic, enhanced frontend patch, and full WordPress.org compliance. Recommended for all users. = 3.1.0 = New features: Bulk actions, quality checker, dashboard widget, and enhanced Material Design interface. Recommended update for better workflow. = 3.0.0 = Major update with new features, modern interface, and page builder support. Backup recommended before upgrading. == Best Practices == **Writing Good Alt Text:** * Be descriptive but concise (125 characters or less) * Describe what's in the image, not just the subject * Include context relevant to surrounding content * Don't start with "Image of" or "Picture of" * For decorative images, use empty alt text * Include text that appears in the image **Examples:** ❌ Bad: "image123.jpg" ❌ Bad: "Picture of a dog" ✅ Good: "Golden retriever playing fetch in a park" **SEO Tips:** * Include relevant keywords naturally * Don't keyword stuff * Make it useful for users first, search engines second **Accessibility Guidelines:** * Follow WCAG 2.1 Level AA standards * Test with screen readers when possible * Consider the image's purpose in context == Support == For support, feature requests, or bug reports, please visit the plugin support forum. == Privacy == This plugin does not collect or transmit any user data. All processing happens locally on your WordPress installation.