Spree Taxon Group

Easily create and manage groups of taxons, irrespective of their parent or children taxons/taxonomies and control the position/order of taxons in their groups. Useful if you need flexible taxon usage, for example a group of taxons for featured categories from different parent taxon/taxonomies.

Usage

If you want a taxon tree, similar to taxons_tree in the default spree sidebar. You can use the helper taxon_group_tree:

<nav id="featured-categories" class="sidebar-item" data-hook>
<% featured = Spree::TaxonGroup.find_by_key('featured') %>
<% cache [I18n.locale, featured] do %>
<h4 class='taxon-group-root'><%= Spree.t(:shop_by_taxon_group, :taxon_group => featured.name) %></h4>
<%= taxon_group_tree(featured, @taxon) %>
<% end %>
</nav>

or for more control, without taxon_group_tree:

<% navigation_taxon_upcase_group = Spree::TaxonGroup.find_by_key('navigation') %>
<% cache [I18n.locale, navigation_taxon_upcase_group] do %>
<%= navigation_taxon_upcase_group.taxons.map do |taxon|
'<li class="hidden-lg hidden-md">' + link_to(taxon.name.upcase, seo_url(taxon)) + '</li>'
end.join("\n").html_safe
%>
<% end %>

Basic Installation

Add to your Gemfile:

gem 'spree_taxon_group', '3.1.0.beta'

Run:

bundle && bundle exec rails g spree_taxon_group:install

That's it!

Contributing

See corresponding guidelines and check out the issues.

Copyright (c) 2015 James Whelton and contributors, released under the New BSD License