Skip to content

Latest commit

 

History

History
67 lines (40 loc) · 2.51 KB

README.md

File metadata and controls

67 lines (40 loc) · 2.51 KB
Raw

Country-Select

Provides a simple helper to get an HTML select list of countries. The list of countries comes from the ISO 3166 standard. While it is a relatively neutral source of country names, it may still offend some users.

Users are strongly advised to evaluate the suitability of this list given their user base.

This project was forked to have a version of the gem which would use 2 letter ISO-3166 country codes, and allow for internationalization. The translations can be set up under the "countries" key with the ISO-3166 code as the sub-key. Thus: countries.US is the translation key for the United States of America. The translated country names are then sorted alphabetically.

Latest Changes

1.2.4

  • When the ffi-locale gem is installed, then the countries are sorted using the proper collation.

1.2.3

  • Translated names are now sorted alphabetically.
  • Code is a little cleaner and more efficient (no need for zipping)

1.2.2

-- Fixed translated countries missing translation. It now defaults to the English name. -- Fixed handling of priority countries.

1.2.0

  • Converted COUNTRIES to a hash from default English name to ISO-3166 2 letter code.

1.1.1

  • Fixed incompatibility with Rails 3.2.2 (thanks to jmazzi)

1.1.0

  • Updated the country list to change the name of Libyan Arab Jamahiriya to Libya according to the latest ISO 3166 newsletter
  • A country in the priority list will be selected there and not in the main list (thanks to yyyc514)
  • Removed relics from the pre-gem days

Installation

Install as a gem using

gem install country-select

Or put the following in your Gemfile

gem 'country-select'

Example

Simple use supplying model and attribute as parameters:

country_select("user", "country_name")

Supplying priority countries to be placed at the top of the list:

country_select("user", "country_name", [ "United Kingdom", "France", "Germany" ])

Version History

  • 1.0.5 - runtime error raised if any of the user-supplied priority countries do not correlate with those in the main country list.
  • 1.0.4 - updated the country list to match the latest ISO 3166 specification
  • 1.0.3 - changed gem name from 'iso-3166-country-select' to just 'country-select'
  • 1.0.2 - forked the plugin and made it into a gem

Copyright (c) 2008 Michael Koziarski, released under the MIT license