# VI Translate

> I wrote the VI Translate plugin: it translates a WordPress site via Claude API together with the free Polylang, keeps consistent terms and the style of each language, and notices on its own where a translation has fallen behind the original. The first site to get it was V&I Experts, a center for legalizing foreigners in Poland: from Ukrainian into Polish, English and Russian.

Case study · WordPress plugin: https://vitaliihura.com/work/vi-translate

- Author: [Vitalii Hura](https://vitaliihura.com/), Full-Stack Developer
- Role: WordPress plugin developer
- Stack: PHP 8.2, WordPress, Polylang, ACF, Claude API, Composer, WP-CLI
- Timeline: September 2026
- Year: 2026
- Client: Own product

## The task

The V&I Experts site needed Polish, English and Russian versions. Translating every service, article, menu and settings screen by hand takes long, and after every edit to the original the versions drift apart. A yearly subscription to a paid plugin was not wanted. It needed translation that knows every field of the site, keeps terms consistent and notices changes on its own.

## What was built

- **The whole site translated.** Not only articles and services are translated but also block pages, site settings, menus, reviews, categories and button labels. Prices, images and order are copied from the original, and links inside the text lead to pages in the same language.
- **Glossary and language style.** Glossary terms are translated the same way across the whole site, even when the word appears in a different grammatical case. For each language it is described who the reader is, how to address them and how to write the names of agencies and documents.
- **Only changes are retranslated.** After the original is edited, the plugin marks the changed fields and retranslates only them. Fields an editor fixed by hand are not overwritten automatically.
- **Original and translation side by side.** A separate screen puts the original and translated fields side by side. Any field can be corrected, retranslated, or have an edit carried from one language into all the others.
- **Queue and budget.** Translation runs in the background, progress shows on any admin page, and an estimated cost appears before the start. A monthly limit stops the queue, when the service is overloaded the queue waits and resumes on its own, and every run and every error goes into the log.
- **A new language with no extra work.** A language added in Polylang appears by itself in the settings, post lists and editor. Developers get WP-CLI commands, and editors get a separate chapter of the manual.

## Result

The plugin runs on immigration-centr-poland.pl: the site is open in four languages, all pages, services, articles and settings are translated, and new edits flow into translation on their own. For now it is set up for a specific site and its fields and is not published in the WordPress directory. After the launch the partner asked to add auto-translation to two more projects, and the plugin is already set up for one of them, the UkrPrototype site.

## What the site looks like

- Translation overview: Progress for each language, a button to translate what's missing and a log of recent runs. ![Translation overview screen with per-language progress and a run log](https://vitaliihura.com/storage/cases/vi-translate-overview.jpg?v=1793979733)
- Original and translation: Article fields in Ukrainian and Polish sit side by side, and any of them can be edited or carried over to other languages. ![Article fields in Ukrainian and Polish side by side in the translation editor](https://vitaliihura.com/storage/cases/vi-translate-review.jpg?v=1793979733)
- Style per language: Each language has its own description of the reader, the form of address and the rules for agency names. ![Translation style settings for each language](https://vitaliihura.com/storage/cases/vi-translate-style.jpg?v=1793979733)
- Result on the site: A blog article on the Polish version of the site, translated by the plugin. ![Blog article on the Polish version of the V&I Experts site](https://vitaliihura.com/storage/cases/vi-translate-live.jpg?v=1793979733)

Build something similar: https://vitaliihura.com/quote
