{"id":45,"date":"2026-09-09T04:26:00","date_gmt":"2026-09-09T04:26:00","guid":{"rendered":"https:\/\/nirohelp.com\/docs\/45\/translating-nirohelp\/"},"modified":"2026-09-09T04:26:00","modified_gmt":"2026-09-09T04:26:00","slug":"translating-nirohelp","status":"publish","type":"nirohelp_doc","link":"https:\/\/nirohelp.com\/docs\/developers\/translating-nirohelp\/","title":{"rendered":"Translating NiroHelp"},"content":{"rendered":"

Every user-facing string passes through __()<\/code> \/ _e()<\/code> \/ esc_html_e()<\/code> in PHP
\nand __()<\/code> from @wordpress\/i18n<\/code> in the React admin, all under the text domain
\nnirohelp<\/code>.<\/p>\n

Plugin header values<\/h2>\n
Text Domain: nirohelp\nDomain Path: \/languages\n<\/code><\/pre>\n
The .pot file<\/h2>\n
languages\/nirohelp.pot<\/code>. Hand it to a translator or open it in Poedit or Loco
\nTranslate; both produce the matching .po<\/code> and .mo<\/code>.<\/p>\n
languages\/easyhelp.pot<\/code> is a pre-rename leftover and is not used by anything.
\nIgnore it.<\/p>\n
File naming<\/h2>\n
WordPress loads .mo<\/code> files named with the locale:<\/p>\n
languages\/nirohelp-fr_FR.po      # human-editable source\nlanguages\/nirohelp-fr_FR.mo      # compiled, this is what WordPress loads\nlanguages\/nirohelp-de_DE.mo\nlanguages\/nirohelp-bn_BD.mo\n<\/code><\/pre>\n
The admin SPA needs a third form. See The SPA’s strings<\/em> below.<\/p>\n
Regenerating the template<\/h2>\n
Build first.<\/strong> The SPA’s strings are extracted from the compiled bundle, not
\nfrom spa\/<\/code>:<\/p>\n
yarn build\ncomposer run makepot\ncomposer run make-json\n<\/code><\/pre>\n
makepot<\/code> runs:<\/p>\n
wp i18n make-pot . languages\/nirohelp.pot \\\n  --exclude=node_modules,vendor,docs,release,tests,website,spa\n<\/code><\/pre>\n
Note spa<\/code> in the exclude list \u2014 that is deliberate, and it is the part most
\nworth understanding.<\/p>\n
Why extraction runs over the bundle<\/h3>\n
WP-CLI’s string scanner reads .js<\/code> and .jsx<\/code>. It cannot parse .tsx<\/code> at all,
\nso pointing it at spa\/<\/code> yields zero<\/strong> strings, silently, while
\nControllers\\Admin\\App<\/code> goes on calling wp_set_script_translations()<\/code> for
\ntranslations that could never exist. Extraction therefore runs over
\nbuild\/admin-app.js<\/code>, where webpack has rewritten the calls into
\n(0,i.__)(\"\u2026\",\"nirohelp\")<\/code> \u2014 a form the scanner does understand.<\/p>\n
Two consequences:<\/p>\n
    \n
  • makepot<\/code> must run after yarn build<\/code>.<\/strong> Without it, hundreds of strings
    \n  vanish from the POT without a word. The script now refuses to run when
    \n  build\/admin-app.js<\/code> is missing, and composer run release<\/code> builds first.<\/li>\n
  • Do not rename or move the bundle.<\/strong> make-json<\/code> keys each JSON file by
    \n  md5()<\/code> of the script’s path<\/em>, so the PO references have to say
    \n  build\/admin-app.js<\/code> \u2014 exactly what wp_enqueue_script()<\/code> registers. Rename
    \n  it and every SPA translation silently stops loading. If you move it,
    \n  regenerate both files.<\/li>\n<\/ul>\n
    The SPA’s strings<\/h3>\n
    composer run make-json<\/code> converts each .po<\/code> in languages\/<\/code> into the JSON
    \nfiles wp_set_script_translations()<\/code> loads at runtime, one per script handle,
    \nnamed nirohelp-{locale}-{md5-of-path}.json<\/code> and registered against the nirohelp-admin-app<\/code> script handle. PHP strings come from the .mo<\/code>;
    \nReact strings come from these. A locale needs both<\/strong>, so run make-json<\/code>
    \nafter every .po<\/code> update, not only after makepot<\/code>.<\/p>\n
    Loading translations<\/h2>\n
    Translations load automatically when a matching locale is active in Settings
    \n-> General -> Site Language<\/strong>, provided the .mo<\/code> (and, for the admin screens,
    \nthe .json<\/code>) exists.<\/p>\n
    Per-user language<\/h2>\n
    Individual users can pick a language under Users -> Profile -> Language<\/strong>.
    \nNiroHelp respects it: an admin reading WordPress in French sees the plugin in
    \nFrench even when the site default is English.<\/p>\n
    What is not translatable<\/h2>\n
      \n
    • cdn\/chat.min.js<\/code><\/strong>, the chatbot widget. It is a vendor bundle served from
      \n  the CDN to sites that are not necessarily WordPress, and its own defaults
      \n  (Support<\/code>, Type a message...<\/code>, the offline greeting) are English. Override
      \n  them per site with the data-agent-name<\/code>, data-input-placeholder<\/code>,
      \n  data-welcome-message<\/code> and data-offline-message<\/code> attributes.<\/li>\n
    • assets\/tickets\/js\/embed.js<\/code><\/strong>, the embeddable ticket form. Its labels are
      \n  hard-coded English. Copy the file and edit it if you need another language.<\/li>\n
    • A handful of button states in assets\/common\/js\/init.js<\/code>.<\/li>\n<\/ul>\n
      None of these load through wp_set_script_translations()<\/code>, so a .json<\/code> file
      \ndoes not reach them.<\/p>\n
      Never run yarn lint:js --fix<\/code><\/h2>\n
      Unrelated to translation but relevant to touching these files: the lint script’s
      \nown glob covers cdn\/chat.min.js<\/code>, and --fix<\/code> reformats that vendor bundle into
      \na 500-line diff. It ignores a path argument, so narrowing the command does not
      \nhelp.<\/p>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}}},"nirohelp_product":[],"nirohelp_topic":[12],"class_list":["post-45","nirohelp_doc","type-nirohelp_doc","status-publish","hentry","nirohelp_topic-developers"],"_links":{"self":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc\/45","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_doc"}],"about":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/types\/nirohelp_doc"}],"author":[{"embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"wp:attachment":[{"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/media?parent=45"}],"wp:term":[{"taxonomy":"nirohelp_product","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_product?post=45"},{"taxonomy":"nirohelp_topic","embeddable":true,"href":"https:\/\/nirohelp.com\/docs\/wp-json\/wp\/v2\/nirohelp_topic?post=45"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}