Description
KOZ SEO Core combines technical SEO with an administrator-controlled OpenAI Vision workflow for image accessibility.
OpenAI Vision can analyze the actual image and automatically draft useful ALT descriptions. The administrator sees the real image thumbnail, current ALT, AI candidate, confidence and reason, can edit the suggestion, re-analyze or skip the image, and explicitly approve the final ALT before it is saved.
AI-generated ALT candidates are never written automatically during analysis. Existing ALT values are preserved unless replacement is deliberately enabled.
Technical SEO features include:
- SEO titles and meta descriptions.
- Canonical URLs and robots directives.
- Open Graph and Twitter metadata.
- JSON-LD schema.
- Hreflang support.
- WordPress sitemap controls.
/llms.txtand/.well-known/koz-ai-manifest.jsonfor AI discovery.- Read-only inventory of other SEO plugins.
- Browser-rendered accessibility audit.
OpenAI Vision image ALT
- Analyzes the actual image instead of guessing from filenames or URLs.
- Automatically drafts accessibility-focused ALT descriptions.
- Supports administrator-controlled batches for large media libraries.
- Shows the real thumbnail, current ALT, editable AI candidate, confidence and reason.
- Supports approve/apply, skip and individual re-analysis.
- Preserves existing ALT by default.
- Uses the WordPress AI Client and the OpenAI provider configured by the administrator.
- KOZ SEO Core does not store the OpenAI API key.
Part of the KOZ Suite
KOZ SEO Core is one focused module of the broader KOZ Suite, a family of WordPress plugins that share a common KOZ administration experience and visual identity. Each plugin remains independent, so site owners can install only the modules they need or combine several modules as one toolkit.
Current public KOZ plugins:
- KOZ SEO Core — technical SEO, schema, sitemaps, AI discovery and OpenAI Vision image ALT.
- KOZ Copy Actions — accessible copy-to-clipboard actions for WordPress content.
- KOZ URL-Only Comment Spam — privacy-first local moderation for URL-only comment spam.
Additional KOZ Suite modules are used in production and may be published separately as they are prepared for public distribution.
Privacy and control
AI Vision runs only when an administrator explicitly starts analysis. The selected image and a short task prompt may be sent through the configured OpenAI connector. The rest of KOZ SEO Core works without OpenAI.
Installation
- Deactivate the former UA FREE SEO Core package, but keep it installed during verification.
- Upload and activate KOZ SEO Core.
- Open KOZ Suite > SEO Core and confirm the existing settings.
- Keep SEO output disabled while another SEO plugin is active.
- Check
/llms.txt,/.well-known/koz-ai-manifest.jsonand one page source. - Run Plugin Check.
- Remove the former package only after the KOZ version works correctly.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“KOZ SEO Core” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “KOZ SEO Core” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
2.1.22
- WordPress.org compatibility metadata: updated Tested up to to WordPress 7.1.
2.1.21
- Hardens JSON-LD output for WordPress.org review by using script-safe default wp_json_encode() escaping.
- Removes JSON_UNESCAPED_* flags from generated JSON output paths while preserving valid JSON responses and audit data.
- No SEO, sitemap, translation, AI Vision or saved-metadata behavior changes.
2.1.20
- Stops changing the activation status of the former UA FREE SEO plugin; administrators remain in control of plugin activation and deactivation.
- Documents the optional OpenAI service used only when an administrator explicitly runs AI Vision ALT analysis.
- Keeps SEO output, sitemap cleanup, translation integration and saved metadata behavior unchanged.
2.1.19
- Excludes Pagelayer technical templates from the WordPress XML sitemap and marks direct template views noindex/follow.
- Removes the WordPress users sitemap whenever author archives are configured noindex, keeping sitemap discovery aligned with robots policy.
- Leaves normal pages, posts, public gallery content and active translator-managed routes unchanged.
2.1.18
- Keeps all source-language SEO features fully standalone when no translation plugin is installed.
- Accepts an optional provider-neutral translation contract for multilingual hreflang filtering.
- Does not force KOZ language namespaces when another translator owns multilingual routing or SEO.
- Integrates automatically with KOZ Static Translate for ready-only hreflang and translated sitemap discovery.
2.1.15
- Adds an administrator-triggered browser-rendered accessibility audit for published pages.
- Checks actual same-site rendered HTML for H1 count, empty ALT text, potential empty links, meta description presence and noindex state.
- Runs in the administrator browser to avoid long PHP export requests; no database writes or external HTTP requests are performed.
- Exports a privacy-safe JSON result containing public paths and counts only, without page HTML or visitor data.
2.1.14
- Prevents WordPress block and gallery configuration JSON from leaking into automatic meta and social descriptions.
- Uses a clean page-title fallback when a gallery page has too little natural text for a useful description.
- Keeps explicitly saved manual SEO descriptions unchanged.
2.1.13
- Keeps the AI Vision batch controls usable after applying ALT values or after a transient provider readiness check.
- Applying selected ALT values no longer forces a full page reload.
2.1.12
- Fixed Plugin Check escaping and sanitization findings in AI Vision ALT workflow.
- Preserved editable candidates, approve/skip/re-analyze controls, and new-media queue.
2.1.11
- Lets administrators edit every AI Vision ALT candidate before approval.
- Adds explicit approve/apply, skip and per-image re-analysis controls.
- Adds an “Empty ALT, not analyzed” routine queue and an all-unprocessed queue for existing ALT review.
- Shows a pending counter for unprocessed images with empty ALT so newly uploaded media can be handled in later batches.
- Keeps Vision review state across plugin upgrades instead of re-queuing already processed images because of a version bump.
- Existing WordPress ALT values remain protected unless replacement is explicitly enabled.
2.1.10
- Makes Vision batches resilient to intermittent WordPress/OpenAI model-discovery failures.
- Retries multimodal text generation with progressively simpler model-selection constraints.
- Removes structured-output and max-token capability requirements from model discovery; JSON is requested and validated in the prompt instead.
- Does not write ALT during analysis and preserves the explicit review/apply workflow.
2.1.9
- Moves AI Vision analysis from admin-ajax to a dedicated authenticated REST endpoint, following the WordPress 7.0 AI Client integration guidance.
- Avoids the false “OpenAI is not ready” readiness result seen only inside admin-ajax while the connector is available in the normal admin request.
- Keeps ALT analysis read-only until explicit apply and preserves the existing OpenAI Connector credentials flow.
2.1.8
- Raises the minimum WordPress version to 7.0 because the AI Vision workflow uses the native WordPress AI Client introduced in 7.0.
- Removes Plugin Check compatibility errors for wp_ai_client_prompt() and wp_supports_ai().
- Tightens nonce/input handling and removes the reported direct SQL/slow meta-query warnings from the AI Vision ALT manager.
- Replaces metadata queries used for queue/preview/statistics with a lightweight cursor, recent-ID list and incremental counters.
- Uses GPT-5.6 Luna first, with Terra and GPT-5.4 nano as fallbacks for OpenAI Vision analysis.
2.1.7
- Replaces metadata/filename ALT heuristics with actual AI vision analysis.
- Uses the native WordPress 7.0 AI Client and OpenAI connector; KOZ SEO Core no longer stores an OpenAI API key.
- Analyzes images progressively in administrator-controlled batches and never writes ALT during analysis.
- Returns content/decorative/uncertain decisions with confidence and a human-readable reason.
- Shows actual thumbnails, current ALT and AI candidates before any write.
- Preserves existing ALT by default; replacement requires an explicit administrator checkbox.
2.1.6
- Adds a Media ALT assistant for image attachments with an explicit dry run before any write.
- Auto-applies only high-confidence candidates from existing caption, description or clearly human-authored attachment titles.
- Never overwrites existing ALT values; filename-only, generic and page-context-only cases remain review-only.
- Applies safe candidates in AJAX batches to avoid one large write request.
2.1.5
- Resolves non-root public permalinks before trusting front-page conditionals, so page-builder routes keep their own title, description, canonical and Open Graph URL.
- Leaves the real homepage behavior and saved SEO metadata unchanged.
2.1.5
- Fixes SEO context on valid page-builder/custom-rendered permalinks that WordPress does not expose as singular requests.
- Uses the configured organization description for homepage metadata instead of falling back to a polluted site tagline.
2.1.3
- Strict WordPress.org prefix re-audit with canonical kozseo / KOZSEO identifiers.
- Preserves legacy settings, post metadata, AI manifest route and public filter compatibility.
2.1.1
- Aligned the public context and hreflang filter hooks with the KOZ SEO prefix required by Plugin Check.
2.1.0
- Rebranded the public package as KOZ SEO Core.
- Added KOZ Suite navigation, ten runtime administration languages and English fallback.
- Added the KOZ AI manifest endpoint while retaining the former endpoint for compatibility.
- Preserved existing settings, post metadata and migration-safe read-only diagnostics.
- Replaced bundled PO/MO translations with runtime dictionaries and a source POT file.
- Updated ownership, support and repository metadata.
2.0.8
- Last stable release under the former UA FREE public branding.
