rails-timeago 1.3.0 → 1.4.0

data/README.md

@@ -104,6 +104,17 @@ locale file lookup for `timeago_script_tag`.
 To add your own locales add a file in JavaScript assets directory named
 `locales/jquery.timeago.<locale>.js` and add your locale to `Rails::Timeago.locales`.
 
+**rails-timeago** provides support for custom locale file mappings. That may be
+especially useful to override the embedded `en` locale because there is no English
+locale file that can be overridden:
+
+```ruby
+Rails::Timeago.map_locale "en", "better/locales/en.js"
+```
+
+Given that mapping rails-timeago's `timeago_script_tag` will include the mapped
+locale file into your page.
+
 ## License
 
 [MIT License](http://www.opensource.org/licenses/mit-license.php)

data/lib/rails-timeago.rb

@@ -83,6 +83,21 @@ module Rails
       end
     end
 
+    # Allow to map a locale to a specific url. May be useful for
+    # overriding embedded english locale:
+    #
+    #   Rails::Timeago.map_locale :en, "better/locales/en.js"
+    #
+    def self.map_locale(locale, url)
+      @locale_map ||= {}
+      @locale_map[locale.to_s] = url
+    end
+
+    def self.mapped_locale(locale)
+      @locale_map ||= {}
+      @locale_map[locale.to_s]
+    end
+
     def self.locale_path
       File.dirname(__FILE__) + '/../vendor/assets/javascripts/locales/'
     end
@@ -124,6 +139,7 @@ module Rails
 
     def self.has_locale(locale)
       return locales.include? locale if locales.any?
+      return true if @locale_map and @locale_map[locale.to_s]
       return has_locale_file locale
     end
 

data/lib/rails-timeago/helper.rb

@@ -56,11 +56,18 @@ module Rails
       end
 
       # Return a JavaScript tag to include jQuery timeago
-      # locale file for current or given locale.
+      # or custom mapped locale file for current or given locale.
       def timeago_script_tag(locale = nil)
         locale = ::Rails::Timeago.lookup_locale locale
-        return javascript_include_tag 'locales/' + ::Rails::Timeago.locale_file_name(locale) if locale != "en"
-        ''
+
+        file = ::Rails::Timeago.mapped_locale locale
+        return javascript_include_tag file if file
+
+        if locale != 'en'
+          javascript_include_tag 'locales/' + ::Rails::Timeago.locale_file_name(locale)
+        else
+          '' # English locale is embedded in jQuery timeago plugin file.
+        end
       end
     end
   end

data/lib/rails-timeago/version.rb

@@ -2,7 +2,7 @@ module Rails
   module Timeago
     module VERSION
       MAJOR = 1
-      MINOR = 3
+      MINOR = 4
       PATCH = 0
       STAGE = nil
 

data/spec/timeago/helper_spec.rb

@@ -87,16 +87,35 @@ describe Rails::Timeago::Helper do
   end
 
   context "#timeago_script_tag" do
-    it "should not return anything if locale is 'en'" do
+    it "should not return anything if locale is 'en' and no 'en' mapping exists" do
+      Rails::Timeago.map_locale :en, nil
       I18n.locale = "en"
       @stub.timeago_script_tag.should == ""
     end
 
+    it "should return mapped 'en' locale file if mapping exists" do
+      Rails::Timeago.map_locale :en, "better/locale/en.js"
+
+      I18n.locale = "en"
+      @stub.timeago_script_tag.should == '<script src="better/locale/en.js"></script>'
+
+      Rails::Timeago.map_locale :en, nil
+    end
+
     it "should return javascript tag with locale file" do
       I18n.locale = "de"
       @stub.timeago_script_tag.should == '<script src="locales/jquery.timeago.de.js"></script>'
     end
 
+    it "should return javascript tag with mapped locale file" do
+      Rails::Timeago.map_locale :de, "deutsch.js"
+
+      I18n.locale = "de"
+      @stub.timeago_script_tag.should == '<script src="deutsch.js"></script>'
+
+      Rails::Timeago.map_locale :de, nil
+    end
+
     it "should return javascript tag with full locale file if available" do
       I18n.locale = "zh-CN"
       @stub.timeago_script_tag.should == '<script src="locales/jquery.timeago.zh-CN.js"></script>'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-timeago
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-25 00:00:00.000000000 Z
+date: 2012-06-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport