Title: PerfLocale
Author: аlex
Published: <strong>Август 31, 2026-ж.</strong>
Last modified: Октябрь 13, 2026-ж.

---

Плагиндерди издөө

![](https://ps.w.org/perflocale/assets/banner-772x250.png?rev=3743062)

![](https://ps.w.org/perflocale/assets/icon.svg?rev=3674295)

# PerfLocale

 Автору [аlex](https://profiles.wordpress.org/alexgeorgiev/)

[Жүктөө](https://downloads.wordpress.org/plugin/perflocale.1.0.7.1.1.zip)

[Көрүү](https://ky.wordpress.org/plugins/perflocale/?preview=1)

 * [Кенен маалымат](https://ky.wordpress.org/plugins/perflocale/#description)
 * [Сын-пикирлер](https://ky.wordpress.org/plugins/perflocale/#reviews)
 *  [Орнотуу](https://ky.wordpress.org/plugins/perflocale/#installation)
 * [Development](https://ky.wordpress.org/plugins/perflocale/#developers)

 [Колдоо](https://wordpress.org/support/plugin/perflocale/)

## Сүрөттөө

PerfLocale is a **performance-first multilingual plugin** for WordPress. A 3-layer
cache, batch-preloaded queries, and conditional hook registration keep its own work
per page small.

#### What you get

 * **Content translation** – posts, pages, any custom post type, taxonomies, and
   URL slugs, with translation-status tracking. Synced patterns, block-theme navigation
   menus, and block-theme templates and template parts are translatable too (opt-
   in)
 * **URL routing** – subdirectory (`/en/`), subdomain (`en.example.com`), per-domain,
   or query-parameter (`?lang=en`) modes; auto-detect from URL, cookie, browser,
   or an edge/CDN hint
 * **String translation** – gettext strings from any plugin or theme, file-based(`.
   l10n.php`) or database-mode, with full CLDR plural rules (Arabic 6 forms, Russian
   3) and context support. The site title and tagline appear there too
 * **Language switcher** – block, shortcode, widget, menu, admin-bar, and template
   tags with full ARIA listbox accessibility
 * **SEO** – hreflang (HTML + HTTP) and sitemap alternates; integrates with Yoast,
   Rank Math, AIOSEO, SEOPress, The SEO Framework, and Slim SEO
 * **Machine translation** – DeepL, Google, Microsoft, LibreTranslate, a custom 
   agency endpoint, and the WordPress 7.0 AI Client, with monthly usage caps
 * **Translator role** – a role for translation staff: it can create and edit translations
   and use machine translation. Like WordPress’s editing roles, it can also edit
   any post or page and upload media, but it cannot publish, delete or change settings.
 * **E-commerce** – WooCommerce product/variation/attribute translation, multi-currency(
   rates supplied by your own provider hook), inventory sync, localized order emails
 * **Reliability** – circuit breakers around every external dependency, token-guarded
   atomic locks, self-healing background jobs, and Site Health diagnostics

#### Modern SEO & UX

Translation-aware features generic SEO plugins can’t provide: Content-Language HTTP
header, `data-nosnippet` guard for fallback pages, and opt-in Speculation Rules 
prerender and View Transitions for switching between languages. Auto-detects and
integrates with 20+ plugins and themes, including WooCommerce, Elementor, ACF, Meta
Box, Pods, all major SEO plugins, Gravity Forms, and the Blocksy, Kadence, and Neve
themes.

#### For developers

200+ action/filter hooks, a full REST API, WP-CLI commands, and a documented addon
system. A PHP helper API lets you translate a string or render a block of markup
in any language from your own code. Classes and methods marked @api are semver-stable
across 1.x. Multisite-ready. Full docs at **[perflocale.com/docs](https://perflocale.com/docs/)**.

**Try it without installing anything.** Open a throwaway WordPress site in your 
browser with PerfLocale already active: [Open PerfLocale in WordPress Playground](https://playground.wordpress.net/?blueprint-url=https://perflocale.com/blueprint.json)

#### Where to go next

 * **Set-up guide** – a fresh install to a translated post with a working switcher:
   [perflocale.com/docs/getting-started](https://perflocale.com/docs/getting-started/)
 * **Switching from another plugin** – importers for WPML, Polylang and TranslatePress:
   [perflocale.com/docs/migration](https://perflocale.com/docs/migration/)
 * **How it compares** – PerfLocale against WPML, Polylang and TranslatePress: [perflocale.com/compare](https://perflocale.com/compare/)
 * **WooCommerce** – products, variations, currencies, stock and order emails: [perflocale.com/docs/woocommerce](https://perflocale.com/docs/woocommerce/)
 * **Multisite** – activation, per-site languages and background jobs across a network:
   [perflocale.com/docs/multisite](https://perflocale.com/docs/multisite/)
 * **Something not working?** – symptom-first troubleshooting: [perflocale.com/docs/troubleshooting](https://perflocale.com/docs/troubleshooting/)
 * **Hooks reference** – every action and filter: [perflocale.com/docs/hooks](https://perflocale.com/docs/hooks/)
 * **REST API and WP-CLI** – [perflocale.com/docs/rest-api](https://perflocale.com/docs/rest-api/)
   and [perflocale.com/docs/wp-cli](https://perflocale.com/docs/wp-cli/)
 * **Source code** – [github.com/perflocale/perflocale](https://github.com/perflocale/perflocale)

### Privacy

PerfLocale is privacy-first by default. No tracking, no analytics, no visitor fingerprinting.

 * **Cookie:** one cookie, `perflocale_lang`, stores only the active language slug.`
   HttpOnly`, `Secure` on HTTPS, `SameSite=Lax`, 365-day default lifetime (filterable
   via `perflocale/cookie_lifetime`). It can be turned off (see “Cookieless mode”
   below) – language routing is URL-based and works without it.
 * **Visitor IP:** never logged or stored. The optional GeoIP-redirect feature (
   disabled by default) ships with no lookup provider and no endpoint, so out of
   the box it sends the IP nowhere. If you wire a source yourself through the `perflocale/
   geo/lookup_country` or `perflocale/geo/providers` filter, the IP is passed to
   that source once per first visit to resolve a country code; the country code 
   is then cached server-side (24 hours by default) under a salted, non-reversible
   key – an HMAC-SHA256, keyed with the site’s auth salt, of the IP after `wp_privacy_anonymize_ip()`
   has zeroed the host bits – never the raw IP or any value reversible to it.
 * **WordPress Privacy API integration:** Tools  Export Personal Data and Tools  
   Erase Personal Data both work. The eraser zeroes `created_by` on the background
   jobs the data subject dispatched and deletes their per-user UI-state meta – returning`
   items_removed`/`items_retained` counts. The same flow runs on the admin `delete_user`
   path. Full detail in the docs.
 * **Consent gating:** the `perflocale/privacy/consent_given` filter lets any consent-
   management plugin (Cookiebot, Complianz, OneTrust, etc.) hold back PerfLocale
   until a visitor has consented. When the filter returns false, the `perflocale_lang`
   cookie is not set, and the GeoIP and browser-language redirects do not run (no
   outbound request is made).
 * **Cookieless mode:** PerfLocale  Settings  URL & Routing  “Language Cookie” turns
   the `perflocale_lang` cookie off – no consent-management plugin required. Code
   on your site can still decide per request through the `perflocale/language_cookie/
   enabled` filter. URL-based language routing keeps working; you lose “remember
   my language” on non-prefixed URLs. On a WooCommerce store you also lose the cart
   and checkout language: the block cart/checkout posts to the non-prefixed Store
   API URLs, and the language stamped on a new order is read from that same cookie,
   so both fall back to the site’s default language. The automatic first-visit redirects(
   browser language, GeoIP, edge hint) do not run in cookieless mode unless code
   hooks that filter: without the cookie they would redirect the same visitor again
   on every default-language page.
 * **Suggested privacy-policy text:** auto-registered via `wp_add_privacy_policy_content()`.
   The sections shown adapt to which features are enabled – GeoIP wording only appears
   if GeoIP is on, MT wording only appears if MT is on.

Full technical detail: [perflocale.com/docs/privacy](https://perflocale.com/docs/privacy/)

### External Services

PerfLocale can optionally connect to external services for machine translation. 
All external service calls are **disabled by default** and require explicit user
configuration (entering an API key and enabling the feature in settings). No data
is sent to any external service without your action. The hosted providers below 
are contacted over HTTPS; for self-hosted or user-configured endpoints (LibreTranslate,
agency, webhooks) use an HTTPS URL.

The GeoIP-redirect and WooCommerce exchange-rate features ship with **no** provider
and contact **no** service on their own: they call nothing unless you wire a source
yourself through the `perflocale/geo/lookup_country` / `perflocale/geo/providers`
and `perflocale/woocommerce/exchange_rates_fetched` / `perflocale/woocommerce/exchange_rate_providers`
filters. If you connect one, disclosing that service is your responsibility as the
site owner.

API keys for the providers below can be supplied via an environment variable, a `
wp-config.php` constant, or the admin Settings field (see the “Can I keep API keys
out of the database?” FAQ).

#### Machine Translation

When you enable machine translation and configure an API key in PerfLocale  Settings
Addons  Machine Translation, the plugin sends the text you ask it to translate to
the selected provider, together with source/target language codes and your API key.
That text is: post titles, content and excerpts; taxonomy term names and descriptions;
interface strings listed on the Strings screen (which can include strings registered
by other plugins and themes) when you use its machine-translation controls; and,
when meta translation is enabled, registered meta values such as SEO titles and 
descriptions or custom text fields. It is sent when you click “Machine Translate”
or use the block editor’s translate actions, run a bulk or site-wide translation,
translate via WP-CLI or the REST API, or enable auto-translate on publish or on 
create. Each provider below receives exactly that data, and only for the actions
just listed. The provider API additionally defines a connection-test call that sends
your API key and, for some providers, a fixed test word – never your content – so
an add-on can verify credentials; no screen, WP-CLI command or REST route in PerfLocale
itself invokes it.

 * **DeepL** – api.deepl.com / api-free.deepl.com. Commercial neural-translation
   API (free and paid tiers). Receives the text, language codes and API key described
   above.
    [Terms of Service](https://www.deepl.com/en/pro-license) | [Privacy Policy](https://www.deepl.com/en/privacy)
 * **Google Cloud Translation** – translation.googleapis.com. Google’s paid cloud
   translation API. Receives the text, language codes and API key described above.
   
   [Terms of Service](https://cloud.google.com/terms) | [Privacy Policy](https://policies.google.com/privacy)
 * **Microsoft Azure Translator** – api.cognitive.microsofttranslator.com. Microsoft’s
   paid cloud translation API. Receives the text, language codes and API key described
   above.
    [Terms of Service](https://azure.microsoft.com/en-us/support/legal/) 
   | [Privacy Policy](https://www.microsoft.com/en-us/privacy/privacystatement)
 * **LibreTranslate** – self-hosted or user-configured URL. Open-source translation
   server you host yourself or point at an instance you trust; the plugin calls 
   no hard-coded LibreTranslate endpoint. Receives the text and language codes described
   above at the URL you configure. Terms of service and privacy policy are governed
   by the LibreTranslate instance you configure; the AGPL-3.0 linked below is the
   governing license of the software itself.
    [Terms (AGPL-3.0 License)](https://github.com/LibreTranslate/LibreTranslate/blob/main/LICENSE)
   | [Source Code](https://github.com/LibreTranslate/LibreTranslate)
 * **WordPress AI Client** – no hard-coded endpoint; delegated to WordPress core.
   When you select the “WordPress AI Client” provider on WordPress 7.0+ (or a host
   that ships the AI Client feature plugin), PerfLocale builds a short translation
   prompt (the text described above plus source/target language codes) and hands
   it to WordPress core’s `wp_ai_client_prompt()` function. PerfLocale itself makes
   no outbound HTTP request for this provider: WordPress core (and whichever AI 
   provider you connected under Settings  Connectors) performs the network call.
   The data sent, the destination, and the governing Terms of Service / Privacy 
   Policy are therefore those of the AI provider you configured in WordPress core,
   only for the actions listed above.
    [WordPress AI Building Blocks](https://make.wordpress.org/ai/2025/07/17/ai-building-blocks/)

#### External Translation Agency

When you configure an external agency URL in PerfLocale  Settings  Addons  Machine
Translation, the plugin sends post content to the configured endpoint for human 
or agency translation:

 * **Custom Agency Endpoint** – user-configured URL. A webhook endpoint you configure(
   use an HTTPS URL) to send post content to a human translator or translation agency
   for offline processing; the destination is entirely under your control and the
   plugin calls no hard-coded endpoint. The plugin sends post text, source/target
   language codes, and a unique request ID, only when you submit a translation request;
   the agency must return the translated text in the immediate response. Terms of
   service and privacy policy are governed by the agency whose endpoint you choose
   to configure; review their public policies before sending post content.

#### Webhooks

When you register webhooks via the PerfLocale REST API, the plugin sends event notifications
to your configured webhook URLs when translations are created, updated, or content
changes:

(loopback, private-network and credential-bearing destinations, and ports outside
WordPress’s own allowlist of 80, 443 and 8080, are rejected at validation time, 
and the refusal names the rule that was broken; on multisite, registering one requires
network-administrator permissions) Endpoints you register via the PerfLocale REST
API to receive translation-lifecycle notifications (use HTTPS URLs); the destinations
are entirely under your control and the plugin calls no hard-coded URL. The plugin
POSTs the event type, translation data (post IDs, language codes, status), and a
timestamp whenever a translation is created, updated, or otherwise changes, and 
signs each payload with HMAC-SHA256 when a shared secret is configured. Terms of
service and privacy policy are governed by whatever destination you register; review
the operator’s public policies before registering the URL.

PerfLocale can also publish a read-only public REST endpoint for edge runtimes (`/
wp-json/perflocale/v1/config`). It is served by your own site, makes no outbound
third-party request and sends no data anywhere – see the “Does PerfLocale expose
anything to edge workers?” FAQ for the full description.

## Скриншоттор

[⌊Front-end language switcher - block, shortcode, or template tag rendered as an
accessible ARIA listbox, plus an optional append to classic theme menus⌉⌊Front-end
language switcher - block, shortcode, or template tag rendered as an accessible 
ARIA listbox, plus an optional append to classic theme menus⌉[

Front-end language switcher – block, shortcode, or template tag rendered as an accessible
ARIA listbox, plus an optional append to classic theme menus

[⌊WooCommerce cart in German - translated product titles, attributes, and currency⌉⌊
WooCommerce cart in German - translated product titles, attributes, and currency⌉[

WooCommerce cart in German – translated product titles, attributes, and currency

[⌊PerfLocale dashboard - per-language translation progress for every post type, 
with draft and outdated counts⌉⌊PerfLocale dashboard - per-language translation 
progress for every post type, with draft and outdated counts⌉[

PerfLocale dashboard – per-language translation progress for every post type, with
draft and outdated counts

[⌊Settings - Export & Import: bring existing translations across from WPML, Polylang,
or TranslatePress as a background job that is safe to re-run⌉⌊Settings - Export &
Import: bring existing translations across from WPML, Polylang, or TranslatePress
as a background job that is safe to re-run⌉[

Settings – Export & Import: bring existing translations across from WPML, Polylang,
or TranslatePress as a background job that is safe to re-run

[⌊Languages screen - add languages, set the default, and mark text direction⌉⌊Languages
screen - add languages, set the default, and mark text direction⌉[

Languages screen – add languages, set the default, and mark text direction

[⌊Settings - Performance: string-translation mode (files or database), object cache,
and slug preloading⌉⌊Settings - Performance: string-translation mode (files or database),
object cache, and slug preloading⌉[

Settings – Performance: string-translation mode (files or database), object cache,
and slug preloading

[⌊Strings screen - translate gettext strings from any plugin or theme, with PO export
and import⌉⌊Strings screen - translate gettext strings from any plugin or theme,
with PO export and import⌉[

Strings screen – translate gettext strings from any plugin or theme, with PO export
and import

[⌊Settings - URL & Routing: missing-translation action and per-language fallback
chains⌉⌊Settings - URL & Routing: missing-translation action and per-language fallback
chains⌉[

Settings – URL & Routing: missing-translation action and per-language fallback chains

[⌊Jobs - bulk and whole-site translation runs in the background: chunked, resumable,
with automatic retries and per-blog status⌉⌊Jobs - bulk and whole-site translation
runs in the background: chunked, resumable, with automatic retries and per-blog 
status⌉[

Jobs – bulk and whole-site translation runs in the background: chunked, resumable,
with automatic retries and per-blog status

## Блоктор

This plugin provides 2 blocks.

 *   Show If Language Wrap inner content so it only renders when the visitor's language
   matches the selected set.
 *   Language Switcher Display a language switcher for visitors to change languages.

## Орнотуу

 1. Go to **Plugins  Add New Plugin**, search for **PerfLocale**, then click **Install
    Now** and **Activate**.
 2. Go to **PerfLocale  Languages**, add your languages, and click **Set as Default**
    on your site’s main language.
 3. Go to **PerfLocale  Settings  URL & Routing** and choose your language URLs: `/
    de/` (the default), `de.example.com`, one domain per language, or `?lang=de`.
 4. Translate: open a post, page or category, and in its **Translations** panel click**
    + Create** beside a language. Then edit the new translation in the normal editor.
 5. Add a language switcher: the **Language Switcher** block or widget, the `[perflocale_switcher]`
    shortcode, or a menu under **PerfLocale  Settings  Language Switcher**.
 6. Optional: under **PerfLocale  Settings  SEO**, select your SEO plugin. Hreflang
    tags are on by default.
 7. Optional: for machine translation, enable **Machine Translation** under **PerfLocale
    Addons**, then choose a provider under **PerfLocale  Settings  Addons  Machine 
    Translation** and add its API key (DeepL, Google or Microsoft). On WordPress 7.0
    or newer you can choose the **WordPress AI Client** instead and connect an AI provider
    under **Settings  Connectors**.
 8. Open **Tools  Site Health**. It tells you if your server needs anything.

**Good to know**

 * Permalinks: any setting except “Plain” is recommended. Plain also works (URLs
   become `/de/?p=123`). If your server does not pass unknown paths to WordPress,
   use the query parameter URL mode (`?lang=de`).
 * nginx and Caddy ignore `.htaccess`, so add one rule that blocks direct access
   to exports: see [Production tuning](https://perflocale.com/docs/production-tuning/#export-directory).
   Site Health shows whether you need it.
 * API keys can also come from environment variables or `wp-config.php` constants,
   such as `PERFLOCALE_DEEPL_API_KEY`. See [API keys](https://perflocale.com/docs/api-key-constants/).

## FAQ.KG

### Does PerfLocale slow down my site?

Very little – performance is a core design goal. The plugin keeps the work it does
on each page small, with three layers of caching to keep its own database work low.
Larger sites – many translated posts across many languages – benefit from running
a persistent object cache like Redis. PerfLocale is fully compatible with page-cache
plugins (WP Super Cache, W3 Total Cache, LiteSpeed Cache, etc.); cached pages already
include the translated output from the request that filled the cache. Real-world
page speed depends mostly on your theme, hosting, and other plugins.

### Does it work with WooCommerce?

Yes. PerfLocale includes a deep WooCommerce integration: translate products, variations,
categories, and attributes. Inventory (stock, SKU, GTIN, price, weight, dimensions)
stays in sync across language variants whenever WooCommerce saves a product, whether
the change comes from an order, the product editor, Quick Edit, the REST API, an
import, or another plugin. Multi-currency support, with exchange rates supplied 
by a provider your site registers via filter. Order emails are sent in the customer’s
language. The mini-cart, cart, and checkout all display correctly in every language.

### Does it work with page builders?

Yes. PerfLocale integrates with Elementor, Beaver Builder, Bricks Builder, Oxygen
Classic, and Oxygen 6.0. Each builder’s content is registered as translatable meta,
and dedicated Language Switcher widgets/elements are provided for Elementor, Beaver
Builder, and Bricks – in Oxygen (Classic or 6.0) use the `[perflocale_switcher]`
shortcode in a Code Block or Shortcode element.

### Does it translate block-theme templates and template parts?

Yes. It is off by default. Switch on **Full Site Editing** under PerfLocale  Settings
Translation and the block templates and template parts you edit in the Site Editor–
header, footer, 404, archive layouts – become translatable like any other content,
along with the patterns, navigation labels and post content embedded in them.

A translation only takes effect once you publish it. WordPress renders an empty 
region for a template part it cannot resolve, so a half-finished header would leave
a blank strip across the site; until the translation is published, visitors keep
seeing the original. The Site Editor’s own Translations panel shows which languages
exist and labels anything still in draft.

### How do I translate patterns and block-theme menus?

It depends on which kind of pattern you used, and the two look identical in the 
editor.

A pattern you insert from the inserter is **copied into the page**, so its text 
is simply part of that page – translate the page under PerfLocale  Translations 
and the text comes with it. (This is also why the theme’s pattern strings on the
Strings screen don’t apply to it: those are used when the theme renders the pattern
file itself, while the copy in your page is plain HTML.)

A **synced** pattern is stored once and the page only holds a reference to it, so
there is nothing in the page to translate. Enable “Patterns” under _Advanced content
types_ at PerfLocale  Settings  Translation, then translate each pattern like any
other post; PerfLocale serves the right one per language, including patterns nested
inside a Group.

Block-theme menus work the same way. Menu link addresses are already translated 
without any setting; enable “Navigation Menus” in the same place to translate the
visible labels too. In both cases, if a translation is missing or still a draft 
the original renders – never a blank space.

### How do I translate the site title and tagline?

Go to PerfLocale  Strings and translate them like any other string – they are listed
there as “Site Title” and “Tagline”. There is nothing to switch on, and no scan 
to run: they are registered automatically when the plugin is updated or activated.

Your original title and tagline are never overwritten. PerfLocale serves the translated
text on the front end only, and refuses any attempt to write a translated value 
back over the original.

### Can I migrate from WPML, Polylang, or TranslatePress?

Yes. PerfLocale includes built-in migration tools for all three plugins. PerfLocale
refuses to run while WPML, Polylang or TranslatePress is active, so deactivate the
old plugin first – its data stays in the database – then go to PerfLocale  Settings
Export & Import and use the Migration section. Migrations run in batches and leave
the old plugin’s data untouched. An import that stops part-way can be run again:
translations already imported are reused, not duplicated. Back up your database 
before a large import.

### Does it support RTL languages?

Yes. PerfLocale detects the text direction from the language configuration and sets
the correct `dir="rtl"` attribute on the HTML element. The language switcher and
admin UI work correctly with RTL languages like Arabic and Hebrew.

### Is it compatible with caching plugins?

Yes. PerfLocale works with all major caching plugins (WP Super Cache, W3 Total Cache,
LiteSpeed Cache, WP Rocket). Each language version has its own URL, so page caches
naturally separate content by language. Any response whose language was decided 
by something other than the URL – a GeoIP or browser-language redirect, a returning
visitor’s language cookie – is automatically marked uncacheable (via WordPress’ `
nocache_headers()`), so one visitor’s language can never be cached and served to
everyone. On an edge or server cache (Varnish, nginx fastcgi_cache) make sure Cache-
Control is honoured or those responses are excluded. Note that enabling GeoIP / 
browser redirection makes default-language entry URLs uncacheable by design – a 
page cache serving them from cache would skip the redirect entirely; if you need
both, use the bundled edge worker (assets/js/edge-helper.js) to route at the CDN
instead. In cookieless mode those redirects do not run, so the default-language 
entry URLs stay cacheable.

### Can I use it on multisite?

Yes. PerfLocale is multisite-compatible. Each site in the network has its own languages
and translations. Static caches are properly scoped and reset on blog switches.

### Can I keep API keys out of the database?

Yes. PerfLocale resolves every machine-translation API key from three sources in
priority order: environment variable  `wp-config.php` constant  database setting(
whichever has a non-empty value first wins). Set `PERFLOCALE_DEEPL_API_KEY`, `PERFLOCALE_GOOGLE_API_KEY`,`
PERFLOCALE_MICROSOFT_API_KEY`, `PERFLOCALE_LIBRE_API_KEY`, `PERFLOCALE_LIBRE_URL`,`
PERFLOCALE_AGENCY_URL` or `PERFLOCALE_AGENCY_API_KEY` in your container env or `
wp-config.php` and the admin-side fields become read-only, showing which environment
variable or `wp-config.php` constant supplies the value. Database backups, exports,
and SQL dumps then never contain the secret.

### What happens to my translations if I uninstall the plugin?

By default nothing is lost: uninstalling removes the plugin’s roles, capabilities,
and scheduled tasks, but keeps all translations, languages, and settings in the 
database so a later re-install picks up exactly where you left off. If you want 
a complete removal instead, enable “Delete all plugin data when uninstalling” in
PerfLocale  Settings  Advanced before uninstalling – then every plugin table and
option is deleted. Your posts and pages (including translated ones) are always preserved
as normal WordPress content.

On a multisite network each site’s own choice is applied to that site, and your 
users’ PerfLocale screen preferences, which every site shares, are removed only 
if no site chose to keep its data. Deleting the plugin from a very large network
can run out of PHP execution time before every site is done: PerfLocale stops cleanly
between sites, logs how many were purged and how many remain, and records where 
it stopped. Re-install the plugin and delete it again without activating it and 
the next pass carries on from there; from WP-CLI, `wp plugin uninstall perflocale`
has no time limit and finishes the network in one pass. If a site fails, the log
names it and the same steps retry it once the cause is fixed.

### Does PerfLocale expose anything to edge workers?

When you enable Edge Worker Integration (PerfLocale  Settings  Advanced), the plugin
publishes a single public REST endpoint that edge runtimes (Cloudflare Workers, 
Vercel Edge, Netlify Edge, AWS Lambda@Edge) can read to pre-route visitors before
the request ever hits PHP:

 * `GET /wp-json/perflocale/v1/config` – returns the minimum routing + language 
   metadata an edge worker needs: active language slugs and locales, URL mode (subdirectory/
   subdomain / domain / query), URL prefix type, default language, hide-default-
   prefix flag, excluded paths, detection order, the edge-hint header name (`X-PerfLocale-
   Lang`) and cookie name. Response includes `Cache-Control: public, max-age=300,
   s-maxage=3600, stale-while-revalidate=86400` plus an `ETag` so edges and browsers
   can revalidate cheaply with `If-None-Match` (304 on hit). When code hooks the
   permission filter described below, or the caller is logged in, the response is
   sent with `Cache-Control: private, no-store` instead.

**The response NEVER contains:** machine-translation API keys, provider tokens, 
user data, internal post or term IDs, or any data that is not already observable
from the rendered site (hreflang tags, language switcher, URL prefixes). That non-
sensitive invariant is what justifies the public default. If you extend the payload
via the `perflocale/api/config` filter, your additions must preserve this invariant.

Public by default + filter-gated for restriction: site owners who want to restrict
access (private staging sites, IP allowlists, Application-Password authentication,
mTLS at a reverse proxy) hook the `perflocale/edge_worker/config_permission_callback`
filter to return `false` or a `WP_Error` for unauthorised requests. Example:

    ```
    add_filter( 'perflocale/edge_worker/config_permission_callback', fn () => current_user_can( 'manage_options' ) );
    ```

The plugin does not invent its own bearer-token or custom-header authentication 
scheme. Use WordPress’ built-in primitives (Application Passwords for machine-to-
machine auth, cookie + nonce for browser sessions, or a third-party JWT/OAuth plugin)
and gate via this filter – that way your edge-worker auth composes with the rest
of your site’s WP-REST authentication setup.

## Сын-пикирлер

![](https://secure.gravatar.com/avatar/b3354f1fb66bf675993e37ec06d05a560c70211d79a49862cabaed128eb11d91?
s=60&d=retro&r=g)

### 󠀁[The one I have been looking for.](https://wordpress.org/support/topic/the-one-i-have-been-looking-for-2/)󠁿

 [FREEZhao](https://profiles.wordpress.org/freezhao/) Сентябрь 9, 2026-ж. 1 reply

This plugin is growing, it will be the superstar later.

 [ Read all 1 review ](https://wordpress.org/support/plugin/perflocale/reviews/)

## Contributors & Developers

“PerfLocale” is open source software. The following people have contributed to this
plugin.

Мүчөлөрү

 *   [ аlex ](https://profiles.wordpress.org/alexgeorgiev/)

[Translate “PerfLocale” into your language.](https://translate.wordpress.org/projects/wp-plugins/perflocale)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/perflocale/), check
out the [SVN repository](https://plugins.svn.wordpress.org/perflocale/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/perflocale/) by 
[RSS](https://plugins.trac.wordpress.org/log/perflocale/?limit=100&mode=stop_on_copy&format=rss).

## Өзгөртүүлөр

Full release notes for every version: [perflocale.com/changelog](https://perflocale.com/changelog/)

#### 1.0.7.1.1

 * Block editor: saving a post or page no longer ends in an error, and the “View
   Post” link appears again after publishing.

#### 1.0.7.1

 * Security hardening.
 * Faster cart and checkout on stores whose language copies share stock.
 * Sync Fields: a change reaches only the translations the person saving may edit,
   and a translation no longer moves the original’s publish date.
 * Site Editor: create translations of menus, synced patterns, templates and template
   parts in the Translations panel; navigation overlays are translated (WordPress
   7.0+).
 * Site Health lists missing language packs, and the language switcher ships translated
   into 13 languages.
 * Many fixes for WooCommerce, hreflang, webhooks and caching. On WooCommerce older
   than 10.8, run Status  Tools  Regenerate product lookup tables once.

#### 1.0.7

 * Security hardening.
 * A language that still has content can no longer be deleted; the Languages screen
   shows what it still holds.
 * Merge imports no longer change this site’s settings, add-ons or roles.
 * ACF, Meta Box and SEO fields stay correct however a post is saved, including 
   nested and repeater fields.
 * WooCommerce: language copies share one stock in cart and checkout, and order 
   emails keep their language.
 * Bulk translation survives host time limits, plus many fixes for imports from 
   WPML, Polylang and TranslatePress.

#### 1.0.6

 * Security hardening and stricter permission checks.
 * Importing a file from another site asks you to confirm this site is a copy of
   it.
 * WooCommerce: a visitor’s first default-language page sets no cookie, so page 
   caches can store it.
 * Multisite: deleting the plugin works through large networks in batches.
 * Front-end pages, feeds, sitemaps and REST requests run fewer database queries.
 * Many fixes, including previews of draft translations, synced patterns and menus,
   and the WPForms builder.

## Мета

 *  Нуска **1.0.7.1.1**
 *  Акыркы жаңыртуу **1 күн мурун**
 *  Активдүү орнотуулар **Fewer than 10**
 *  WordPress нускасы ** 6.4 же андан жогору **
 *  Tested up to **7.1.3**
 *  PHP нускасы ** 8.1 же андан жогору **
 *  Тил
 * [English (US)](https://wordpress.org/plugins/perflocale/)
 * Тег:
 * [i18n](https://ky.wordpress.org/plugins/tags/i18n/)[language](https://ky.wordpress.org/plugins/tags/language/)
   [localization](https://ky.wordpress.org/plugins/tags/localization/)[multilingual](https://ky.wordpress.org/plugins/tags/multilingual/)
   [translation](https://ky.wordpress.org/plugins/tags/translation/)
 *  [Advanced View](https://ky.wordpress.org/plugins/perflocale/advanced/)

## Рейтинг

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/perflocale/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/perflocale/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/perflocale/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/perflocale/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/perflocale/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/perflocale/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/perflocale/reviews/)

## Мүчөлөрү

 *   [ аlex ](https://profiles.wordpress.org/alexgeorgiev/)

## Колдоо

Issues resolved in last two months:

     4 out of 5

 [Колдоо форумун көрүү](https://wordpress.org/support/plugin/perflocale/)