PlugLocaleRootRedirect

PlugLocaleRootRedirect ensures that all requests to the root path (/) are redirected to the best locale path (eg. /fr, /en, etc.), from a list of supported locales.

Installation

Add plug_locale_root_redirect to the deps function in your project's mix.exs file:

defp deps do
  [
    …,
    {:plug_locale_root_redirect, "~> 0.3"}
  ]
end

Then run mix do deps.get, deps.compile inside your project's directory.

Usage

PlugLocaleRootRedirect can be used just as any other plugs. Add PlugLocaleRootRedirect before all of the other plugs you want to happen after successful redirection to your locale path.

defmodule Endpoint do
  plug PlugLocaleRootRedirect, locales: ~w(en fr)
end

The result:

$ curl -sI "http://localhost:4000" -H "Accept-Language: fr;q=1, en;q=0.8" | grep "302\|Location"
HTTP/1.1 302 Found
Location: /fr

$ curl -sI "http://localhost:4000" -H "Accept-Language: fr;q=0.4, en;q=0.8" | grep "302\|Location"
HTTP/1.1 302 Found
Location: /en

$ curl -sI "http://localhost:4000" -H "Accept-Language: es;q=1, ru;q=0.5" | grep "302\|Location"
HTTP/1.1 302 Found
Location: /en

$ curl -sI "http://localhost:4000" | grep "302\|Location"
HTTP/1.1 302 Found
Location: /en

If a request is made to /, it will be redirected to /en or /fr, depending on the request locale preference. If the request has no preference between supported locales, it will be redirected to the first locale, /en in this case.

PlugLocaleRootRedirect

Installation

Usage

License