gretel 3.0.5 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 1c82f3dde4a98f82f3eb6f0ce135a64a2ca7e8dc
-  data.tar.gz: 44d2c6ec3b8405991c4f0c2b9fc837d8a2711b70
+SHA256:
+  metadata.gz: e6b2a5d8a3fd0fbb357c690e1d0189c54ab90ad1619c6ea5910b59f9cf718e89
+  data.tar.gz: d5c633b783445c773bb031dbd2377ca8af9265ced45f9aaafeabebc853c754d6
 SHA512:
-  metadata.gz: 01e17764cb6cdfc58a8010a114722d9941671b4933cb92ca6b221c20d29fc787652f7bd504454a753626faee3cfbb1e7c813558f172468766740c22c4cf1264a
-  data.tar.gz: 6cd0c52eb47346f631916d66d9203857567b33c294adff6be93411eed6b3f72d1092349be8364d3915868bbf79890c523b439ebaead4317c957166f1c5892c97
+  metadata.gz: 5816c2df05e992e54868150d8f6689af7c2d2cb0af33b588c9ef552d54771efcf81b29a9b9f2bca223e784644288caf24987f8b38f546ea0b3a4be1944a73b1e
+  data.tar.gz: 80497833712a92ac207f663ab544761ebf65b7a93d8d5fd7712e3bb8b3c8785b72ee85020ead35cd2e118a03f09e81a3d844c7dbbd629a3cf6cfb1b3d78669ba

data/.gitignore

@@ -4,9 +4,9 @@
 .config
 .yardoc
 Gemfile.lock
+gemfiles/*.lock
 InstalledFiles
 _yardoc
-coverage
 doc/
 lib/bundler/man
 pkg
@@ -20,4 +20,9 @@ test/dummy/db/*.sqlite3
 test/dummy/log/*.log
 test/dummy/tmp/
 test/dummy/.sass-cache
-.DS_Store
+.DS_Store
+
+/coverage/index.html
+/coverage/assets
+/coverage/*.json
+/coverage/*.json.lock

data/.travis.yml

@@ -1,8 +1,14 @@
 language: ruby
+sudo: false
 rvm:
-  - 2.0.0
-  - 1.9.3
+  - 2.7
+  - 2.6
+  - 2.5
+env:
+  - RAILS="~> '5.1.0'"
+  - RAILS="~> '5.2.0'"
+  - RAILS="~> '6.0.0'"
 before_script:
   - "cd test/dummy; rake db:migrate; rake db:test:prepare; cd ../.."
 notifications:
-  email: false
+  email: false

data/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## Version 4.0.0
+* Support Bootstrap 4. See the `:style` option in the readme for more info
+* CSS class for fragment link or span is now customizable. See the `:fragment_class` option in the readme for more info
+* Drop support Ruby < 2.5
+* Drop support Rails < 5.1
+* Deprecated codes have been removed:
+  * `breadcrumbs` is no longer accept block, use `tap` instead
+  * `breadcrumbs` is no longer accept `style: :default`, use `style: :inline` instead
+  * `breadcrumbs` is no longer accept `:show_root_alone` option, use `:display_single_fragment` option instead
+
+## Version 3.0.9
+* Adds breadcrumbs option `link_current_to_request_path` to link the current breadcrumb to the request path(#28 via #29)
+* Fixes semantic breadcrumbs when the last item has no link (via #55)
+* Downgrades Rails dependency to 3.1 (via #56)
+* Fixes jRuby issue with `Rails::Application` constant (via #50)
+* Fixes deprecation warnings for `alias_method_chain` (via #66)
+* Updated coprights (via #63)
+
+## Version 3.0.8
+* Parent breadcrumbs can now also be inferred from models responding to `model_name`.
+
+## Version 3.0.7
+* Pretext and posttext classes are now customizable with `<%= breadcrumbs pretext_class: "some-class" %>` and `<%= breadcrumbs posttext_class: "some-other-class" %>`.
+
+## Version 3.0.6
+* Pretext and posttext are now enclosed in spans with `<span class="pretext">` and `<span class="posttext">`.
+* Semantic breadcrumbs are now rendered in spans instead of divs to enable easier styling.
+
 ## Version 3.0.3
 * Breadcrumbs can now be rendered for use in the [Foundation 5](http://foundation.zurb.com/) framework. Use `breadcrumbs style: :foundation5`.
 * Breadcrumbs are now automatically loaded from any engines' `config/breadcrumbs.rb` and `config/breadcrumbs/**/*.rb`. See the readme for details.
@@ -35,4 +63,4 @@
 * No longer supports procs for link text or URL as this is unnecessary when you can pass arguments to the block anyway.
 * It now accepts multiple arguments for `crumb` and `parent` (see the readme).
 * Breadcrumbs are now rendered with `<%= breadcrumbs %>`, although you can still use the old `<%= breadcrumb %>` (without *s*).
-* You can now access view helpers from inside `Gretel::Crumbs.layout do .. end`.
+* You can now access view helpers from inside `Gretel::Crumbs.layout do .. end`.

data/Gemfile

@@ -1,17 +1,6 @@
 source "http://rubygems.org"
 
-# Declare your gem's dependencies in gretel.gemspec.
-# Bundler will treat runtime dependencies like base dependencies, and
-# development dependencies will be added by default to the :development group.
 gemspec
 
-# jquery-rails is used by the dummy application
-gem "jquery-rails"
-
-# Declare any dependencies that are still in development here instead of in
-# your gemspec. These might include edge Rails or gems from your path or
-# Git. Remember to move these dependencies to your gemspec before releasing
-# your gem to rubygems.org.
-
-# To use debugger
-# gem 'debugger'
+rails_version = ENV['RAILS_VERSION'] || '>= 0'
+gem 'rails', rails_version

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2013 Lasse Bunk
+Copyright (c) 2010-2020 Lasse Bunk
 
 MIT License
 
@@ -19,4 +19,4 @@ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -1,4 +1,4 @@
-<a href="http://travis-ci.org/lassebunk/gretel"><img src="https://secure.travis-ci.org/lassebunk/gretel.png" alt="Build Status" /></a>
+<a href="http://travis-ci.org/kzkn/gretel"><img src="https://secure.travis-ci.org/kzkn/gretel.png" alt="Build Status" /></a>
 
 <img src="http://i.imgur.com/CAKEaBM.png" alt="Handle breadcrumb trails... like a boss :)" />
 
@@ -6,24 +6,7 @@
 It is based around the idea that breadcrumbs are a concern of the view, so you define a set of breadcrumbs in *config/breadcrumbs.rb* (or multiple files; see below) and specify in the view which breadcrumb to use.
 Gretel also supports [semantic breadcrumbs](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=185417) (those used in Google results).
 
-Have fun! And please do write, if you (dis)like it – [lassebunk@gmail.com](mailto:lassebunk@gmail.com).
-
-## New in version 3.0
-
-* Breadcrumbs can now be rendered in different styles like ul- and ol lists, and for use with the [Twitter Bootstrap](http://getbootstrap.com/) framework. See the `:style` option below for more info.
-* Defining breadcrumbs using `Gretel::Crumbs.layout do ... end` in an initializer has been removed. See below for details on how to upgrade.
-* The `:show_root_alone` option is now called `:display_single_fragment` and can be used to hide the breadcrumbs when there is only one link, also if it is not the root breadcrumb.
-  The old `:show_root_alone` option is still supported until Gretel version 4.0 and will show a deprecation warning when it's used.
-* Links yielded from `<%= breadcrumbs do |links| %>` now have a `current?` helper that returns true if the link is the last in the trail.
-* New view helper: `parent_breadcrumb` returns the parent breadcrumb link (with `#key`, `#text`, and `#url`). This can for example be used to create a dynamic back link.
-  You can supply options like `:autoroot` etc.
-  If you supply a block, it will yield the parent breadcrumb if it is present.
-* Breadcrumbs can now be inferred if you pass in an instance of an object that responds to `model_name` (like an ActiveRecord model instance). E.g. `breadcrumb @product` is short for `breadcrumb :product, @product`.
-
-
-I hope you find these changes as useful as I did – if you have more suggestions, please create an [Issue](https://github.com/lassebunk/gretel/issues) or [Pull Request](https://github.com/lassebunk/gretel/pulls).
-
-See below for more info or the [changelog](https://github.com/lassebunk/gretel/blob/master/CHANGELOG.md) for less significant changes.
+Have fun!
 
 ## Installation
 
@@ -84,7 +67,7 @@ This will generate the following HTML (indented for readability):
 
 ```html
 <div class="breadcrumbs">
-  You are here:
+  <span class="pretext">You are here:</span>
   <a href="/">Home</a> &rsaquo;
   <a href="/issues">All issues</a> &rsaquo;
   <span class="current">My Issue</span>
@@ -97,17 +80,21 @@ You can pass options to `<%= breadcrumbs %>`, e.g. `<%= breadcrumbs pretext: "Yo
 
 Option                   | Description                                                                                                                | Default
 ------------------------ | -------------------------------------------------------------------------------------------------------------------------- | -------
-:style                   | How to render the breadcrumbs. Can be `:default`, `:ol`, `:ul`, or `:bootstrap`. See below for more info.                  | `:default`
+:style                   | How to render the breadcrumbs. Can be `:inline`, `:ol`, `:ul`, or `:bootstrap`. See below for more info.                   | `:inline`
 :pretext                 | Text to be rendered before breadcrumb, e.g. `"You are here: "`.                                                            | None
 :posttext                | Text to be appended after breadcrumb, e.g. `"Text after breacrumb"`,                                                       | None
 :separator               | Separator between links, e.g. `" &rsaquo; "`.                                                                              | `" &rsaquo; "`
 :autoroot                | Whether it should automatically link to the `:root` crumb if no parent is given.                                           | True
 :display_single_fragment | Whether it should display the breadcrumb if it includes only one link.                                                     | False
 :link_current            | Whether the current crumb should be linked to.                                                                             | False
+:link_current_to_request_path            | Whether the current crumb should always link to the current request path. *Note:* This option will have no effect unless `:link_current` is set to `true`.                                                                             | True
 :semantic                | Whether it should generate [semantic breadcrumbs](http://support.google.com/webmasters/bin/answer.py?hl=en&answer=185417). | False
 :id                      | ID for the breadcrumbs container.                                                                                          | None
-:class                   | CSS class for the breadcrumbs container.                                                                                   | `"breadcrumbs"`
-:current_class           | CSS class for the current link or span.                                                                                    | `"current"`
+:class                   | CSS class for the breadcrumbs container. Can be set to `nil` for no class.                                                 | `"breadcrumbs"`
+:fragment_class          | CSS class for the fragment link or span. Can be set to `nil` for no class.                                                 | None
+:current_class           | CSS class for the current link or span. Can be set to `nil` for no class.                                                  | `"current"`
+:pretext_class           | CSS class for the pretext, if given. Can be set to `nil` for no class.                                                     | `"pretext"`
+:posttext_class          | CSS class for the posttext, if given. Can be set to `nil` for no class.                                                    | `"posttext"`
 :container_tag           | Tag type that contains the breadcrumbs.                                                                                    | `:div`
 :fragment_tag            | Tag type to contain each breadcrumb fragment/link.                                                                         | None
 
@@ -117,15 +104,16 @@ These are the styles you can use with `breadcrumbs style: :xx`.
 
 Style          | Description
 -------------- | -----------
-`:default`     | Renders each link by itself with `&rsaquo;` as the seperator.
+`:inline`      | Renders each link by itself with `&rsaquo;` as the seperator.
 `:ol`          | Renders the links in `<li>` elements contained in an outer `<ol>`.
 `:ul`          | Renders the links in `<li>` elements contained in an outer `<ul>`.
 `:bootstrap`   | Renders the links for use in [Twitter Bootstrap](http://getbootstrap.com/).
+`:bootstrap4`  | Renders the links for use in [Bootstrap v4](https://getbootstrap.com/).
 `:foundation5` | Renders the links for use in [Foundation 5](http://foundation.zurb.com/).
 
 Or you can build the breadcrumbs manually for full customization; see below.
 
-If you add other widely used styles, please submit a [Pull Request](https://github.com/lassebunk/gretel/pulls) so others can use them too.
+If you add other widely used styles, please submit a [Pull Request](https://github.com/kzkn/gretel/pulls) so others can use them too.
 
 ## More examples
 
@@ -145,10 +133,10 @@ end
 # Parent crumbs
 crumb :project_issues do |project|
   link "Issues", project_issues_path(project)
-  parent :project, project
+  parent project # inferred to :project
 end
 
-# Child 
+# Child
 crumb :issue do |issue|
   link issue.name, issue_path(issue)
   parent :project_issues, issue.project
@@ -158,7 +146,7 @@ end
 crumb :category do |category|
   link category.name, category
   if category.parent
-    parent :category, category.parent
+    parent category.parent # inferred to :category
   else
     parent :categories
   end
@@ -167,7 +155,7 @@ end
 # Product crumb with recursive parent categories (as defined above)
 crumb :product do |product|
   link product.name, product
-  parent :category, product.category
+  parent product.category # inferred to :category
 end
 
 # Crumb with multiple links
@@ -188,7 +176,7 @@ crumb :product do |product|
   if keyword = params[:q].presence
     parent :search, keyword
   else # default
-    parent :category, product.category
+    parent product.category # inferred to :category
   end
 end
 
@@ -217,10 +205,10 @@ end
 
 ## Building the breadcrumbs manually
 
-If you supply a block to the `breadcrumbs` method, it will yield an array with the breadcrumb links so you can build the breadcrumbs HTML manually:
+You can use the `breadcrumbs` method directly as an array. It will return an array with the breadcrumb links so you can build the breadcrumbs HTML manually:
 
 ```erb
-<% breadcrumbs do |links| %>
+<% breadcrumbs.tap do |links| %>
   <% if links.any? %>
     You are here:
     <% links.each do |link| %>
@@ -347,7 +335,8 @@ in `config/breadcrumbs.rb`.
 ## Documentation
 
 * [Full documentation](http://rubydoc.info/gems/gretel)
-* [Changelog](https://github.com/lassebunk/gretel/blob/master/CHANGELOG.md)
+* [Changelog](https://github.com/kzkn/gretel/blob/master/CHANGELOG.md)
+* [Tutorial on using Gretel](http://www.sitepoint.com/breadcrumbs-rails-gretel/) (Sitepoint)
 
 ## Versioning
 
@@ -362,17 +351,22 @@ To contribute:
 1. Fork the project
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Make your changes
-4. Add tests
-5. Run `rake` to make sure all tests pass
-6. Commit your changes (`git commit -am 'Add new feature'`)
-7. Push to the branch (`git push origin my-new-feature`)
-8. Create new pull request
+4. Add/Fix tests
+5. Prepare database for testing: `cd test/dummy; rake db:migrate; rake db:test:prepare; cd ../..`
+6. Run `rake` to make sure all tests pass
+7. Be sure to check in the changes to `coverage/coverage.txt`
+8. Commit your changes (`git commit -am 'Add new feature'`)
+9. Push to the branch (`git push origin my-new-feature`)
+10. Create new pull request
 
 Thanks.
 
 ## Contributors
 
-* [See the list of contributors](https://github.com/lassebunk/gretel/graphs/contributors)
+Gretel was created by [@lassebunk](https://github.com/lassebunk) and was maintained by [@WilHall](https://github.com/WilHall).
+And it is maintained by [@kzkn](https://github.com/kzkn).
+
+[See the list of contributors](https://github.com/kzkn/gretel/graphs/contributors)
 
 ## And then
 
@@ -380,4 +374,4 @@ Thanks.
 
 Have fun!
 
-Copyright (c) 2010-2013 [Lasse Bunk](http://lassebunk.dk), released under the MIT license
+Copyright (c) 2010-2020 [Lasse Bunk](http://lassebunk.dk), released under the MIT license

data/Rakefile

@@ -7,4 +7,4 @@ Rake::TestTask.new do |t|
   t.verbose = true
 end
 
-task default: :test
+task default: :test

data/coverage/coverage.txt

@@ -0,0 +1,6 @@
+--------------------------------------------------------------------------------
+Incomplete test coverage
+--------------------------------------------------------------------------------
+
+/lib/gretel/renderer.rb: 99.12% (missed: 45)
+/test/helper_methods_test.rb: 99.24% (missed: 17,196)

data/gretel.gemspec

@@ -6,18 +6,21 @@ require 'gretel/version'
 Gem::Specification.new do |gem|
   gem.name          = "gretel"
   gem.version       = Gretel::VERSION
-  gem.authors       = ["Lasse Bunk"]
-  gem.email         = ["lassebunk@gmail.com"]
+  gem.authors       = ["Lasse Bunk", "Kazuki Nishikawa"]
+  gem.email         = ["kzkn@users.noreply.github.com"]
   gem.description   = %q{Gretel is a Ruby on Rails plugin that makes it easy yet flexible to create breadcrumbs.}
   gem.summary       = %q{Flexible Ruby on Rails breadcrumbs plugin.}
-  gem.homepage      = "http://github.com/lassebunk/gretel"
+  gem.homepage      = "http://github.com/kzkn/gretel"
   gem.license       = "MIT"
 
   gem.files         = `git ls-files`.split($/)
   gem.test_files    = gem.files.grep(%r{^test/})
   gem.require_paths = ["lib"]
 
-  gem.add_dependency "rails", ">= 3.2.0"
-  gem.add_development_dependency "rails", "~> 3.2.13"
+  gem.add_dependency "rails", ">= 5.1"
   gem.add_development_dependency "sqlite3"
-end
+  gem.add_development_dependency "jquery-rails"
+  gem.add_development_dependency "test-unit", "~> 3.0"
+  gem.add_development_dependency "simplecov", "~> 0.18.0"
+  gem.add_development_dependency "simplecov-erb", "~> 0.1"
+end

data/lib/gretel.rb

@@ -5,7 +5,6 @@ require 'gretel/crumb'
 require 'gretel/link'
 require 'gretel/renderer'
 require 'gretel/view_helpers'
-require 'gretel/deprecated'
 
 module Gretel
   class << self
@@ -16,7 +15,9 @@ module Gretel
     # breadcrumbs set in engines.
     def breadcrumb_paths
       @breadcrumb_paths ||= begin
-        engine_roots = Rails::Application::Railties.engines.map { |e| e.config.root }
+        engines = Rails::Engine.subclasses.map(&:instance)
+
+        engine_roots = engines.map { |e| e.config.root }
         
         [*engine_roots, Rails.root].map do |root|
           [root.join("config", "breadcrumbs.rb"),
@@ -31,24 +32,6 @@ module Gretel
       @breadcrumb_paths = paths
     end
 
-    # Whether to suppress deprecation warnings.
-    def suppress_deprecation_warnings?
-      !!@suppress_deprecation_warnings
-    end
-
-    # Sets whether to suppress deprecation warnings.
-    def suppress_deprecation_warnings=(value)
-      @suppress_deprecation_warnings = value
-    end
-
-    # Shows a deprecation warning.
-    def show_deprecation_warning(message)
-      return if suppress_deprecation_warnings?
-      message = "[Gretel] #{message}"
-      puts message
-      Rails.logger.warn message
-    end
-
     # Array of Rails environment names with automatic configuration reload. Default is +["development"]+.
     def reload_environments
       @reload_environments ||= ["development"]
@@ -75,4 +58,4 @@ module Gretel
   end
 end
 
-ActionView::Base.send :include, Gretel::ViewHelpers
+ActionView::Base.send :include, Gretel::ViewHelpers

data/lib/gretel/crumb.rb

@@ -3,6 +3,12 @@ module Gretel
     # Initializes a new crumb from the given +key+.
     # It finds the breadcrumb created in +Gretel::Crumbs.layout+ and renders the block using the arguments supplied in +args+.
     def initialize(context, key, *args)
+      if key.class.respond_to?(:model_name)
+        # Enables calling `breadcrumb @product` instead of `breadcrumb :product, @product`
+        args.unshift key
+        key = key.class.model_name.to_s.underscore.to_sym
+      end
+
       block = Gretel::Crumbs.crumbs[key]
       raise ArgumentError, "Breadcrumb :#{key} not found." unless block
       @key = key
@@ -38,6 +44,9 @@ module Gretel
     #
     # Example:
     #   parent :category, category
+    #
+    # Or short, which will infer the key from the model's `model_name`:
+    #   parent category
     def parent(*args)
       return @parent if args.empty?
       key = args.shift
@@ -51,7 +60,7 @@ module Gretel
     # The current view context.
     attr_reader :context
 
-    # Proxy to view context
+    # Proxy to view context.
     def method_missing(method, *args, &block)
       context.send(method, *args, &block)
     end

data/lib/gretel/renderer.rb

@@ -1,24 +1,28 @@
 module Gretel
   class Renderer
     DEFAULT_OPTIONS = {
-      style: :default,
+      style: :inline,
       pretext: "",
       posttext: "",
       separator: "",
       autoroot: true,
       display_single_fragment: false,
       link_current: false,
+      link_current_to_request_path: true,
       semantic: false,
       class: "breadcrumbs",
       current_class: "current",
+      pretext_class: "pretext",
+      posttext_class: "posttext",
       id: nil
     }
 
     DEFAULT_STYLES = {
-      default: { container_tag: :div, separator: " › " },
+      inline: { container_tag: :div, separator: " › " },
       ol: { container_tag: :ol, fragment_tag: :li },
       ul: { container_tag: :ul, fragment_tag: :li },
       bootstrap: { container_tag: :ol, fragment_tag: :li, class: "breadcrumb", current_class: "active" },
+      bootstrap4: { container_tag: :ol, fragment_tag: :li, class: "breadcrumb", fragment_class: "breadcrumb-item", current_class: "active" },
       foundation5: { container_tag: :ul, fragment_tag: :li, class: "breadcrumbs", current_class: "current" }
     }
 
@@ -33,32 +37,17 @@ module Gretel
       options = options_for_render(options)
       links = links_for_render(options)
 
-      return "" if links.empty?
-
-      # Loop through all but the last (current) link and build HTML of the fragments
-      fragments = links[0..-2].map do |link|
-        render_fragment(options[:fragment_tag], link.text, link.url, options[:semantic])
-      end
-
-      # The current link is handled a little differently, and is only linked if specified in the options
-      current_link = links.last
-      fragments << render_fragment(options[:fragment_tag], current_link.text, (options[:link_current] ? current_link.url : nil), options[:semantic], class: options[:current_class])
-
-      # Build the final HTML
-      html = (options[:pretext] + fragments.join(options[:separator]) + options[:posttext]).html_safe
-      content_tag(options[:container_tag], html, id: options[:id], class: options[:class])
+      LinkCollection.new(context, links, options)
     end
 
     # Yields links with applied options.
     def yield_links(options = {})
-      options = options_for_render(options)
-      yield links_for_render(options)
+      yield render(options)
     end
 
     # Returns the parent breadcrumb.
     def parent_breadcrumb(options = {})
-      options = options_for_render(options)
-      links_for_render(options)[-2]
+      render(options)[-2]
     end
 
     # Yields the parent breadcrumb if any.
@@ -68,11 +57,6 @@ module Gretel
       end
     end
 
-    # Proxy for +context.link_to+ that can be overridden by plugins.
-    def breadcrumb_link_to(name, url, options = {})
-      context.link_to(name, url, options)
-    end
-
     private
 
     attr_reader :context, :breadcrumb_key, :breadcrumb_args
@@ -102,7 +86,7 @@ module Gretel
       end
 
       # Set current link to actual path
-      if out.any? && request
+      if options[:link_current_to_request_path] && out.any? && request
         out.last.url = request.fullpath
       end
 
@@ -129,7 +113,7 @@ module Gretel
 
         # Links of first crumb
         links = crumb.links.dup
-        
+
         # Get parent links
         links.unshift *parent_links_for(crumb)
 
@@ -148,52 +132,16 @@ module Gretel
       links
     end
 
-    # Renders HTML for a breadcrumb fragment, i.e. a breadcrumb link.
-    def render_fragment(fragment_tag, text, url, semantic, options = {})
-      if semantic
-        render_semantic_fragment(fragment_tag, text, url, options)
-      else
-        render_nonsemantic_fragment(fragment_tag, text, url, options)
-      end
-    end
-
-    # Renders semantic fragment HTML.
-    def render_semantic_fragment(fragment_tag, text, url, options = {})
-      if fragment_tag
-        text = content_tag(:span, text, itemprop: "title")
-        text = breadcrumb_link_to(text, url, itemprop: "url") if url.present?
-        content_tag(fragment_tag, text, class: options[:class], itemscope: "", itemtype: "http://data-vocabulary.org/Breadcrumb")
-      elsif url.present?
-        content_tag(:div, breadcrumb_link_to(content_tag(:span, text, itemprop: "title"), url, class: options[:class], itemprop: "url"), itemscope: "", itemtype: "http://data-vocabulary.org/Breadcrumb")
-      else
-        content_tag(:div, content_tag(:span, text, class: options[:class], itemprop: "title"), itemscope: "", itemtype: "http://data-vocabulary.org/Breadcrumb")
-      end
-    end
-
-    # Renders regular, non-semantic fragment HTML.
-    def render_nonsemantic_fragment(fragment_tag, text, url, options = {})
-      if fragment_tag
-        text = breadcrumb_link_to(text, url) if url.present?
-        content_tag(fragment_tag, text, class: options[:class])
-      elsif url.present?
-        breadcrumb_link_to(text, url, class: options[:class])
-      elsif options[:class].present?
-        content_tag(:span, text, class: options[:class])
-      else
-        text
-      end
-    end
-
-    # Proxy to view context
+    # Proxy to view context.
     def method_missing(method, *args, &block)
       context.send(method, *args, &block)
     end
 
     class << self
       include Resettable
-      
+
       # Registers a style for later use.
-      # 
+      #
       #   Gretel::Renderer.register_style :ul, { container_tag: :ul, fragment_tag: :li }
       def register_style(style_key, options)
         styles[style_key] = options
@@ -204,5 +152,110 @@ module Gretel
         @styles ||= DEFAULT_STYLES
       end
     end
+
+    class LinkCollection < Array
+      attr_reader :context, :links, :options
+
+      def initialize(context, links, options = {})
+        @context, @links, @options = context, links, options
+        concat links
+      end
+
+      # Helper for returning all link keys to allow for simple testing.
+      def keys
+        map(&:key)
+      end
+
+      # Renders the links into breadcrumbs.
+      def render
+        return "" if links.empty?
+
+        # Loop through all but the last (current) link and build HTML of the fragments
+        fragments = links[0..-2].map do |link|
+          render_fragment(options[:fragment_tag], link.text, link.url, options[:semantic], fragment_class: options[:fragment_class])
+        end
+
+        # The current link is handled a little differently, and is only linked if specified in the options
+        current_link = links.last
+        fragments << render_fragment(options[:fragment_tag], current_link.text, (options[:link_current] ? current_link.url : nil), options[:semantic], fragment_class: options[:fragment_class], class: options[:current_class], current_link: current_link.url)
+
+        # Build the final HTML
+        html_fragments = []
+
+        if options[:pretext].present?
+          html_fragments << content_tag(:span, options[:pretext], class: options[:pretext_class])
+        end
+
+        html_fragments << fragments.join(options[:separator])
+
+        if options[:posttext].present?
+          html_fragments << content_tag(:span, options[:posttext], class: options[:posttext_class])
+        end
+
+        html = html_fragments.join(" ").html_safe
+        content_tag(options[:container_tag], html, id: options[:id], class: options[:class])
+      end
+
+      alias :to_s :render
+
+      # Renders HTML for a breadcrumb fragment, i.e. a breadcrumb link.
+      def render_fragment(fragment_tag, text, url, semantic, options = {})
+        if semantic
+          render_semantic_fragment(fragment_tag, text, url, options)
+        else
+          render_nonsemantic_fragment(fragment_tag, text, url, options)
+        end
+      end
+
+      # Renders semantic fragment HTML.
+      def render_semantic_fragment(fragment_tag, text, url, options = {})
+        fragment_class = [options[:fragment_class], options[:class]].join(' ').strip
+        fragment_class = nil if fragment_class.blank?
+
+        if fragment_tag
+          text = content_tag(:span, text, itemprop: "title")
+
+          if url.present?
+            text = breadcrumb_link_to(text, url, itemprop: "url")
+          elsif options[:current_link].present?
+            current_url = "#{root_url}#{options[:current_link].gsub(/^\//, '')}"
+            text = text + tag(:meta, itemprop: "url", content: current_url)
+          end
+
+          content_tag(fragment_tag, text, class: fragment_class, itemscope: "", itemtype: "http://data-vocabulary.org/Breadcrumb")
+        elsif url.present?
+          content_tag(:span, breadcrumb_link_to(content_tag(:span, text, itemprop: "title"), url, class: fragment_class, itemprop: "url"), itemscope: "", itemtype: "http://data-vocabulary.org/Breadcrumb")
+        else
+          content_tag(:span, content_tag(:span, text, class: fragment_class, itemprop: "title"), itemscope: "", itemtype: "http://data-vocabulary.org/Breadcrumb")
+        end
+      end
+
+      # Renders regular, non-semantic fragment HTML.
+      def render_nonsemantic_fragment(fragment_tag, text, url, options = {})
+        fragment_class = [options[:fragment_class], options[:class]].join(' ').strip
+        fragment_class = nil if fragment_class.blank?
+
+        if fragment_tag
+          text = breadcrumb_link_to(text, url) if url.present?
+          content_tag(fragment_tag, text, class: fragment_class)
+        elsif url.present?
+          breadcrumb_link_to(text, url, class: fragment_class)
+        elsif options[:class].present?
+          content_tag(:span, text, class: fragment_class)
+        else
+          text
+        end
+      end
+
+      # Proxy for +context.link_to+ that can be overridden by plugins.
+      def breadcrumb_link_to(name, url, options = {})
+        context.link_to(name, url, options)
+      end
+
+      # Proxy to view context.
+      def method_missing(method, *args, &block)
+        context.send(method, *args, &block)
+      end
+    end
   end
 end