Description
Hybrid AI Translator for TranslatePress adds a free automatic translation engine to TranslatePress. New in 1.3: your site is translated in the background, a small batch every few minutes, so visitors never wait for a translation API and pages stay fast.
Watch the full setup & translation walkthrough:
Plugin website and Pro version | Video Tutorial | Support
How it works
- TranslatePress records every piece of text on your pages.
- A background job (WP-Cron) picks up untranslated text every 5 minutes and translates it with Google Translate, a few strings at a time.
- Translations are saved in TranslatePress’s own tables. Visitors see them right away.
Prefer instant translation for brand-new pages? Turn on Translate on page visit and a page is also translated the first time someone opens it.
What you get for free
- Background translation (new): the whole site translates itself on a schedule, without slowing down any page.
- Auto Translate dashboard (new): see how many strings are waiting, when the next run happens, and progress for every language. A Translate now button runs a batch immediately.
- Translate on page visit (optional): the classic behaviour, for instant translation of new pages.
- Strings per run setting, so slow servers and Google rate limits stay happy.
- Google Translate (Unofficial) engine: fast, good quality, no API key.
- Configurable timeout and per-request character limit, a one-click Test button, and an optional translation log.
- Clean uninstall: every plugin option and scheduled job is removed.
Free vs Pro
Included free:
- Google Translate engine (no API key)
- Background translation + Auto Translate dashboard
- Translate on page visit (optional)
- Strings per run setting, Test button and translation log
Added in Pro:
- ChatGPT, Groq, OpenRouter and DeepSeek engines
- DeepL (Free or Pro API key)
- Main + fallback engine
- Tone and style control
- Glossary per language (CSV import)
- Edit saved translations (find and replace, undo)
- Export / import translations
Pro is optional and sold at shilpibuilder.com. The Free plugin is complete on its own.
Privacy
- This plugin only contacts the translation endpoint you’ve configured (by default:
translate.googleapis.com). It sends only the strings TranslatePress asks it to translate. - No telemetry, no tracking, no analytics, no calls to any other server.
- No personal data of your visitors is sent anywhere, only the page text that needs translating.
- See the FAQ for the full data flow.
External services
This plugin connects to one external service to function:
Google Translate (Unofficial): https://translate.googleapis.com/translate_a/single
* What is sent: the source text strings TranslatePress needs translated, plus the source/target language codes.
* When: only when TranslatePress requests a translation for a string that is not yet cached.
* Why: to receive the translated text.
* Provider: Google. Terms: https://policies.google.com/terms. Privacy: https://policies.google.com/privacy.
You can change the endpoint URL in the plugin settings if you self-host a compatible service.
Pro version (optional)
A separate Pro add-on adds AI translation providers (ChatGPT, Groq, OpenRouter, DeepSeek), DeepL, a main + fallback engine, Tone-and-Style control, a glossary, editing of stored translations, and JSON export/import. It is sold at shilpibuilder.com/plugins/hybrid-ai-translator. The Free plugin is complete on its own.
Installation
- Install and activate the TranslatePress Multilingual plugin first.
- From your WordPress admin, go to Plugins → Add New, search for “Hybrid AI Translator for TranslatePress”, and click Install Now → Activate. (Or upload the plugin ZIP via Plugins → Add New → Upload Plugin.)
- Go to Settings → Hybrid AI Translator and verify the Google provider is enabled. Click Test to confirm your server can reach the endpoint.
- Go to Settings → TranslatePress → Automatic Translation and select “Hybrid AI (Google + Pro AI providers)” as the translation engine, then enable Automatic Translation and Save.
- Open a few pages of your site in a translated language once, so TranslatePress records the text. Background translation then translates it automatically every few minutes. Watch progress (or press Translate now) under Settings → Hybrid AI Auto Translate.
FAQ
Will translation slow down my site?
No. By default nothing is translated while a visitor loads a page. Translation happens in the background (WP-Cron) a small batch at a time. If you turn on “Translate on page visit”, only the very first visit to a brand-new page can be slower.
How fast is the whole site translated?
The background job runs every 5 minutes and translates a batch each time (10 strings by default, up to 50). You can speed it up with the Translate now button on the Auto Translate tab.
My site has little traffic. Will background translation still run?
WP-Cron runs when someone visits the site or the admin. On very quiet sites you can press Translate now, or set up a real server cron for wp-cron.php.
Do I need an API key?
No. The Google Translate (Unofficial) provider does not require any API key.
Will Google rate-limit me?
The unofficial endpoint can rate-limit aggressive use. Because TranslatePress caches every translation in its own database, the endpoint is only called for genuinely new strings. For a typical small or medium site this is far below any rate-limit threshold. Background translation sends small batches and pauses automatically if Google rate-limits the server. For very large sites, the Pro add-on adds AI providers and DeepL as a fallback.
Where are translations stored?
In TranslatePress’s own database tables. This plugin does not store translations itself, it just hands them to TranslatePress.
Does this plugin send my visitors’ personal data anywhere?
No. Only the page text that needs translating is sent to the configured translation endpoint, and only when TranslatePress requests it. No visitor IPs, cookies, or other personal data are transmitted by this plugin.
What happens if I uninstall the plugin?
All plugin options (haitp_settings, haitp_log, haitp_translated_count) and the background job are removed from the database. Translations TranslatePress has cached in its own tables are not touched, TranslatePress manages those independently.
Is the source code available?
Yes, this plugin is GPLv2-or-later. The full source is in the plugin folder, and the development repository is linked from the plugin homepage.
Can I extend it with a custom provider?
Yes. Extend HAITP_Provider_Base, implement translate() and self_test(), and register your class via the haitp_registered_providers filter.
Screenshots
Changelog
1.3.0
- New: background translation. A WP-Cron job translates untranslated text every 5 minutes, so visitors never wait for the translation API.
- New: Auto Translate tab with waiting count, next run time, a Translate now button and progress per language.
- New: “Translate on page visit” option for instant translation of brand-new pages (pages are always translated on visit when background translation is off).
- New: “Strings per run” setting (5, 10, 20 or 50).
- Background runs pause automatically while Google is rate-limiting the server.
- Plugin website and Pro links moved to shilpibuilder.com.
- Settings and Auto Translate share one tab bar; quick links in the plugin list.
- Uninstall now also removes the scheduled job and the new options.
1.2.8
- Fixed Plugin Check warnings: text domain is now a string literal everywhere.
- Removed the duplicate “Tested up to” header from the main plugin file.
1.2.7
- New card-based settings dashboard (same design as Pro), with a clear Main engine selector.
- Added a Pro overview showing what Glossary, Edit Translations, Tools, DeepL and the fallback engine do.
- Updated Pro feature descriptions in the readme.
1.2.6
- Prevented slow or unavailable Google endpoints from blocking a page for up to roughly 90 seconds. The timeout now covers the complete fallback sequence and is capped at 15 seconds.
- Removed duplicate retries, one-second retry sleeps, the artificial delay, and a redundant database write after every translated string.
- A rate-limited endpoint is no longer retried, while alternate Google endpoints each get one chance inside the shared timeout; the 5-minute cool-down starts only if none succeeds.
- Logging is now disabled by default on new installations and can be enabled when diagnostic details are needed.
- Fixed the internal plugin version constant so admin assets and the settings screen report the installed version correctly.
1.2.5
- Fixed the Google (Unofficial) provider constantly failing with “HTTP 429 from Google” on shared hosting. Requests now send a normal browser User-Agent instead of a plugin-identifying one, which was the main reason Google rate-limited them.
- Added a short retry with back-off, plus automatic fallback to alternate Google endpoints (translate.google.com and clients5.google.com) before the request is treated as failed.
- After a genuine rate-limit, the provider enters a 5-minute cool-down so translation does not keep hammering a blocked endpoint, and the provider chain moves on immediately.
- The rate-limit error message now explains the cause and what to do, instead of showing only an HTTP status code.
- The “Test Google” button always runs a live test, ignoring any active cool-down.
1.2.4
- Tested up to WordPress 7.1.
- Refreshed the Pro panel on the settings screen: the feature list is now grouped into three columns and covers the terminology glossary, translation editing with find & replace, and the backup / migration tools.
1.2.3
- Fixed a PHP notice (“Undefined variable $opt”) on the settings page caused by an incorrect variable passed to the Pro section action hooks.
1.2.2
- The “Watch the setup & translation video” link in the Pro upgrade panel now points to the Pro version overview video.
- Removed the redundant perks line from the Pro upgrade panel for a cleaner layout.
1.2.1
- Added a “Watch the setup & translation video” link on the settings page so users can follow a YouTube walkthrough to install and configure the plugin.
- Updated the Pro upgrade panel to list the “Delete ALL translations” tool (clear every cached translation in one click and re-translate fresh).
1.2.0
- Renamed plugin to “Hybrid AI Translator for TranslatePress”.
- New PHP prefix
HAITP_and text domainhybrid-ai-translator-for-translatepress. - Added
LICENSE.txt,uninstall.php, andload_plugin_textdomain()for full WordPress.org compliance. - Activation safety: blocks Free activation when the Pro add-on is already active, so the two cannot collide.
1.1.0
- Cleaned up provider list and settings UI.
1.0.0
- Initial release.


