radiant-find_by_id_tag-extension 1.0.0 → 1.1.0

data/README.md

@@ -1,5 +1,15 @@
 # Find By Id Tag
 
-Extends r:find with an 'id' attribute so your page structure can change without breaking links.
+This extension allows you to use r:find with an 'id' attribute instead of the usual 'path' attribute. This way the r:find tag will stay intact even if the path of the target page changes.
+An 'ids' attribute was also added to r:aggregate to use instead of 'paths'.
+
+Important benefit is that this is also much faster than finding a page by path;
+
+    >> Benchmark.measure { Page.find(2546) }
+    =>   0.000000   0.000000   0.000000 (  0.003986)
+
+    >> Benchmark.measure { Page.find_by_path('/farm-forestry-model/species/eucalypts/growing-eucalypts-for-timber---videos-and-information/videos/') }
+    =>   0.020000   0.010000   0.030000 (  0.027044)
+
 
 Created by Benny Degezelle for nzffa.org.nz 

data/lib/find_by_id/tag_extension.rb

@@ -1,28 +1,50 @@
 module FindById::TagExtension
   include Radiant::Taggable
   
-  
-    desc %{
-      Inside this tag all page related tags refer to the page found at the @path@ attribute.
-      @path@s may be relative or absolute paths.
-      If an @id@ attribute is passed, the path attribute will be ignored
-      *Usage:*
+  desc %{
+    Inside this tag all page related tags refer to the page found at the @path@ attribute.
+    @path@s may be relative or absolute paths.
+    If an @id@ attribute is passed, the path attribute will be ignored
+    *Usage:*
 
-      <pre><code><r:find path="value_to_find">...</r:find></code></pre>
-    }
-    tag 'find' do |tag|
-      required_attr(tag,'path','url','id')
+    <pre><code><r:find path="value_to_find">...</r:find></code></pre>
+  }
+  tag 'find' do |tag|
+    required_attr(tag,'path','url','id')
 
-      if id = tag.attr.delete('id')
-        found = Page.find(id.to_i)
-      else
-        path = tag.attr['path'] || tag.attr['url']
-        found = Page.find_by_path(absolute_path_for(tag.locals.page.path, path))
-      end
-      if page_found?(found)
-        tag.locals.page = found
-        tag.expand
-      end
+    if id = tag.attr.delete('id')
+      found = Page.find(id.to_i)
+    else
+      path = tag.attr['path'] || tag.attr['url']
+      found = Page.find_by_path(absolute_path_for(tag.locals.page.path, path))
+    end
+    if page_found?(found)
+      tag.locals.page = found
+      tag.expand
     end
+  end
+
+  desc %{
+    Aggregates the children of multiple paths using the @paths@ or @ids@ attribute.
+    Useful for combining many different sections/categories into a single
+    feed or listing.
+    
+    *Usage*:
+    
+    <pre><code><r:aggregate paths="/section1; /section2; /section3"> ... </r:aggregate>
+    <r:aggregate ids="4; 6; 7"> ... </r:aggregate></code></pre>
+  }
+  tag "aggregate" do |tag|
+    required_attr(tag, 'paths', 'urls', 'ids')
+    if ids = tag.attr.delete('ids')
+      tag.locals.parent_ids = ids.split(';').map(&:strip).reject(&:blank?)
+    else
+      paths = (tag.attr['paths']||tag.attr["urls"]).split(";").map(&:strip).reject(&:blank?).map { |u| clean_path u }
+      parent_ids = paths.map {|u| Page.find_by_path(u) }.map(&:id)
+      tag.locals.parent_ids = parent_ids
+    end
+    tag.expand
+  end
+  
 
 end

data/lib/radiant-find_by_id_tag-extension.rb

@@ -1,7 +1,7 @@
 module RadiantFindByIdTagExtension
-  VERSION     = "1.0.0"
+  VERSION     = "1.1.0"
   SUMMARY     = "Find By Id Tag for Radiant CMS"
-  DESCRIPTION = "Adds id attribute to r:find"
+  DESCRIPTION = "Adds support for an 'id' attribute to r:find"
   URL         = "http://github.com/jomz/radiant-find_by_id_tag-extension"
   AUTHORS     = ["Benny Degezelle"]
   EMAIL       = ["hi@monkeypatch.be"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: radiant-find_by_id_tag-extension
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,9 +9,9 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-01 00:00:00.000000000 Z
+date: 2016-06-07 00:00:00.000000000 Z
 dependencies: []
-description: Adds id attribute to r:find
+description: Adds support for an 'id' attribute to r:find
 email:
 - hi@monkeypatch.be
 executables: []
@@ -23,6 +23,7 @@ files:
 - lib/find_by_id/tag_extension.rb
 - lib/radiant-find_by_id_tag-extension.rb
 - lib/tasks/find_by_id_tag_extension_tasks.rake
+- radiant-find_by_id_tag-extension-1.0.0.gem
 - radiant-find_by_id_tag-extension.gemspec
 - Rakefile
 - README.md