FS/FS/Locales.pm

   1 package FS::Locales;
   2
   3 use strict;
   4 use Tie::IxHash;
   5
   6 =head1 NAME
   7
   8 FS::Locales - Supported locales
   9
  10 =head1 SYNOPSIS
  11
  12   use FS::Locales;
  13
  14   my @locales = FS::Locales->locales;
  15
  16 =head1 DESCRIPTION
  17
  18 FS::Locales provides a list of supported locales.
  19
  20 =head1 CLASS METHODS
  21
  22 =over 4
  23
  24 =item locales
  25
  26 Returns a list of the available locales.
  27
  28 =cut
  29
  30 tie our %locales, 'Tie::IxHash',
  31   'en_US', { name => 'English',        country => 'United States', },
  32   'en_AU', { name => 'English',        country => 'Australia', },
  33   'en_CA', { name => 'English',        country => 'Canada', },
  34   'es_ES', { name => 'Spanish',        country => 'Spain', },
  35   'es_CU', { name => 'Spanish',        country => 'Cuba', },
  36   'es_MX', { name => 'Spanish',        country => 'Mexico', },
  37   'es_US', { name => 'Spanish',        country => 'United States', },
  38   'fr_CA', { name => 'French',         country => 'Canada', },
  39   'fr_FR', { name => 'French',         country => 'France', },
  40   'fr_HT', { name => 'French',         country => 'Haiti', },
  41   'ht_HT', { name => 'Haitian Creole', country => 'Haiti', },
  42   'iw_IL', { name => 'Hebrew',         country => 'Israel', rtl=>1, },
  43 ;
  44
  45 $_->{label} = $_->{name} . ' (' . $_->{country} . ')'
  46   foreach values %locales;
  47
  48 sub locales {
  49   keys %locales;
  50 }
  51
  52 =item locale_info LOCALE
  53
  54 Returns a hash of information about a locale.
  55
  56 =cut
  57
  58 sub locale_info {
  59   my($class, $locale) = @_;
  60   if (!$locale) {
  61     return ();
  62   } elsif (exists $locales{$locale}) {
  63     return %{ $locales{$locale} };
  64   } else {
  65     die "unsupported locale '$locale'\n";
  66   }
  67 }
  68
  69 =item description LOCALE
  70
  71 Returns "Language (Country)" for a locale.
  72
  73 =cut
  74
  75 sub description {
  76   my($class, $locale) = @_;
  77   $locales{$locale}->{'name'} . ' (' . $locales{$locale}->{'country'} . ')';
  78 }
  79
  80 =back
  81
  82 =head1 BUGS
  83
  84 =head1 SEE ALSO
  85
  86 L<FS::Msgcat>
  87
  88 =cut
  89
  90 1;
  91