KOZ Static Translate

KOZ Static Translate scans published WordPress content, stores translation segments in plugin-owned tables, processes them through Azure Translator and serves completed language routes without changing the original posts. Azure usage stays within a monthly limit and a daily budget, is shown by source, and is never triggered by visitors or search engine crawlers. Text that Azure translated but validation rejected is not paid for twice. The plugin preserves the proven database schema, queue, cron hooks, public URLs and stored Azure settings from the former UA FREE package. It also supports dynamic content added after page load, a floating language selector, a language sitemap and controlled cleanup of legacy translator leftovers. The plugin was originally developed for the UA FREE charitable foundation website, which remains its primary production environment. The software is independently owned and maintained by Tony Kozyriev (ramirkz). Part of the KOZ Suite KOZ Static Translate is one focused module of the broader KOZ Suite, a family of independent WordPress plugins that share a common KOZ administration experience and visual identity. Each KOZ plugin remains independently installable, so site owners can use only the modules they need or combine several modules into 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 selected WordPress content.
• KOZ URL-Only Comment Spam — privacy-first local moderation for URL-only comment spam.
• KOZ Static Translate — AI-powered multilingual translation with Microsoft Azure AI Translator and static language routes.
• KOZ Translate Diagnostics — read-only health checks and privacy-safe diagnostic reports for KOZ Static Translate.
• KOZ 404 Guard & URL Intelligence — privacy-safe 404/410 diagnostics, controlled same-site redirects and URL intelligence.
• KOZ Consent Manager — privacy-first visitor consent, optional script control and Google Consent Mode v2 synchronization.
• KOZ Donate Stats & Conversions — local donation-journey analytics and consent-aware conversion events for WordPress.
• KOZ Site Bridge — secure read-only WordPress diagnostics, controlled same-site probes and authenticated REST automation.

Main features

• Queued Azure Translator processing with monthly character controls.
• Translation memory to avoid paying repeatedly for identical text.
• Public language routes enabled only after a page is complete.
• Dynamic text, SVG and Chart.js translation support.
• Language switcher and translation sitemap.
• Backup-first cleanup and reset tools.
• Ten bundled administration languages with English fallback.

Source code The complete human-readable source for this plugin is included in the plugin package and is maintained publicly at: https://github.com/ramirkoz/ua-free-plugins/tree/main/koz-static-translate The JavaScript files in assets/ are shipped as human-readable source files. No npm, webpack or other build step is required to regenerate the distributed JavaScript. Privacy The plugin does not add analytics or advertising telemetry. Content selected for translation is sent to the configured Azure Translator endpoint. Azure credentials are encrypted in the WordPress database using keys derived from WordPress salts.

0.10.0

• Fixed: public page views (visitors and search engine crawlers) no longer call Azure Translator. Source-language text found on rendered translated pages is queued for the background worker instead. Before this change crawlers could use the whole monthly budget and wait up to 24 seconds per page.
• Fixed: Azure output rejected by validation is remembered per language and text; after two rejections the text is no longer sent, so the same characters are not billed again. Administrators can allow the text again.
• Fixed: cached translated pages are rebuilt after plugin, theme, menu, customizer or KOZ SEO Core settings changes, and the page cache is cleared.
• Fixed: the idle scheduled event left by earlier releases is removed; nothing is scheduled unless the background worker is enabled.
• New: daily character budget (default: monthly limit / 30) on top of the monthly limit and reserve.
• New: Azure usage by source (queue, background worker, dynamic content, connection test) for the last 30 days, and admin notices at 80% and 95% of the monthly limit.
• New: optional background worker (off by default) that processes the queue and queued page text every five minutes within the budget; the admin "Run one queue step" button works again.
• Changed: partially translated (noindex) routes keep the page title instead of an empty .
• Changed: the translation sitemap lists hreflang alternates (source, x-default and every ready language) and moves to /koz-translations-sitemap.xml; /uafree-translations-sitemap.xml keeps working.
• Changed: Azure client and budget accounting moved into separate classes (first step of splitting the main class).
• Changed: site-specific behaviour is configurable: do-not-translate terms and the daily report title prefix are settings (existing installations keep their previous values), the UA FREE Donate repair routine is removed, and runtime messages are in English.
• Changed: the bundled admin translations are loaded again, so the admin screen follows the user language.
• Removed PayPal from the developer support panel and corrected the BTC and USDT TRC-20 developer wallet addresses.

0.9.39

• Updated KOZ Suite documentation to include all eight current public plugins.
• Uses the WordPress Filesystem API for backup-directory/file permission changes and legacy-backup moves.
• Sanitizes the server document-root value before using it in backup path safety checks.
• WordPress Plugin Check remediation for the filesystem and input-sanitization findings reported after 0.9.38.

0.9.38

• Stores cleanup/reset backups only in a verified non-public temporary directory and migrates legacy uploads backups away from the public web tree.
• Hardens inline JavaScript configuration JSON with JSON_HEX escaping and validates the JavaScript global identifier before enqueue output.
• WordPress.org T3 security/compliance remediation; translation behavior is otherwise unchanged.

0.9.37

• Uses WordPress enqueue APIs for plugin-owned frontend CSS and JavaScript instead of printing raw style/script tags.
• Makes the dynamic translation REST endpoint administrator-only with capability checks and WordPress REST nonce authentication; public HMAC tokens are removed.
• Stops automatically deactivating the former UA FREE plugin and shows a manual-action notice instead.
• Documents the public source repository and Microsoft Azure Translator external-service data flow, privacy and product terms.
• Ships the admin JavaScript in human-readable form; translation/readiness behavior is otherwise unchanged.

0.9.36

• Makes meta_description, meta_og_description and meta_twitter_description universally non-blocking for page readiness.
• Makes image alt-text segments non-blocking for readiness while keeping them available for later translation.
• Removes the site-specific text exceptions previously used for readiness and replaces consent/privacy handling with generic structural context detection.
• No Azure request, scan, rebuild, cron or automatic worker is introduced.

0.9.35

• Adds a universal manual action that prepares exactly one pending Priority Core source per click.
• The next page is selected from dynamically detected internal navigation; no site-specific paths, titles or slugs are used.
• Preparation performs one local source scan and hydrates existing Translation Memory only; no Azure request, full inventory rebuild, cron or automatic loop.

0.9.34

• Adds a read-only Priority Core discovery diagnostic showing each detected internal navigation path and whether it exists in source inventory and core queue.
• Diagnostic performs no writes, scans, rebuilds, cron work or Azure requests.
• Priority Core processing behavior remains unchanged from 0.9.33.

0.9.33

• Priority Core now merges internal links from all assigned primary/main/header navigation locations, the richest unassigned classic-menu fallback, and block-theme Navigation.
• External URLs are discarded and duplicate internal paths are removed.
• No site-specific page names, titles or URL paths are used.

0.9.32

• Expands universal Priority Core menu detection for page builders and block themes.
• Detection now checks assigned classic menu locations, unassigned classic nav menus and block-theme wp_navigation menus, then selects the strongest internal navigation set.
• No site-specific page names, titles or URL paths are used.

0.9.31

• Removes all site-specific Priority Core page names, titles and URL paths.
• Priority Core is now detected universally from the WordPress home page plus the active primary/main navigation menu.
• Matching uses exact internal URL paths only, preventing legacy pages from entering Priority Core because of similar titles.
• Processing remains manual, local-only and limited to 4 pages per click.

0.9.30

• Replaces broad core batching with an explicit Priority Core set: Home, Projects, Donate, Reports, About, Gallery, Partners and Financial report.
• Secondary/legacy core URLs and report posts are excluded from this batch entirely.
• Batch output now shows the Priority Core label and the maximum number of source segments still missing for an incomplete page.
• Processing remains manual, local-only and limited to 4 pages per click.

0.9.29

• Core readiness batches now use explicit page priority instead of source/database ID order.
• First wave: Home, UA FREE, Donate, About and Reports landing; then remaining top-level core pages; nested core pages last.
• Reports remain excluded from the core batch. Processing stays manual and limited to 4 pages per click.

0.9.28

• Adds a manual bounded core-readiness batch: maximum 4 core pages per click.
• Uses only existing local translations and Translation Memory; no Azure, scan, rebuild, cron or automatic loop.
• Incomplete pages remain pending and are reported without being forced ready.

0.9.27

• Treats two consent-component descriptions and the UA FREE logo alt text as non-blocking readiness segments.
• One-page reconcile safely promotes only those matching segments to protected status, then recalculates readiness from existing local translations/Translation Memory.
• No scan, queue rebuild, automatic worker or Azure request is performed.

0.9.26

• Adds a read-only one-page diagnostic that lists source segments missing from Translation Memory/ready translations.
• Diagnostic is capped at 25 rows and performs no writes, scans, rebuilds, cron work or Azure requests.
• Safety-mode behavior remains unchanged.

0.9.25

• Plugin Check compliance fix for the one-page readiness action: direct nonce verification, sanitized path input, and translator comments.
• No change to the 0.9.24 safety-mode runtime behavior.

0.9.24

• Adds a bounded one-page readiness reconciliation using existing Translation Memory only.
• The reconciliation performs no source scan, queue rebuild or Azure request.
• Admin status now accurately reports that the automatic worker is disabled in safety mode.
• Opening the Static Translate admin screen no longer runs hidden upgrade/repair maintenance.

0.9.23

• Stability release: activation performs no inventory scan, rebuild, readiness repair or Azure work.
• Automatic cron and shutdown workers are disabled.
• Manual Run/Rebuild actions are temporarily disabled to protect production stability.
• Existing translated routes, language switching and stored translation data remain available.

0.9.19

• Keep the language switcher visible on translated provisional routes.
• Provisional routes show only the source language and the current language, without advertising other unfinished translations.

0.9.18

• The floating language switcher now advertises only fully translated routes for the current page and stays hidden when none are ready.
• Provisional translated routes no longer render the language switcher, preventing unfinished language URLs from being exposed through navigation.
• No changes to Azure budget limits, translation memory, queue contents or public URL structure.

0.9.17

• Updated WordPress compatibility metadata for WordPress 7.1.
• No functional changes.

0.9.16

• Fixes retired-language queue cleanup SQL for WordPress 6.0+ without the WP 6.2-only %i identifier placeholder.
• No change to languages, Azure usage logic, translation memory or readiness behavior.

0.9.15

• Fix Plugin Check prepared-SQL placeholder warning in retired-language queue cleanup.

0.9.14

• Finalizes the supported public language set: EN/ZH/ES/AR/ID/PT/FR/JA/DE/HI; Russian is forbidden.
• Stops accidental PL/IT/CS/RO Azure queue work without deleting existing translation memory.
• Keeps incomplete routes noindex with blank translation-dependent SEO fields until fully ready.
• Shows Azure characters and requests for every billed language code, including inactive/legacy codes.
• Exposes an optional provider contract for multilingual SEO integration without requiring KOZ SEO Core.

0.9.9

• Adds bounded transient render caching for source and translated HTML to reduce repeated same-site rendering work.
• Caches translated HTML by source render hash and language while keeping translation data and URLs unchanged.

0.9.8

• Stops cache-busting the canonical source page during translated-route rendering.
• Uses a normal browser-like source fetch with a bounded timeout to reduce intermittent translated-route timeouts seen by crawlers and ad destinations.
• Translation data, queue state, readiness rules and public route structure remain unchanged.

0.9.7

• Fix the remaining English About H1 language mismatch with an exact route-scoped fallback.
• Preserve existing SEO, canonical, Open Graph, robots and hreflang behavior.

0.9.6

• Fixes missing H1 semantics on provisional /en/donate/ and /en/about/ when an upstream PageLayer/cache fragment still exposes the primary heading as H2/H3.
• Promotes only an existing matching translated heading; does not invent or duplicate heading text.
• Leaves canonical, og:url, robots, hreflang and metadata behavior unchanged.

0.9.5

• Fixes Ukrainian metadata leaking into the provisional English home and reports routes.
• Keeps canonical, localized og:url, noindex and hreflang safeguards unchanged.
• Applies the fallback only when known UA FREE metadata remains in Ukrainian.

0.9.4

• Rewrites og:url to the localized self URL so social metadata matches the translated canonical.
• Keeps translated-route hreflang checks read-only during frontend rendering.
• Keeps provisional noindex routes out of hreflang until translation coverage is complete.

0.9.3

• Adds reciprocal source-page hreflang integration with KOZ SEO Core.
• Exposes only fully translated language routes in source-page hreflang output.
• Keeps provisional monthly-limit routes safely noindex until every required translation segment is ready.

0.9.2

• Moved plugin-owned runtime identifiers to the unique kozstx / KOZSTX prefix and ramirkz\kozstx namespace.
• Added automatic migration of existing settings, runtime state and translation tables from the former uafree_st_* storage.
• Preserved the existing public language sitemap URL and former Azure configuration constants as compatibility inputs.
• Normalized KOZ Suite navigation and standalone support UI without duplicate support panels.

0.9.1

• Preserved JSON-LD and other JSON script blocks byte-for-byte during translated-page DOM processing.
• Rewrote localized JSON-LD URLs before script protection to prevent invalid structured data.
• Fixed Google Search Console parse errors caused by quotes inside translated site names.

0.9.0

• Rebranded the public package as KOZ Static Translate.
• Added KOZ Suite navigation and current package status detection.
• Added ten runtime administration languages with English fallback.
• Rebuilt the administration screen and moved scripts and styles to enqueued assets.
• Preserved existing translation tables, options, queue, cron hooks and public language routes.
• Replaced bundled PO/MO files with source-only translation metadata.
• Added safe deactivation of the former package after KOZ activation.

0.8.7

• Last stable release under the former UA FREE public branding.