Install on WordPress
On this page
The plugin copies your published translation files to your own WordPress site. Visitors' browsers load them from your domain first. If our servers or the CDNs cannot be reached, your copy keeps working.
Before you start#
- WordPress 6.4 or newer and PHP 7.4 or newer.
- Self-hosted WordPress, or a WordPress.com paid plan. WordPress.com says plugins can be installed on its Personal, Premium, Business and Commerce plans, and that free sites must upgrade first (checked 2026-10-29). Accounts from before a plan change may differ: verify.
- A theme that calls
wp_head(). Plugins print their head output through it, and a theme without it will not load the script tag. - Your site key, your public signing key and the address where your translation files are published. All three are public values. The dashboard shows them on the site's Install page.
Download the plugin file from your site's Install page in the dashboard. It is not in the WordPress.org directory yet: OPEN.
Steps#
- Upload the plugin folder to
/wp-content/plugins/, or install it from the Plugins screen once it is distributed. Activate it. The LgTranslate screen opens by itself. - Press Connect to my LgTranslate account, sign in and come back. The site key, public key and file address are filled in, downloads are allowed and the first download starts. (This needs the connect page of the service, which is not live yet: OPEN. Until then use step 3.)
- Or open Settings > LgTranslate, then "Enter the keys by hand instead". Enter the site key, the public key and the files address. Tick the permission box and press Sync now. The plugin downloads the manifest and checks its signature against your public key, then each language file against its checksum.
- Press Check my install. It lists in plain words what works and what to fix: keys, permission, last download, the copy on your site, whether the script really appears on your home page, the switcher and permalinks. It changes nothing.
- The Translated pages table shows each language, the number of translated texts, its address (for example
/fr/) and whether the file is on your site. - The floating language switcher appears on its own. To place it yourself use the block, a widget, the shortcode
[resilientlang_switcher]or a menu item. - Choose how often to sync: hourly, twice a day or daily. A failed download never removes the copy you already have.
Disconnect removes the keys and the permission; downloaded translations stay.
Language addresses and hreflang#
The plugin includes a part for language addresses (/fr/), hreflang tags, canonical tags and a sitemap of translated pages. It has its own tests. It has not yet been run inside a real WordPress together with the core part: OPEN. See hreflang.
What is sent where#
Syncing is an ordinary secure request for public files. The file host sees your server's address and the plugin's name. It does not receive your content, your visitors' data or any secret key.
Licence key#
The WordPress.org directory rules#
WordPress.org's plugin guidelines allow a service the plugin exists for, if the readme documents it, links its terms and privacy policy, and the user opts in. They do not allow outside scripts unrelated to a service, or third-party CDNs other than for fonts (summary of the guidelines; wording to be checked by a person: verify). Whether a loader served from our delivery address fits is OPEN. Bundling the loader in the plugin is the safest route.
The licensed build of the plugin asks for a licence key on the same settings area. See Licence keys. Whether the free build is accepted by the WordPress.org directory is OPEN.
Uninstall#
Deleting the plugin keeps the downloaded files unless you tick "delete on uninstall". The script that applies them is no longer added to your pages. Your pages show the original language until you add the script tag.
Something wrong? See Troubleshooting.