koa-i18next-middleware

An i18next middleware for koa2 framework.

Install

``sh npm i -S koa-i18next-middleware`

`Usage`

#### Notice: this plugin requires koa2 with async enabled in Node.js.

`js const i18next = require('i18next'); const i18m = require('koa-i18next-middleware');

// add custom detector. const lngDetector = new i18m.LanguageDetector(); lngDetector.addDetector({ name: 'mySessionDetector',

lookup(ctx, options) { let found; if (options.lookupSession && ctx && ctx.sessions) { found = ctx.sessions[options.lookupMySession]; } return found; },

cacheUserLanguage(ctx, lng, options = {}) { if (options.lookupMySession && ctx && ctx.session) { ctx.session[options.lookupMySession] = lng; } } });

i18next.use(lngDetector).init( { fallbackLng: 'en', preload: ['en', 'es'], resources: { en: { translation: { key: 'hello world' } }, es: { translation: { key: 'es hello world es' } } }, detection: { order: [ 'querystring', 'path', /'cookie', 'header',/ 'session', 'mySessionDetector' ],

lookupQuerystring: 'lng',

lookupParam: 'lng', // for route like: 'path1/:lng/result' lookupFromPathIndex: 0,

// currently using ctx.cookies lookupCookie: 'i18next', // cookieExpirationDate: new Date(), // default: +1 year // cookieDomain: '', // default: current domain.

// currently using ctx.session lookupSession: 'lng',

// other options lookupMySession: 'lang',

// cache user language caches: ['cookie', 'mySessionDetector'] } }, (err, t) => { // initialized and ready to go! const hw = i18next.t('key'); // hw = 'hello world' console.log(hw); } );

app.use( i18m.getHandler(i18next, { locals: 'locals', ignoreRoutes: ['/no-lng-route'] }) );``

License

MIT © steven
MIT © i18next-express-middleware

[npm-url]: https://npmjs.org/package/koa-i18next-middleware
[npm-image]: https://img.shields.io/npm/v/koa-i18next-middleware.svg?style=flat-square
[travis-url]: https://travis-ci.org/lxzxl/koa-i18next-middleware
[travis-image]: https://img.shields.io/travis/lxzxl/koa-i18next-middleware.svg?style=flat-square
[coveralls-url]: https://coveralls.io/r/lxzxl/koa-i18next-middleware
[coveralls-image]: https://img.shields.io/coveralls/lxzxl/koa-i18next-middleware.svg?style=flat-square
[depstat-url]: https://david-dm.org/lxzxl/koa-i18next-middleware
[depstat-image]: https://david-dm.org/lxzxl/koa-i18next-middleware.svg?style=flat-square
[download-badge]: http://img.shields.io/npm/dm/koa-i18next-middleware.svg?style=flat-square

Usage

#### Notice: this plugin requires koa2 with async enabled in Node.js.

js
const i18next = require('i18next');
const i18m = require('koa-i18next-middleware');

// add custom detector.
const lngDetector = new i18m.LanguageDetector();
lngDetector.addDetector({
    name: 'mySessionDetector',

    lookup(ctx, options) {
        let found;
        if (options.lookupSession && ctx && ctx.sessions) {
            found = ctx.sessions[options.lookupMySession];
        }
        return found;
    },

    cacheUserLanguage(ctx, lng, options = {}) {
        if (options.lookupMySession && ctx && ctx.session) {
            ctx.session[options.lookupMySession] = lng;
        }
    }
});

i18next.use(lngDetector).init(
    {
        fallbackLng: 'en',
        preload: ['en', 'es'],
        resources: {
            en: {
                translation: {
                    key: 'hello world'
                }
            },
            es: {
                translation: {
                    key: 'es hello world es'
                }
            }
        },
        detection: {
            order: [
                'querystring',
                'path',
                /'cookie', 'header',/ 'session',
                'mySessionDetector'
            ],

lookupQuerystring: 'lng',

            lookupParam: 'lng', // for route like: 'path1/:lng/result'
            lookupFromPathIndex: 0,

            // currently using ctx.cookies
            lookupCookie: 'i18next',
            // cookieExpirationDate: new Date(), // default: +1 year
            // cookieDomain: '', // default: current domain.

            // currently using ctx.session
            lookupSession: 'lng',

            // other options
            lookupMySession: 'lang',

            // cache user language
            caches: ['cookie', 'mySessionDetector']
        }
    },
    (err, t) => {
        // initialized and ready to go!
        const hw = i18next.t('key'); // hw = 'hello world'
        console.log(hw);
    }
);

app.use(
    i18m.getHandler(i18next, {
        locals: 'locals',
        ignoreRoutes: ['/no-lng-route']
    })
);

License