Home

Awesome

Actions npm version

This is an i18next plugin or standalone script to be used for locize service. It will update last used timestamps on reference keys (so only on your reference/source language) from your locize project using http requests.

Troubleshooting

Seems not working

Per default only localhost is allowed to send last used information (to avoid using this feature accidentally in production). If you're not using localhost during development you will have to set the allowedHosts: ['your.domain.tld'] for the options.

Getting started

Source can be loaded via npm or downloaded from this repo.

# npm package
$ npm install locize-lastused

Options

IMPORTANT make sure you do not add your apiKey in the production build to avoid misuse by strangers

{
  // the id of your locize project
  projectId: '[PROJECTID]',

  // add an api key if you want to send missing keys
  apiKey: '[APIKEY]',

  // the reference language of your project
  referenceLng: '[LNG]',

  // version - defaults to latest
  version: '[VERSION]',

  // debounce interval to send data in milliseconds
  debounceSubmit: 90000,

  // hostnames that are allowed to send last used data
  // please keep those to your local system, staging, test servers (not production)
  allowedHosts: ['localhost']
}

Using with i18next

Options can be passed in by setting options.locizeLastUsed in i18next.init:

import i18next from 'i18next';
import locizeLastUsed from 'locize-lastused';
// or
const i18next = require('i18next');
const locizeLastUsed = require('locize-lastused');

i18next.use(locizeLastUsed).init({
  locizeLastUsed: options
});

Using without i18next

Directly call locizeLastUsed.init:

import locizeLastUsed from 'locize-lastused';

locizeLastUsed.init(options);

then call used function with namespace and key:

import locizeLastUsed from 'locize-lastused';

locizeLastUsed.used('myNamespace', 'myKey.as.in.locize');

TypeScript

To properly type the options, you can import the LocizeLastusedOptions interface and use it as a generic type parameter to the i18next's init method, e.g.:

import i18n from 'i18next'
import LocizeLastusedPlugin, { LocizeLastusedOptions } from 'locize-lastused'

i18n
  .use(LocizeLastusedPlugin)
  .init<LocizeLastusedOptions>({
    locizeLastUsed: {
      // locize lastused options
      projectId: '1234123424234',
      apiKey: 'my-api-key'
    },

    // other i18next options
  })