README.md

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