crumble 0.1.1 → 0.1.2

data/README.md

@@ -76,6 +76,33 @@ If you don't want to specify any URL method at all, just use :current, it'll jus
 
     crumb :search, 'Search (Keywords: #{params[:q]})', :current
 
+Internationalization usage
+
+For example, if you want to localize your menu, define a new breadcrumbs node in your .yml file with all the keys for your elements.
+    # config/locales/en.yml
+    en:
+      breadcrumbs:
+        homepage: Homepage
+        profile: Your Profile
+        profile_dynamic: Hi {{name}}
+
+    # config/locales/es.yml
+    es:
+      breadcrumbs:
+        homepage: Homepage
+        profile: Tu perfil
+        profile_dynamic: Hola {{name}}
+
+Then you can define the title of your crum as:
+
+     crumb :profile, nil, :account_url
+
+Crumble find your locale for the scope "breadcrumbs.#{crumb.name}"
+
+If you want to make the I18n title content dynamic, just use a hash with the same key as the i18n param and with a hash value that will be interpolate to @user.name in this case:
+
+      crumb :profile_dynamic, {:name => {:user => :name}}, :account_url
+
 You can base trails on conditions using :unless and :if. Both need to point to a method that exists in the context of the view.
 
     trail :home, :index, [:root], :unless => :logged_in?
@@ -122,9 +149,14 @@ Future
 
 If you think something's missing, let me know at <meyer@paperplanes.de>, or even better, send patches, including tests.
 
+Contributors
+===========
+
+* Paco Guzmán (i18n support)
+
 License
 =======
 
 MIT
 
-(c) 2009 [Mathias Meyer](http://www.paperplanes.de)
+(c) 2009 [Mathias Meyer](http://www.paperplanes.de)

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/app/helpers/breadcrumbs_helper.rb

@@ -15,9 +15,9 @@ module BreadcrumbsHelper
     trail.each do |crummy|
       crumb = Breadcrumb.instance.crumbs[crummy]
       if not Breadcrumb.instance.last_crumb_linked? and crummy == trail.last
-        breadcrumb_trail << eval(%Q{"#{crumb.title}"})
+        breadcrumb_trail << eval(%Q{"#{assemble_crumb_title(crumb)}"})        
       else
-        breadcrumb_trail << link_to(eval(%Q{"#{crumb.title}"}), fetch_crumb_url(crumb))
+        breadcrumb_trail << link_to(eval(%Q{"#{assemble_crumb_title(crumb)}"}), fetch_crumb_url(crumb))
       end
     end
     breadcrumb_trail.join(Breadcrumb.instance.delimiter)
@@ -86,4 +86,18 @@ module BreadcrumbsHelper
     end
     result
   end
+
+  def assemble_crumb_title(crumb)
+    if crumb.title.is_a?(Hash) # We expect the name of the parameters with the code to evaluate
+      i18n_params = {}
+      crumb.title.each_pair do |key, value|
+        i18n_params[key] = instance_eval("@#{assemble_crumb_url_parameter(value).join(".")}")
+      end
+      I18n.t(crumb.name, {:scope => "breadcrumbs"}.merge!(i18n_params))
+    elsif crumb.title.nil?
+      I18n.t(crumb.name, :scope => "breadcrumbs")
+    else
+      crumb.title
+    end
+  end
 end

data/spec/breadcrumbs_helper_spec.rb

@@ -28,6 +28,56 @@ describe BreadcrumbsHelper do
   describe "when getting the breadcrumbs" do
     before(:each) do
     end
+
+    describe "i18n support" do
+      it "should get the title from I18n based in the crumb name" do
+        I18n.backend.store_translations(:en, {:breadcrumbs => {:profile => "Your Profile"}})
+        Breadcrumb.configure do
+          crumb :profile, nil, :user_url, :user
+          trail :accounts, :edit, [:profile]
+        end
+        params[:controller] = 'accounts'
+        params[:action] = 'edit'
+        crumbs.should == %Q{<a href="http://test.host/f/jonathan">Your Profile</a>}
+      end
+
+      it "should get the title from I18n based in the crumb name in the last crumb when the option was specified" do
+        I18n.backend.store_translations(:en, {:breadcrumbs => {:profile => "Your Profile"}})
+        Breadcrumb.configure do
+          crumb :profile, nil, :user_url, :user
+          trail :accounts, :edit, [:profile]
+          dont_link_last_crumb
+        end
+        params[:controller] = 'accounts'
+        params[:action] = 'edit'
+        crumbs.should == %Q{Your Profile}
+      end
+
+      describe "i18n parameters" do
+        it "should be able to interpolate parameters in a hash" do
+          I18n.backend.store_translations(:en, {:breadcrumbs => {:profile => "Your Profile - {{login}}"}})
+          Breadcrumb.configure do
+            crumb :profile, {:login => {:user => :login}}, :user_url, :user
+            trail :accounts, :edit, [:profile]
+          end
+
+          params[:controller] = 'accounts'
+          params[:action] = 'edit'
+          crumbs.should == %Q{<a href="http://test.host/f/jonathan">Your Profile - jonathan</a>}
+        end
+      end
+
+      it "should use title instead I18n.t message" do
+        I18n.backend.store_translations(:en, {:breadcrumbs => {:profile => "Your Profile"}})
+        Breadcrumb.configure do
+          crumb :profile, 'Your Profile', :user_url, :user
+          trail :accounts, :edit, [:profile]
+        end
+        params[:controller] = 'accounts'
+        params[:action] = 'edit'
+        crumbs.should == %Q{<a href="http://test.host/f/jonathan">Your Profile</a>}
+      end
+    end
     
     it "should calculate the urls in the breadcrumbs" do
       Breadcrumb.configure do
@@ -104,6 +154,23 @@ describe BreadcrumbsHelper do
       params[:q] = 'google'
       crumbs.should == %Q{<a href="http://test.host/search?q=google&amp;country=Germany">Search</a>}
     end
+
+    it "should add multiple parameters to the url not need to test the order" do
+      Breadcrumb.configure do
+        crumb :search, "Search", :search_url, :params => [:q, :country]
+        trail :search, :new, [:search]
+      end
+
+      params[:controller] = 'search'
+      params[:action] = 'new'
+      params[:country] = 'Germany'
+      params[:q] = 'google'
+
+      params_array = URI.parse(crumbs[/.*href=[\"'](.*)[\"']/,1]).query.split(/=|(&amp;)/)
+      %w(q google country Germany).each do |key|
+        params_array.should include(key)
+      end
+    end
     
     it "should eval single quoted title strings and interpolate them" do
       Breadcrumb.configure do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: crumble
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors: 
 - Mathias Meyer
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-11-19 00:00:00 +01:00
+date: 2010-01-27 00:00:00 +01:00
 default_executable: 
 dependencies: []