Skip to content

koalazak/geolang-express

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

geolang-express

Build Status npm version npm dependency status

A simple geolocation middleware for Express.js. This module expose countryLang and object with more data countryData on app.locals making data visibles in views too. Also, set the session cookieLangName with the language of visitors country, useful for i18n modules.

NOTE: When using this module, we recommend also using the i18n-express module, which use the cookieLangName session to set i18n translations according that value.

Requirements

  • Node >= 0.12
  • Express.js session enabled

Instalation

$ npm install geolang-express

Usage

var geolang=require("geolang-express");

app.use( geolang(options) );

Options

  • cookieLangName : (default: ulang) If you provide a cookie name, try to get user lang from this session/cookie.
  • defaultCountry : (default: US) Default country, for example if the IP is 127.0.0.1
  • siteLangs : (default: ['en']) Array of supported langs. (posbile values for clang and json files. see i18n-express)

Example

In your Express app.js:

var express = require('express');
var path = require('path');
var cookieParser = require('cookie-parser');
var bodyParser = require('body-parser');
var i18n=require("i18n-express");
var geolang=require("geolang-express");

var indexRoutes = require('./routes/index');

var app = express();

// view engine setup
app.set('views', path.join(__dirname, 'views'));
app.set('view engine', 'ejs');
app.use(cookieParser());
app.use(express.static(path.join(__dirname, 'public')));
app.use(session({
  secret: 'secret',
  saveUninitialized: true,
  resave: true
}));


app.use(geolang({
  siteLangs: ["en","es"],
  cookieLangName: 'ulang'
}));


/*
//Read documentation if you need to use i18n-express package
app.use(i18n({
  translationsPath: path.join(__dirname, 'i18n'),
  siteLangs: ["en","es"],
  cookieLangName: 'ulang'
}));
*/


app.use('/', indexRoutes);

module.exports = app;

Now in your ejs view you have countryLang and object with more data countryData:

<div>
	
	<p>Language by Country IP set to: <%=countryLang%></p>

</div>

Or in your handlebars view:

<div>
	
	<p>Language by Country IP set to: <%=countryLang%></p>

</div>

License

MIT

Author

About

A simple geolocation middleware for Express.js

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published