itszero / country_codes_with_contient
watch download tarball
public
Forks2Right
Watchers2Right
Fork of ptb/country_codes
Description: The Country Codes plugin finds and converts between country information as described in ISO 3166-1; forked from ptb's version and added Contient information.
Homepage: http://blog.orez.us/chyrp/?action=tag&name=countrycodes
Clone URL: git://github.com/itszero/country_codes_with_contient.git
Click here to lend your support to: country_codes_with_contient and make a donation at www.pledgie.com !
100644 48 lines (30 sloc) 2.301 kb
raw blame history 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

CountryCodesWithContient
============
 
This plugin provides an easy to access collection of ISO 3166-1, codes for the representation of names of countries and their subdivisions.
Contains the following from ISO 3166-1:
  
  * ISO 3166-1 alpha-2, a two-letter system, used in many applications, most prominently for
    country code top-level domains (ccTLDs), with some exceptions.
    
  * ISO 3166-1 alpha-3, a three-letter system, which allows a better visual association between
    country name and code element than the alpha-2 code.
    
  * ISO 3166-1 numeric, a three-digit numerical system, with the advantage of script (writing system)
    independence, and hence useful for people or systems which uses a non-Latin script. This is
    identicalto codes defined by the United Nations Statistics Division.
 
** In this fork, you can get contient information, too.
 
Why
======
Since I'm working on an e-commerce website, and I found that most of international shipping method's price is based on the geographic areas. To be exactly, the contient(For example, the Taiwan's Post Office). So I modified the original plugin to return the contient information as well. The data is extracted from the Wikipedia with some manual modification to match both. For those who don't use the contient information, I suggest you can use the original plugin "CountryCodes", since its data size is smaller, let your rails application load faster.
 
Example
=======
 
Find a country by name and retrieve information about it (alpha-2, alpha-3 and numeric):
 
  australia = CountryCodes.find_by_name('Australia')
  australia[:name]     # yields 'Australia'
  australia[:a2]       # yields 'au'
  australia[:a3]       # yields 'aus'
  australia[:numeric]  # yields 36
  australia[:contient] # yields 'OC'
  
  
Likewise countries can be found using any of the provides attributes (name, a2, a3 or numeric), such as:
 
  CountryCodes.find_by_a2['au'][:name]  # yields 'Australia'
 
 
Search conditions are case-insensitive.
 
 
 
Original copyright (c) 2007 James Brooks (http://blog.whitet.net), released under the MIT license
Copyright (c) 2008 Zero Cho (http://blog.orez.us/), released under the MIT license, too.
Contient data is extracted from "http://en.wikipedia.org/wiki/List_of_countries_by_continent_(data_file)"