=== BeepBeep AI – Alt Text Generator ===
Plugin Name: BeepBeep AI – Alt Text Generator
Contributors: beepbeepv2
Plugin URI: https://oppti.dev/beepbeep-ai-alt-text-generator
Author URI: https://oppti.dev
Tags: ai alt text, alt text generator, image seo, accessibility, woocommerce
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 4.6.115
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: beepbeep-ai-alt-text-generator

AI alt text generator for WordPress. Bulk-generate image alt text for SEO, accessibility, WooCommerce, and media libraries.

== Description ==

BeepBeep AI is a WordPress AI alt text generator for site owners who want faster image SEO, stronger accessibility, and less manual image admin. It scans your WordPress Media Library and WooCommerce product images, finds missing alt text and weak image descriptions, and helps you generate AI alt text in bulk from one clean workflow. Instead of editing image alt attributes one by one, you can scan the library, bulk-generate descriptive alt text, review the results, and save approved changes back into WordPress.

Better image alt text helps search engines understand your images, supports Google Images and product discovery, and improves the experience for screen readers. That makes BeepBeep AI useful for bloggers, publishers, WooCommerce stores, agencies, SEO teams, and accessibility-focused site owners who need a practical alt text workflow inside wp-admin. Use one-click scans to identify missing alt text, process many images at once, review suggestions that need extra context, and optionally turn on automatic alt text for new uploads. The result is a faster path to cleaner WordPress image SEO, more consistent media library coverage, and better accessibility across your site.

= Why site owners choose BeepBeep AI =

* **Bulk-generate WordPress alt text** so large media libraries can be cleaned up in minutes instead of image by image.
* **Fix missing image alt attributes** across WordPress posts, pages, products, and media attachments.
* **Improve image SEO with clearer descriptions** that help search engines understand posts, products, and category images.
* **Support accessibility and WCAG workflows** by finding missing alt text fast and reviewing AI suggestions before they go live.
* **Scan once, prioritise quickly, and act** with clear views for missing, needs review, and optimised images.
* **Keep humans in control** with edit, review, regenerate, and approve actions built into the workflow.
* **Optimise WooCommerce product images** across featured images and galleries without changing your theme or catalog setup.
* **Automate future uploads** with optional AI alt text generation for new media.

= Features =

* **Bulk AI alt text generation for WordPress** so you can update many images in one action instead of editing the media library one file at a time.
* **One-click scan for missing alt text** to surface the images most likely to hurt accessibility and image SEO.
* **Alt tag and alt attribute cleanup** for WordPress images that are empty, generic, or ready for a better description.
* **Review, edit, and regenerate workflow** that keeps quality high when AI suggestions need extra context.
* **Image SEO-focused output** designed to help Google Images and product search understand what each image shows.
* **WooCommerce-ready optimisation** for product featured images, gallery images, and broader store content.
* **Automatic alt text for new uploads** so future media stays covered without repeating the same cleanup process.
* **Clear dashboard, usage, and coverage views** so teams can track progress and prioritise the next fixes.
* **Native WordPress admin experience** that feels like a practical plugin workflow, not a disconnected external tool.

= How it works =

1. **Scan your WordPress media library** to find missing alt text, weak descriptions, and optimisation opportunities.
2. **Generate AI alt text in bulk** for the images you want to improve.
3. **Review and edit suggestions** so the final text matches your content, products, and brand voice.
4. **Save approved alt text** back to WordPress and keep your media library moving toward full coverage.
5. **Turn on automatic optimisation** if you want new uploads to get AI alt text going forward.

= Use cases =

* **Bloggers and publishers** who want faster image SEO improvements across existing posts and future uploads.
* **WooCommerce stores** that need bulk alt text for product images, galleries, and category visuals.
* **Agencies and freelancers** managing multiple WordPress sites and large client media libraries.
* **SEO teams** improving image discoverability and consistency across content and commerce pages.
* **Accessibility-focused site owners** improving image descriptions as part of broader WCAG and content quality work.

= Why choose BeepBeep AI =

BeepBeep AI is built for WordPress users who want the practical benefits of AI alt text without giving up review control. It focuses on the workflows that actually matter in wp-admin: scanning the media library, fixing images in bulk, reviewing edge cases, improving WooCommerce image coverage, and keeping future uploads organised. The result feels closer to a premium WordPress workflow than a generic AI tool bolted onto your site.

= Free plan and paid options =

Start with 10 trial generations and test the workflow before creating an account. The free plan includes 15 AI alt text generations per month. Paid plans unlock more volume, faster processing, and higher-capacity workflows for growing sites and stores.

= Learn more =

Want a deeper look at AI alt text workflows and alternatives for WordPress? [Compare AI alt text options for WordPress](https://oppti.dev/alttext-ai-alternative).

= Demo Video =

https://www.youtube.com/watch?v=XK9snigPH2c

== Installation ==

1. Go to WordPress Admin -> Plugins -> Add New.
2. Search for "BeepBeep AI Alt Text Generator".
3. Click Install Now, then Activate.
4. Open BeepBeep AI -> Dashboard (or ALT Library) to generate your first descriptions.
5. Optional: enable auto-generation in Settings to process new uploads automatically.
6. For WooCommerce stores, run bulk generation to fix existing product images and galleries.

== Frequently Asked Questions ==

= Can I bulk generate alt text in WordPress? =

Yes. BeepBeep AI is built for bulk alt text generation in WordPress. You can scan large libraries, select images that need work, generate AI suggestions in bulk, and review them before saving.

= Can it fix missing alt tags and image alt attributes? =

Yes. WordPress stores image descriptions as alt attributes, often called alt tags. BeepBeep AI finds images with missing alt text and helps you generate clearer descriptions for media attachments, posts, pages, and WooCommerce products.

= Does this plugin help with accessibility and WCAG? =

Yes. The plugin helps teams add and review alt text at scale, which supports accessibility and WCAG-oriented workflows. It does not replace human judgment, though.

= Does BeepBeep AI work with WooCommerce product images? =

Yes. BeepBeep AI supports WooCommerce featured images, gallery images, and standard WordPress media attachments used throughout product pages and shop content.

= Can BeepBeep AI generate alt text automatically for new uploads? =

Yes. You can use automatic optimisation for new uploads so future WordPress media gets AI-generated alt text without repeating the same manual cleanup workflow.

= Will it overwrite my existing alt text? =

BeepBeep AI is designed around review and approval. You can inspect, edit, regenerate, and approve suggested alt text before saving changes back to WordPress.

== Screenshots ==
1. Dashboard overview showing missing ALT text, monthly usage, and the next best action for WordPress image SEO and accessibility.
2. Scan your WordPress media library to find missing ALT text and images that need review.
3. Generate AI alt text in bulk for WordPress and WooCommerce images from one review workspace.
4. Review, edit, and score AI alt text before saving it live.
5. Before and after example showing an image with missing ALT text transformed into descriptive AI-generated ALT text.
6. BeepBeep AI works inside WordPress so you can scan, review, and optimise images without leaving wp-admin.
7. WooCommerce image workflow for product featured images and gallery images.
8. Settings screen for automatic AI alt text on new uploads.

== External Services ==

This plugin connects to external APIs to generate image alt text and provide account/billing features.

Service: AltText AI Backend API (https://alttext-ai-backend.onrender.com)
Purpose: Generate alt text descriptions, perform alt text review checks, and handle authentication, license, usage, billing, and contact requests.
Privacy policy: https://oppti.dev/privacy

Service: OpenAI API (used by the backend service)
Purpose: Generate and review alt text descriptions.
Privacy policy: https://openai.com/privacy

Service: PostHog (optional product analytics)
Purpose: If the site owner opts in, send anonymous plugin usage analytics such as activation status, dashboard views, feature clicks, and upgrade funnel events. BeepBeep AI does not send ALT text, filenames, image content, API tokens, or license keys in analytics events.
Privacy policy: https://posthog.com/privacy

== Changelog ==

= 4.6.114 =
* Fixed telemetry validation gaps: batch_generation_started, upgrade_cta_clicked on NAI paywall paths, checkout_started before Stripe redirect, and auth funnel flush before redirect.
* Fixed undefined entitlement_state PHP warning and wp_localize_script warnings on library admin pages.

= 4.6.113 =
* Exposed trackFeatureUsed on the bbaiTelemetry client API.
* Normalized feature_used feature names and routed NAI dashboard calls through the telemetry wrapper when available.

= 4.6.111 =
* Fixed NAI dashboard client telemetry for generation_started and generation_completed on the legacy drawer generation path.
* Fixed feature_used emissions for NAI shell navigation (library, settings, dashboard, billing, statistics).
* Fixed per-run generation_run_id assignment so generation_completed is not dropped when the drawer opens before bbai-admin dispatches.

= 4.6.110 =
* Telemetry hardening: canonical property enrichment for all new events (plugin_slug, telemetry_version, normalized host, generation_type, quota_state, license_state).
* feature_used events now always require feature_name.

= 4.6.90 =
* Unified logged-out and logged-in dashboard rendering around the shared ALT coverage dashboard structure.
* Made ALT Coverage, progress ring, scanned/optimised/missing/review counts, and Next Recommended Action the primary dashboard model.
* Removed remaining Today's Pass, ALT Pass, workflow stepper, and duplicate accessibility metric language from dashboard surfaces.

= 4.6.14 =
* Refactored the nAi dashboard into smaller PHP components and focused JavaScript modules while preserving existing dashboard behaviour.
* Split ALT Library generation state helpers into focused legacy-compatible modules for locks, notices, bulk orchestration, API request construction, and row/count/filter state.
* Added regression coverage and release compliance cleanup for dashboard and ALT Library generation flows.

= 4.6.4 =
* Fixed background generation persistence so progress survives page navigation, refreshes, and multi-tab sessions across all plugin pages.
* Fixed in-browser background jobs so progress syncs correctly via the shared bbaiJobState subscription, removing duplicate polling and stale state.
* Fixed the ALT Library pagination so approving all items on a filtered page automatically reloads to show remaining items from other pages, instead of leaving an empty view.
* Fixed the floating job widget so the Review images button is visible after generation completes (was invisible due to a WordPress admin CSS conflict).
* Removed the misleading "Review suggestions." suffix from the generation-complete widget status; the button label already communicates the next action.
* Fixed Plugin Check warnings by adding translator comments to all i18n calls with printf placeholders across the plugin.
* Aligned the dashboard insight card layout so the main value heading and CTA buttons sit at the same vertical position across all three cards regardless of the optional success badge.

= 4.6.3 =
* Updated the WordPress.org large and small banners with correctly sized Better Alt Text, Better Accessibility artwork.
* Refreshed the WordPress.org thumbnail icon and improved readme SEO coverage for AI alt text, image SEO, accessibility, WooCommerce, and missing alt attributes.
* Polished the dashboard insight cards with clearer outcome copy, proof badges, stronger visual hierarchy, and aligned refreshed-state values.
* Fixed manual Re-scan library feedback so scan completion or failure is shown inline and persists after dashboard refreshes.
* Fixed scan feedback timing so completion messaging is reattached if a dashboard render replaces the re-scan link.
* Improved all-optimised dashboard presentation, retention-strip copy, and state consistency after generation, review, approval, and polling.
* Fixed upgrade CTA and modal stacking edge cases around generation-complete and automation prompts.

= 4.6.2 =
* Replaced the WordPress.org banner and thumbnail icon with refreshed Better Alt Text, Better Accessibility artwork.
* Improved generation button loading states with one spinner, one clear Generating ALT text label, hard disabled buttons, and duplicate-click protection.
* Made dashboard polling idempotent so unchanged state no longer flickers, replays completion animations, or replaces stable DOM.
* Fixed dashboard state sync after generation and approval so the donut, right card, credits card, and progress CTA stay aligned without a refresh.
* Fixed stale all-optimised, Done, and review-ready state leaks after approving or generating images.
* Fixed monthly credit usage display and progress bars so usage updates from backend truth after generation.
* Added clear dashboard feedback after manual library re-scans complete or fail.
* Added contextual first-success, review, credit, and upgrade prompts without interrupting generation or review flows.
* Made automatic optimisation CTAs clickable, trackable, and connected to the existing upgrade modal.
* Improved the bulk generation modal with dynamic steps, real progress, live feed entries, compact layout, and clearer completion actions.
* Fixed upgrade modal stacking from the generation-complete automation link so pricing opens above the dismissed progress modal.
* Polished dashboard spacing, CTA alignment, retention-strip copy, and completion/review states.

= 4.6.1 =
* Maintenance release.

== Upgrade Notice ==

= 4.6.111 =
Telemetry-only hotfix: restores NAI client generation and navigation feature_used events.

= 4.6.110 =
Telemetry-only release: canonical PostHog property enrichment for new events.

= 4.6.90 =
Dashboard UX now uses one ALT coverage-first structure for logged-out and logged-in states.

= 4.6.14 =
Dashboard and ALT Library architecture cleanup with preserved generation, review, quota, and telemetry behaviour.
