English · 中文 (简体) · 日本語

LazyBlog Translations

A vivid, lightweight multilingual layer for WordPress posts.
One language switcher, three translation engines, clean post-meta storage.

Jump to	Link
Install	Quick Start
Choose backend	Providers
Run Codex locally	Codex Local API Setup
Translate the plugin	Internationalization
Support	Support

LazyBlog Translations keeps WordPress multilingual publishing simple: each post owns its source language and translation records, and readers use a compact floating language switcher. Missing translations can be generated on demand without adopting a heavy multilingual suite.

What It Does

• Stores source language and translations in WordPress post meta.
• Renders the existing LazyBlog-style floating language selector.
• Generates missing translations through Codex/LazyBlog, OpenAI, or DeepSeek.
• Prevents duplicate post/language jobs when multiple readers click the same draft language.
• Preserves Markdown-origin math with MathJax.
• Reuses reviewed source and translation excerpts for search descriptions and Open Graph/X cards on single posts.
• Uses each reviewed translation title in the HTML document title on language-prefixed post pages.
• Preserves originating campaign attribution on the exact first-party LKT fit-check bridge using only four validated UTM fields.
• Provides WordPress i18n plumbing through Text Domain: lazyblog-translations and Domain Path: /languages.

Providers

Provider	Best for	Needs local service	Default model
Codex / LazyBlog local API	Long posts, polishing, Markdown sync, image cleanup, local automation	Yes	gpt-5.4
OpenAI direct API	Simple on-demand translation from WordPress	No	gpt-4o
DeepSeek direct API	OpenAI-compatible hosted translation path	No	deepseek-v4-flash

The rendering layer is provider-independent. All providers write the same translation data, so a post can be maintained by local Markdown workflows today and direct hosted APIs later.

Quick Start

1. Upload lazyblog-translations to /wp-content/plugins/.
2. Activate LazyBlog Translations in WordPress.
3. Open Settings > LazyBlog Translations.
4. Choose Codex / LazyBlog local API, OpenAI direct API, or DeepSeek direct API.
5. Save credentials and provider settings.
6. Visit a post and click a missing language in the floating switcher.

Codex Local API Setup

Use Codex mode when you want the full LazyBlog automation stack.

Plugin repo bootstrap script:

git clone https://github.com/lazyingart/lazyblog-translations.git
cd lazyblog-translations
tools/install_lazyblog_translation_api.sh

LazyBlog operator repo direct setup:

git clone https://github.com/lachlanchen/LazyBlog.git
cd LazyBlog
scripts/install_lazyblog_translation_api.sh

GitHub script link: https://github.com/lazyingart/lazyblog-translations/blob/main/tools/install_lazyblog_translation_api.sh

The installer checks Python, tmux, and Codex CLI, creates or updates .env, ensures LAZYBLOG_API_TOKEN exists, validates the local API, and starts the service in tmux through scripts/start_live_translation_api_tmux.sh.

OpenAI and DeepSeek modes do not need this service.

Internationalization

Plugin i18n support includes:

• Text Domain: lazyblog-translations
• Domain Path: /languages
• load_plugin_textdomain() at runtime
• languages/lazyblog-translations.pot for translators
• localized GitHub readme starters in i18n/

Generate an updated POT after changing UI strings:

wp i18n make-pot . languages/lazyblog-translations.pot --slug=lazyblog-translations

Security

• Public frontend clicks use signed, short-lived post/language requests.
• Provider keys stay server-side in WordPress options or constants.
• Browser code never receives OpenAI, DeepSeek, or LazyBlog bearer tokens.
• Do not commit .env, exported private posts, API keys, application passwords, or deployment logs.

Links

• LazyingArt LLC: https://lazying.art
• Live blog: https://blog.lazying.art
• Plugin source: https://github.com/lazyingart/lazyblog-translations
• LazyBlog workflow source: https://github.com/lachlanchen/LazyBlog
• Maintainer: https://github.com/lachlanchen

Support

Donate	PayPal	Stripe

Release Notes

0.4.17

• Preserves literal backslashes in translated code blocks when WordPress stores translation post meta.

0.4.16

• Gives every reviewed language route its own canonical URL and publishes reciprocal hreflang alternates, with the source edition as x-default.

0.4.15

• Purges WordPress object and page caches after operator-managed translation updates, deletions, and source-language changes so reviewed content appears immediately.

0.4.14

• Uses the reviewed translation title in the browser and search-result document title instead of inheriting the source-language title.

0.4.13

• Preserves the originating campaign on the exact LKT sample-report path as well as the fit-check path, while retaining the same four-field validation and first-party scope.

0.4.12

• Preserves the originating campaign on exact LKT fit-check links while rejecting arbitrary query values and leaving third-party links untouched.

0.4.11

• Adds translation-aware search descriptions and Open Graph/X card metadata for single posts, while yielding to common dedicated SEO plugins.

0.4.10

• Clears stale job error text when a retry later succeeds or returns to an active queued/running state.

0.4.9

• Makes on-demand translation polling state-aware so existing jobs no longer consume the new-translation start quota.
• Allows concurrent translation starts across different languages while still rate-limiting first-time job starts per IP and post/language.
• Marks stale queued/running LazyBlog jobs as failed after 20 minutes so clicking the language again can rerun the translation.

0.4.8

• Lowers the declared PHP requirement to 7.4, matching the plugin code and the live WordPress host.

0.4.7

• Adds WordPress i18n loading and a translation template.
• Adds localized README starters.
• Adds the LazyingArt banner and donation panel.
• Adds a plugin-repo bootstrap script for Codex local API setup.
• Adds direct GitHub setup links in WordPress settings.

0.4.6

• Adds provider switching between Codex/LazyBlog local API, OpenAI direct API, and DeepSeek direct API.
• Adds direct provider settings for endpoints, API keys, and models.
• Documents local API installation for Codex users.

0.4.5

• Adds LazyingArt LLC plugin metadata and a fixed Update URI.
• Adds a guarded self-migration endpoint for moving accidental installs from a conflicting plugin slug into lazyblog-translations/lazyblog-translations.php.