Ancestry is a handy gem for building tree structures or taxonomies in your Rails applications. It’s similar to the likes of the acts_as_tree plugin (see the Railscasts tutorial). The project wiki has several ideas for ways to put Ancestry to use; in this post I’ll cover a couple of basic uses to get you rolling with some common applications of the gem.
Follow the instructions provided in Ancestry’s README to add it to your application. It’s very straightforward: Install the gem, generate and run a migration, and add
has_ancestry to any model you’d like to turn into a tree. For example, you might have a hierarchy of categories; once you’ve installed Ancestry this can be created with
The nice thing about Ancestry is how easy it makes it to work with a given object in your tree, its parents, and its children. It does this through more than 20 useful instance methods and several scopes. Among the ones you may want to start with:
@category.childrengives you a collection of a given category’s subcategories.
@category.parentwill give you the category’s parent category. Useful if you want to include a back link in your view.
A practical use of Ancestry is to help visitors navigate your site through breadcrumbs. This is easy to add to your view:
That’s all there is to it to help your site visitors navigate your content more easily.
If you liked my series on practical advice for adding reliable tests to your Rails apps, check out the expanded ebook version. Lots of additional, exclusive content and a complete sample Rails application.
Ruby on Rails news and tips, and other ideas and surprises from Aaron at Everyday Rails. Delivered to your inbox on no particular set schedule.