No commit activity in last 3 years
No release in over 3 years
Find out which locale the user preferes by reading the languages they specified in their browser
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies
 Project Readme

HttpAcceptLanguage¶ ↑

A small effort in making a plugin which helps you detect the users preferred language, as sent by the HTTP header.

Features¶ ↑

  • Splits the http-header into languages specified by the user

  • Returns empty array if header is illformed.

  • Corrects case to xx-XX

  • Sorted by priority given, as much as possible.

  • Gives you the most important language

  • Gives compatible languages

See also: www.w3.org/Protocols/rfc2616/rfc2616-sec14.html

Example¶ ↑

class SomeController < ApplicationController
  def some_action

    request.user_preferred_languages
    # => [ 'nl-NL', 'nl-BE', 'nl', 'en-US', 'en' ]

    available = %w{en en-US nl-BE}
    request.preferred_language_from(available)
    # => 'nl-BE'

    request.user_preferred_languages
    # => [ 'en-GB']
    available = %w{en-US}
    request.compatible_language_from(available)
    # => 'en-US'
  end
end

Installation¶ ↑

Install the gem http_accept_language, require it in your Rails app.

Changelog¶ ↑

  • 2010-01-05: Gem release

  • 2009-03-12: Rails 2.3 compatible

Copyright © 2008-2010 Iain Hecker, released under the MIT license