JS Proxy for Crowdin

Extremely easy way to translate your “untranslatable” website. Very well suited for static content.

Import/Update Source Texts

https://
JS Proxy will crawl your website and extract all of the translatable texts. In your Crowdin project you will find a new file with every text for translation.
Useful when you are testing the technology. Website crawling takes time. Set the limit of how many pages you want to translate. Default is 10000.
Add exclude paths You can specify which paths to crawl. If not specified, all pages will be imported. You can use wildcard symbols such as * or ** or exclude paths with ! at the beginning of path.

Include paths examples:

/about - Will match exact page /about

/page/** - Will match all pages starting with /page/

/article/* - Will match all pages with one level above /article/, for example /article/1/2 will not be matched as it has more than one level

/**/comments - Will match all pages that end with /comments

Exclude paths examples:

/page/** - Will exclude all pages starting with /page/

Publish Translations

Latest translations will be available for over-the-air delivery for your website

For In Context Preview you need to add Pseudo Language 

Integrate language switcher

Just add a JavaScript snippet like you do with Google Analytics. This will let your visitors see the language switcher.

Please import your site and publish translations first.

What is JS Proxy for Crowdin?

It's an extremely easy way to translate your “untranslatable” website. Very well suited for static content, Knowledge Bases, landing pages, status pages and other non mission critical content

How do I translate mission-critical content?

The content should be extracted from your CMS or Application, translated and put back as a new language

How does it work?

  1. Import you website
    At this step you don’t have to make any changes to your website. JS Proxy will crawl your website and extract all of the translatable texts. In your Crowdin project you will find a new file with every text for translation.
  2. Publish translations
    Add a piece of JavaScript to your website as you do with Google Analytics. This is to let your visitors see the “Switch language” button. This button will also download the latest translations from Crowdin and show your website multilingual per visitor request.

How to set up the JS Proxy integration?

  1. Enter your website’s URL and click Import. Website content will be scanned and automatically added as a .json file to the Files section.
  2. Choose your translation strategy and translate your website
  3. Add a language-switcher to your website by inserting the JavaScript snippet displayed on the app configuration page inside the <head> tag of a page or before the </body> tag.
  4. Use the Import section of this plugin every time new content on your website needs to be translated.
  5. Click Distribute to publish new translations.

JS Proxy customization

You can customize JS Proxy integration by sending the following parameters:
    • position:
    • 'bottom-right' | 'top-right' | 'bottom-left' | 'top-left' (for sticky position)
    • 'inline' | 'left' | 'right' (for inline position)
  • submenuPosition: 'top-right' | 'bottom-right' | 'top-left' | 'bottom-left'
  • class: 'some-value-for-your-custom-class'
  <script>
    window.proxyTranslator.init({
      distributionBaseUrl: "https://dev-crowdin-distribution.s3.eu-central-1.amazonaws.com",
      filePath: "/example.com.json",
      distribution: "e-65caabe61ca575d56e7d161a",
      languages: {"uk":"Ukrainian"},
      defaultLanguage: "en",
      defaultLanguageTitle: "English",
      poweredBy: true,
      position: "top-right",
      submenuPosition: "bottom-right",
      class: "some-value-for-your-custom-class",
    });
  </script>

I don’t feel safe using this technology

  • JS Proxy has been built around open source components. Even if this addon disappears completely your translations are safe.
  • The translated content lives on Crowdin Distribution (the CDN), that is the official component of Crowdin. The small piece of JavaScript that you include to your website is an open source library called i18nextify.
  • No vendor lock! You can decide to stop using this addon or Crowdin at all and keep your website multilingual.

How much does this cost?

JS Proxy is free! Still, you have to have a Crowdin subscription and Crowdin Distribution credits. Please refer to the Crowdin’s pricing page.

I have question or help with the configuration

Crowdin provides 24x7 support

I would like to see some use cases

Some of the services that integrate with JS Proxy very well:

  • statuspage.io
  • Unbounce
  • Readme.io
  • Help Scout Docs
  • Wordpress websites