crummy 1.3.6 → 1.5.0

data/README.textile

@@ -10,7 +10,7 @@ Simply add the dependency to your Gemfile:
 
 <pre>
   <code>
-    gem "crummy", "~> 1.3.6"
+    gem "crummy", "~> 1.5.0"
   </code>
 </pre>
 
@@ -98,6 +98,43 @@ A crumb with a nil argument for the link will output an unlinked crumb.
 
 With :format => :html_list you can specify additional params: :active_li_class, :li_class, :ul_class, :ul_id
 
+h3. App-wide configuration
+
+You have the option to pre-configure any of the Crummy options in an application-wide configuration. The options above are available to configure, with the exception of @:separator@, as well as many others.
+
+The biggest difference is that @:separator@ is not an option. Instead, you have format-specific configuration options: @:html_separator@, @:xml_separator@, and @:html_list_separator@. @:separator@ can still be overridden in the view.
+
+Insert the following in a file named @config/initializers/crummy.rb@:
+
+<pre>
+  <code>
+    Crummy.configure do |config|
+      config.format = :xml
+    end
+  </code>
+</pre>
+
+Possible parameters for configuration are: 
+
+<pre>
+  <code>
+    :format
+    :links
+    :skip_if_blank
+    :html_separator
+    :xml_separator
+    :html_list_separator
+    :first_class
+    :last_class
+    :ul_id
+    :ul_class
+    :li_class
+    :active_li_class
+  </code>
+</pre>
+
+See @lib/crummy.rb@ for a list of these parameters and their defaults.
+
 h2. Notes
 
 Test library is at "Crummy Test":https://github.com/zachinglis/crummy-test
@@ -120,10 +157,11 @@ h2. Credits
 * "Max Riveiro":http://github.com/kavu
 * "Kamil K. Lemański":http://kml.jogger.pl
 * "Brian Cobb":http://bcobb.net/
-* "Kir Shatrov":http://shatrov.tk/
+* "Kir Shatrov":http://github.com/shatrov ("Evrone company":http://evrone.com)
 * "sugilog":http://github.com/sugilog
 * "Trond Arve Nordheim":http://github.com/tanordheim
 * "Jan Szumiec":http://github.com/jasiek
 * "Jeff Browning":http://github.com/jbrowning
+* "Bill Turner":http://github.com/billturner
 
 *Copyright (c) 2008-2011 Zach Inglis, released under the MIT license*

data/VERSION

@@ -1 +1 @@
-1.3.6
+1.5.0

data/lib/crummy.rb

@@ -1,10 +1,49 @@
 module Crummy
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configure
+    yield configuration
+  end
+
+  class Configuration
+    attr_accessor :format
+    attr_accessor :links
+    attr_accessor :skip_if_blank
+    attr_accessor :html_separator
+    attr_accessor :xml_separator
+    attr_accessor :html_list_separator
+    attr_accessor :first_class
+    attr_accessor :last_class
+    attr_accessor :ul_id
+    attr_accessor :ul_class
+    attr_accessor :li_class
+    attr_accessor :active_li_class
+
+    def initialize
+      @format = :html
+      @html_separator = " » "
+      @xml_separator = "crumb"
+      @html_list_separator = ''
+      @skip_if_blank = true
+      @links = true
+      @first_class = ''
+      @last_class = ''
+      @ul_id = ''
+      @ul_class = ''
+      @li_class = ''
+      @active_li_class = ''
+    end
+  end
+
   if defined?(Rails::Railtie)
     require 'crummy/railtie'
   else
     require 'crummy/action_controller'
     require 'crummy/action_view'
-    ActionController::Base.send :include,  Crummy::ControllerMethods 
+    ActionController::Base.send :include, Crummy::ControllerMethods
     ActionView::Base.send :include, Crummy::ViewMethods
-  end	  
+  end
 end

data/lib/crummy/standard_renderer.rb

@@ -27,15 +27,13 @@ module Crummy
     #   render_crumbs(" . ")  #=> <a href="/">Home</a> . <a href="/businesses">Businesses</a>
     #
     def render_crumbs(crumbs, options = {})
-      options[:format] = :html if options[:format] == nil
+      options[:skip_if_blank] ||= Crummy.configuration.skip_if_blank
       return '' if options[:skip_if_blank] && crumbs.count < 1
-      if options[:separator] == nil
-        options[:separator] = " &raquo; " if options[:format] == :html 
-        options[:separator] = "crumb" if options[:format] == :xml 
-      end
-      options[:links] = true if options[:links] == nil
-      options[:first_class] ||= ''
-      options[:last_class] ||= ''
+      options[:format] ||= Crummy.configuration.format
+      options[:separator] ||= Crummy.configuration.send(:"#{options[:format]}_separator")
+      options[:links] ||= Crummy.configuration.links
+      options[:first_class] ||= Crummy.configuration.first_class
+      options[:last_class] ||= Crummy.configuration.last_class
 
       case options[:format]
       when :html
@@ -44,17 +42,15 @@ module Crummy
         end * options[:separator]
         crumb_string
       when :html_list
-        # In html_list format there are no separator, but may be
-        options[:separator] = "" if options[:separator] == nil
-        # Lets set default values for special options of html_list format
-        options[:active_li_class] = "" if options[:active_li_class] == nil
-        options[:li_class] = "" if options[:li_class] == nil
-        options[:ul_class] = "" if options[:ul_class] == nil
-        options[:ul_id] = "" if options[:ul_id] == nil
+        # Let's set values for special options of html_list format
+        options[:active_li_class] ||= Crummy.configuration.active_li_class
+        options[:li_class] ||= Crummy.configuration.li_class
+        options[:ul_class] ||= Crummy.configuration.ul_class
+        options[:ul_id] ||= Crummy.configuration.ul_id
         crumb_string = crumbs.collect do |crumb|
           crumb_to_html_list(crumb, options[:links], options[:li_class], options[:active_li_class], options[:first_class], options[:last_class], (crumb == crumbs.first), (crumb == crumbs.last))
         end * options[:separator]
-        crumb_string = "<ul class=\"#{options[:ul_class]}\" id=\"#{options[:ul_id]}\">" + crumb_string + "</ul>"
+        crumb_string = content_tag(:ul, crumb_string, :class => options[:ul_class], :id => options[:ul_id])
         crumb_string
       when :xml
         crumbs.collect do |crumb|
@@ -82,12 +78,12 @@ module Crummy
       html_classes << last_class if is_last
       html_classes << active_li_class unless url && links
       html_classes << li_class if !is_first && !is_last && url && links
-      url && links ? "<li class=\"#{html_classes.join(' ').strip}\"><a href=\"#{url}\">#{name}</a></li>" : "<li class=\"#{html_classes.join(' ').strip}\"><span>#{name}</span></li>"
+      content_tag(:li, url && links ? link_to(name, url) : content_tag(:span, name), :class => html_classes.join(' ').strip)
     end
   
     def crumb_to_xml(crumb, links, separator, is_first, is_last)
       name, url = crumb
-      url && links ? "<#{separator} href=\"#{url}\">#{name}</#{separator}>" : "<#{separator}>#{name}</#{separator}>"
+      content_tag(separator, name, :href => (url && links ? url : nil))
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: crummy
 version: !ruby/object:Gem::Version
-  version: 1.3.6
+  version: 1.5.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-24 00:00:00.000000000Z
+date: 2012-02-07 00:00:00.000000000Z
 dependencies: []
 description: Crummy is a simple and tasty way to add breadcrumbs to your Rails applications.
 email: zach+crummy@londonmade.co.uk