Add two new methods to the Nesta::Page class that finds any subpages
for an index page. A subpage is considered to be a sibling page in the
same directory as the index page and any index pages within immediate
subdirectories. For example:
/content/pages/parent/
/content/pages/parent/index.mdown
/content/pages/parent/page-1.mdown
/content/pages/parent/page-2.mdown
/content/pages/parent/subdir-1/
/content/pages/parent/subdir-1/index.haml
/content/pages/parent/subdir-2/
/content/pages/parent/subdir-2/some-other-pages.mdown
Page.find_by_path('parent').subpages() => [page-1, page-2, subdir-1]
The returned array contains the Page instances themselves, not their string paths, and they will be sorted based on their titles.
Next, there is also #has_subpages? helper method that returns true or
false if the page has any subpages.
Subpages are cached within an instance variable the first time that
#subpages is called, but this should not be a problem in most cases.
Also, there is a helper defined called subpages_for that takes either
a Page instance or a string path and returns the same array.
Lastly, if for some reason you do not want a subpage listed, merely
give it the metadata tag of skip subpage: true and it will indeed be
skipped in the list.
There are two options that you can pass to subpages in a hash to
modify what it does:
:do_sort - Defaults to true; sorts the pages by title.
:include_subdirs - Defaults to true; includes index pages of
immediate subdirectories.
Also, if you give the method a block, each page will be yielded and the method will return nil.
Add this line to your application's Gemfile:
gem 'nesta-plugin-subpages'
And then execute:
$ bundle
Or install it yourself as:
$ gem install nesta-plugin-subpages
Not much to do! Simply call the #subpages method on your Page object
when you want to use the array of subpages! Easy peasy, m'friend. For
example, in the sidebar, you might do this:
- if @page.has_subpages?
#nav.subpages
%h1 Subpages
- display_menu(@page.subpages, :class => "menu")
Or, if you wanna iterate of the pages:
- @page.subpages do |page|
= page.title
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Added some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request