hobo_rapid 1.4.0.pre2

data/taglibs/pages/forgot_password.dryml

@@ -0,0 +1,62 @@
+<!-- The page that initiates the forgotten password process. Contains a single text-input where the user can provide
+ their email address -->
+<def tag="forgot-password-page">
+  <simple-page title="#{t 'hobo.forgot_password.title', :default=>['Forgotten Password'] }" merge>
+
+    <body: class="forgot-password-page" param/>
+
+    <content: param>
+      <header param="content-header">
+        <h2 param="heading"><t key="hobo.forgot_password.heading">Forgotten Password</t></h2>
+        <p><t key="hobo.forgot_password.text">Enter the email address you signed up with. If we have it in
+        our records we'll send you an email allowing you to choose a new
+        password.</t></p>
+      </header>
+
+      <section param="content-body">
+        <form action="" class="forgot-password" param>
+          <labelled-item-list param>
+            <labelled-item>
+              <item-label param="email-address-label"><t key="hobo.forgot_password.email_address">Email Address</t></item-label>
+              <item-value>
+                <input type="text" name="email_address" id="email-address" class="email-address" param="email-address-input" />
+              </item-value>
+            </labelled-item>
+          </labelled-item-list>
+          <div param="actions">
+            <submit label="#{t 'hobo.actions.send', :default=>['Send'] }" param/>
+          </div>
+        </form>
+      </section>
+    </content:>
+
+  </simple-page>
+</def>
+
+
+<!-- Second page in the forgotten password process. Informs the user that the email has been sent "If the e-mail address you
+entered is in our records". This is to avoid a privacy concern that the forgotten-password mechanism can be otherwise used to tell
+if a given email is associated with an account or not. -->
+<def tag="forgot-password-email-sent-page">
+  <simple-page title="#{t 'hobo.forgot_password_sent.title', :default=>['Forgotten Password - Sent'] }" merge>
+    <body: class="forgot-password-page" param/>
+
+    <content: param>
+      <header param="content-header">
+        <h2 param><t key="hobo.forgot_password_sent.heading">Forgotten Password - Sent</t></h2>
+      </header>
+
+      <section param="content-body">
+        <p param="message">
+        	<t key="hobo.forgot_password_sent.text" email-address="#{params[:email_address]}">
+        	If the e-mail address you entered, <%= h params[:email_address] %>,
+          is in our records, you will
+        receive an e-mail from us with instructions for resetting your
+        password. If you don't receive this e-mail, please check your
+        junk mail folder.</t></p>
+        <p><a href="#{base_url}/"><t key="hobo.actions.back">Back to</t> <app-name/></a></p>
+      </section>
+    </content:>
+
+  </simple-page>
+</def>

data/taglibs/pages/login.dryml

@@ -0,0 +1,57 @@
+<!-- Simple log-in form.
+
+### Attributes
+
+ - `user-model`: The User class
+ - all other attributes are passed on to `<form>`.   You will probably need to set the action attribute:  `action="&user_login_path"`.
+ -->
+<def tag="login-form" attrs="user-model">
+  <% user_model ||= self.try.model -%>
+  <form action="&request.fullpath" class="login" merge>
+    <labelled-item-list param>
+      <labelled-item>
+
+        <item-label param="login-label"><t key="hobo.login.#{user_model.login_attribute}"><%= user_model.login_attribute.to_s.titleize %></t></item-label>
+        <item-value><input type="text" name="login" id="login" class="string" param="login-input" /></item-value>
+      </labelled-item>
+
+      <labelled-item>
+        <item-label param="password-label"><t key="hobo.login.password">Password</t></item-label>
+        <item-value>
+          <input type="password" name="password" id="password" class="string" param="password-input"/>
+        </item-value>
+      </labelled-item>
+
+      <labelled-item param="remember-me">
+        <item-label class="field-label" param="remember-me-label"><t key="hobo.login.remember_me">Remember me:</t></item-label>
+        <item-value>
+          <input type="checkbox" name="remember_me" id="remember-me" param="remember-me-input" checked/>
+        </item-value>
+      </labelled-item>
+    </labelled-item-list>
+    <div param="actions">
+      <submit label="#{t 'hobo.actions.login', :default=>['Log in'] }" param/><if test="&signup_url" class='nav-item'>
+      <t key="hobo.support.or">or</t> <a param="signup" href="&signup_url"><t key="hobo.login.signup">Sign up</t></a></if>
+    </div>
+  </form>
+</def>
+
+<!-- Simple log-in page  -->
+<def tag="login-page">
+  <% remember_me = true if remember_me.nil? %>
+  <simple-page title="#{t 'hobo.login.title', :default=>['Log in'] }" merge>
+
+    <body: class="login-page" param/>
+
+    <content: param>
+      <header param="content-header">
+        <h2 param="heading"><t key="hobo.login.heading">Log In</t></h2>
+      </header>
+
+      <section param="content-body">
+        <login-form param="form" user-model="&model"/>
+        <a href="&forgot_password_url" param="forgot-password" if="&forgot_password_url"><t key="hobo.login.forgot_password">Forgot your password?</t></a>
+      </section>
+    </content:>
+  </simple-page>
+</def>

data/taglibs/pages/not_found_page.dryml

@@ -0,0 +1,18 @@
+<!-- The page rendered by default in the case of a not-found error
+
+### Attributes
+
+ - `message` - The main message to display. Defaults to "The page you requested cannot be found."
+
+  -->
+<def tag="not-found-page" attrs="message">
+  <% message ||= t("hobo.messages.not_found", :default=>["The page you requested cannot be found."]) %>
+  <page merge>
+    <body: class="not-found"/>
+    <content: param>
+      <header param="content-header">
+        <h2 param="heading"><message/></h2>
+      </header>
+    </content:>
+  </page>
+</def>

data/taglibs/pages/page_nav.dryml

@@ -0,0 +1,17 @@
+<!--
+A wrapper around the `will_paginate` helper. All [options to
+`will_paginate`](https://github.com/mislav/will_paginate/wiki/the-will_paginate-view-helper)
+are available as attributes.  If you do not specify `params`, it will
+be guessed.  Standard Ajax form attributes are also supported.  See
+the `<a/>` tag for more information on using AJAX with links.
+-->
+<def tag="page-nav">
+  <%  ajax_attrs, attributes = attributes.partition_hash(HoboRapidHelper::AJAX_ATTRS) %>
+  <%= will_paginate this,  attributes.symbolize_keys.reverse_merge(
+         :inner_window => 2,
+         :previous_label => translate("hobo.actions.previous", :default=>"« Prev"),
+         :next_label =>translate("hobo.actions.next", :default=>"Next »"),
+         :params => recognize_page_path.slice(:controller,:action,:id),
+         :extra_attributes => (ajax_attrs.empty? ? {} : {"data-rapid" => {"a" => {"ajax_attrs" => ajax_attrs}}.to_json}),
+         :ignore_params => [:render, :render_options, :"_"]) %>
+</def>

data/taglibs/pages/pages.dryml

@@ -0,0 +1,12 @@
+<!-- Rapid-Pages provides tags for working with entire pages, and
+defines several pages such as the error pages and login pages.  -->
+
+<!-- nodoc. -->
+<def tag="index-page" polymorphic/>
+<!-- nodoc. -->
+<def tag="new-page"   polymorphic/>
+<!-- nodoc. -->
+<def tag="show-page"  polymorphic/>
+<!-- nodoc. -->
+<def tag="edit-page"  polymorphic/>
+

data/taglibs/pages/permission_denied_page.dryml

@@ -0,0 +1,24 @@
+<!-- The page rendered by default in the case of a permission-denied error
+
+### Attributes
+
+ - `message` - The main message to display. Defaults to "That operation is not allowed"
+
+  -->
+<def tag="permission-denied-page" attrs="message">
+  <% message ||= "That operation is not allowed" %>
+  <page merge>
+    <body: class="permission-denied"/>
+    <content: param>
+      <header param="content-header">
+        <h2 param="heading"><message/></h2>
+        <div class="debug" if="&Rails.env.development?">
+          <h3>Exception:</h3>
+          <pre><%= h @permission_error.pretty_inspect %></pre>
+          <h3>params:</h3>
+          <pre><%= h params.pretty_inspect %></pre>
+        </div>
+      </header>
+    </content:>
+  </page>
+</def>

data/taglibs/plus/collection_preview.dryml

@@ -0,0 +1,23 @@
+<!-- Deprecated: use collection-preview instead. -->
+<def tag="preview-with-more"><collection-preview merge/></def>
+
+
+<!-- Captures the common pattern of a list of "the first few" cards, along with a link to the rest. -->
+<def tag="collection-preview" attrs="name">
+  <% model_class = this.member_class
+     name ||= model_class.name.downcase.pluralize -%>
+  <section class="#{name.dasherize} collection-preview" param="default">
+    <h3 param="heading">
+      <ht key="#{model_class.to_s.underscore}.collection.heading" count="&this.size">
+        <do param="heading-content"><%= name.pluralize.titleize %></do>
+      </ht>
+    </h3>
+    <a with="&model_class" action="new" if="&can_create?(model_class.new)" param="new-link">
+      <ht key="#{model_class.to_s.underscore}.actions.new">New <%= model_class.model_name.human %></ht>
+    </a>
+    <collection param/>
+    <unless test="&this.empty? || this.size == model_class.count">
+      <a param="show-all"><ht key="#{model_class.to_s.underscore}.actions.show_all" count="100">Show all <%= name.pluralize.titleize %>...</ht></a>
+    </unless>
+  </section>
+</def>

data/taglibs/plus/filter_menu.dryml

@@ -0,0 +1,103 @@
+<!-- A `<select>` menu intended to act as a filter for index pages.
+
+### Example
+
+Filtering on state is a common use.   Here's the dryml for Order:
+
+    <filter-menu param-name="state" options="&Order::Lifecycle.states.keys" />
+
+And the controller action:
+
+    def index
+      # always validate data given in URL's!!!
+      params[:state]=nil unless Order::Lifecycle.states.include?(params[:state]._?.to_sym)
+      finder = params[:state] ? Order.send(params[:state]) : Order
+      hobo_index finder
+    end
+
+See [Filtering stories by status](/tutorials/agility#filtering_stories_by_status) in the [Agility Tutorial](/tutorials/agility) for an example.
+
+### Attributes
+
+Standard AJAX attributes such as 'update' are supported.   If any are supplied, filter-menu uses Ajax rather than a page refresh.
+
+ - `param-name` - the name of the HTTP parameter to use for the filter
+ - `options` - an array of options or an array of arrays (useful for localized apps) for the menu.
+   It can be omitted if you provide the options as an array or array of arrays in the locale file.
+ - `no-filter` - The text of the first option which indicates no filter is in effect. Defaults to 'All'
+ - `first-value` - the value to be used with the first option. Typically not used,
+ meaning the option has a blank value.
+ - model - the model name (optional: needed if you use the "activerecord.attributes" namespace.
+
+### I18n
+
+It lookups the options attributes in `activerecord.attributes.#{model}.filter_menu.#{param\_name}.options`
+with fallback to `filter_menu.#{param_name}.options`.
+The passed options are used as a default in case the lookup fails.
+Besides the `activerecord.attributes.#{model}.filter_menu.#{param_name}.no_filter` or
+`tags.filter_menu.default.no_filter` key is used as default of the attribute "no-filter"
+(or "All" if no default is found)
+
+### I18n Example
+
+
+    es:
+      activerecord:
+        attributes:
+          <model_name>:
+            filter_menu:
+              period:
+                no_filter: Todos Períodos
+                options:
+                - [ "Hoy", "today" ]
+                - [ "Ayer", "yesterday" ]
+
+or
+
+    es:
+      tags:
+        filter_menu:
+          period:
+            no_filter: Todos Períodos
+            options:
+            - [ "Hoy", "today" ]
+            - [ "Ayer", "yesterday" ]
+
+
+     TIME_PERIODS = %w[today yesterday]
+
+     <t-filter-menu param-name="period" options="&TIME_PERIODS" no-filter="All Periods"/>
+
+  with I18n.locale == :es
+
+     <select name="period">
+       <option value="">Todos Períodos</option>
+       <option value="today">Hoy</option>
+       <option value="yesterday">Ayer</option>
+     </select>
+
+  with I18n.locale == :en (i.e no locale file)
+
+     <select name="period">
+       <option value="">All Periods</option>
+       <option value="today">today</option>
+       <option value="yesterday">yesterday</option>
+     </select>
+
+  -->
+<def tag="filter-menu" attrs="model, param-name, options, no-filter, id, first-value">
+  <% options = t("activerecord.attributes.#{model}.filter_menu.#{param_name}.options", :default=>[:"tags.filter_menu.#{param_name}.options", options])
+     raise ArgumentError, %(You must provide an "options" attribute, or set "activerecord.attributes.#{model}.filter_menu.#{param_name}.options" or "tags.filter_menu.#{param_name}.options" to an Array or to an Array of Arrays
+     in your locale file(s)) unless options.is_a?(Array)
+     no_filter = t("activerecord.attributes.#{model}.filter_menu.#{param_name}.no_filter", :default=>[:"tags.filter_menu.#{param_name}.no_filter", :"tags.filter_menu.default.no_filter", no_filter, "All"])
+     %>
+  <form action="&request.path" method="get" class="filter-menu" merge-attrs="&attributes"  data-rapid="&data_rapid('filter-menu')">
+    <div>
+      <% opt = options.first.kind_of?(Array) ? options.*.last : options
+         selected = opt.detect {|o| o.to_s==params[param_name.gsub('-', '_')] }  %>
+      <select-menu name="&param_name" options="&options" selected="&selected"
+                   first-option="&no_filter" first-value="&first_value" key="&param_name" merge-params/>
+      <hidden-fields for-query-string skip="page,#{param_name}"/>
+    </div>
+  </form>
+</def>

data/taglibs/plus/gravatar.dryml

@@ -0,0 +1,12 @@
+<!-- Renders a gravatar (see [gravatar.com](http://gravatar.com)) image in side a link to `this`. Requires `this` to have an `email_address` field. Normally called with a user record in context.
+
+### Attributes
+
+ - `size` - Size in pixels of the image. Defaults to 80.
+ - `rating` - The rating allowed. Defaults to 'g'. See [gravatar.com](http://gravatar.com) for information on ratings.
+
+ -->
+<def tag="gravatar" attrs="size, rating">
+  <% size ||= 80; rating ||= 'g'; digest = Digest::MD5.hexdigest(this.email_address) -%>
+  <a class="gravatar"><img class="gravatar" src="http://www.gravatar.com/avatar/#{digest}?s=#{size}&r=#{rating}" merge-attrs/></a>
+</def>

data/taglibs/plus/live_search.dryml

@@ -0,0 +1,40 @@
+<!-- Provides an ajax-powered *find-as-you-type* live search field which is hooked up to Hobo's site-side search feature.
+
+Customizing the display of results can be done through customizing the "box" param and the `search-results` tag.  The current definition of `<search-results>` expects results to be returned in `@search_results`.
+
+TODO: currently you have to press 'return' to initiate the search.  This should be easy to fix in hjq-live-search.js - the hard part will probably be in doing it in a way that works in all possible browsers.
+
+### attributes
+
+- action: the path to send the query.  Default is "/search" (actually, site_search_path)
+- query_param: the name of the param to use for the search.  Default is "query"
+
+All other attributes are merged into the form, so standard form attributes are supported.
+ -->
+<def tag="live-search" attrs="query-param, panel-tag">
+  <% attributes[:action] ||= site_search_path %>
+  <% attributes[:update] ||= "search-results-part" %>
+  <% attributes[:message] ||= t("hobo.live_search.spinner_message", :default => "Querying...") %>
+  <% query_param ||= "query" %>
+  <div class="search" data-rapid='{"live-search": {}}'>
+    <form merge-attrs param refocus-form>
+      <input type="hidden" value="2" name="search_version"/>
+      <label for="&query_param" param><t key="hobo.live_search.label">Search</t></label><input type="search" name="&query_param" class="live-search" param/>
+    </form>
+    <% panel_tag ||= 'dialog-box' %>
+    <% title = t("hobo.live_search.results_label", :default => "Search Results") %>
+    <call-tag tag="&panel_tag" position="&{:my => 'right top'}" width="&600" height="&800" id="search-results-box" with="&nil" title="&title" param="box">
+      <do part="search-results-part">
+        <search-results/>
+      </do>
+    </call-tag>
+  </div>
+</def>
+
+<!-- redefining or extending this tag will allow you to customize the display of search results -->
+<def tag="search-results">
+  <section with="&@search_results || []" data-rapid='{"search-results": {}}'>
+    <collection/>
+    <else><t key="hobo.live_search.no_results">Your search returned no matches.</t></else>
+  </section>
+</def>

data/taglibs/plus/plus.dryml

@@ -0,0 +1 @@
+<!-- Tags that define higher level interactive ‘widgets’ -->

data/taglibs/plus/sortable_collection.dryml

@@ -0,0 +1,36 @@
+<!-- An enhanced version of Rapid's `<collection>` tag that supports drag-and-drop re-ordering.
+
+Each item in the collection has a `<div class="ordering-handle" param="handle">` added, which can be used to drag the item up and down.
+
+### Attributes
+
+`sortable-collection` supports all of the options and events defined by [jQuery UI's Sortable](http://jqueryui.com/demos/sortable/).
+
+Sortable also supports all of the standard [Hobo AJAX callbacks](http://cookbook.hobocentral.net/api_taglibs/rapid_forms).
+
+The jQuery UI option `update` is used internally to save the new order via Ajax.   If you modify this option, your function may call `$(this).hjq_sortable_collection('update')` to retain this functionality.
+
+### Controller support
+
+This tag assumes the controller has a `reorder` action and the model has a `position_column` method. This action is added automatically by Hobo's model-controller if the model declares `acts_as_list`. See also [Drag and Drop Reordering](/manual/controllers#drag_and_drop_reordering) in the [Controllers and Routing](/manual/controllers) chapter of the manual.
+-->
+<def tag="sortable-collection">
+<%
+  options, attrs = attributes.partition_hash(['disabled', 'appendTo', 'axis', 'cancel', 'connectWith', 'containment', 'cursor', 'cursorAt', 'delay', 'distance', 'dropOnEmpty', 'forceHelperSize', 'forcePlaceholderSize', 'grid', 'handle', 'helper', 'items', 'opacity', 'placeholder', 'revert', 'scroll', 'scrollSensitivity', 'scrollSpeed', 'tolerance', 'zIndex'])
+  events, html_attrs = attrs.partition_hash(['create', 'start', 'sort', 'change', 'beforeStop', 'stop', 'update', 'receive', 'remove', 'over', 'out', 'activate', 'deactivate'])
+  ajax_attrs, html_attrs = attrs.partition_hash(HoboRapidHelper::AJAX_CALLBACKS)
+
+  singular_name = this.member_class.name.underscore
+  route_method = subsite ? "#{subsite}_reorder_#{singular_name.pluralize}_url" : "reorder_#{singular_name.pluralize}_url"
+  reorder_url = send(route_method)
+
+  add_classes!(html_attrs, "sortable-collection")
+  add_data_rapid!(html_attrs, "sortable-collection", :options => options, :events => events, :ajax_attrs => ajax_attrs, :reorder_url => reorder_url, :reorder_parameter => "#{singular_name}_ordering")
+%>
+  <collection class="sortable" merge-attrs="&html_attrs" merge-params>
+    <item: param>
+      <div class="ordering-handle" param="handle" if="&can_edit?(this.position_column)">&uarr;<br/>&darr;</div>
+      <do param="default"><card param/></do>
+    </item:>
+  </collection>
+</def>

data/taglibs/plus/table_plus.dryml

@@ -0,0 +1,63 @@
+<!-- An enhanced version of Rapid's `<table>` that has support for column sorting, searching and pagination.
+
+This tag calls `<table merge-params>`, so the parameters for `<table>` are also available.
+
+The enhancements made available in this tag require controller support.
+
+An [worked example](/tutorials/agility#improve_the_project_page_with_a_searchable_sortable_table) of this tag is available in the [Agility Tutorial](/tutorials/agility)
+
+### Attributes
+
+All attributes supported by `<table>` and `<with-fields>` are supported.
+
+AJAX attributes are passed through to the sort links and the search form.
+
+sort-field: defaults to @sort_field, if that is available.  `parse_sort_params` sets this variable
+
+sort-direction: 'asc' or 'dec'.   defaults to @sort_direction, if that is available.   `parse_sort_params` sets this variable
+
+sort-columns: a hash that allow you to map fields to sortable columns.   The default is {"this" => "name"} (or whatever column that has the :name option set on it).
+
+-->
+<def tag="table-plus" attrs="sort-field, sort-direction, sort-columns" >
+  <% sort_field ||= @sort_field; sort_direction ||= @sort_direction; sort_columns ||= {} %>
+  <% sort_columns['this'] ||= this.member_class.try.name_attribute %>
+  <% ajax_attrs, attributes = attributes.partition_hash(HoboRapidHelper::AJAX_ATTRS) %>
+  <div class="table-plus" merge-attrs="&attributes - attrs_for(:with_fields) - attrs_for(:table)">
+    <div class="header" param="header">
+      <div class="search">
+        <form param="search-form" method="get" action="" with="&nil" merge-attrs="&ajax_attrs" >
+          <hidden-fields for-query-string skip="page, search"/>
+          <span><t key="hobo.table_plus.search">Search</t></span>
+          <input class="search" type="search" name="search" value="&params[:search]"/>
+          <submit label="&t('hobo.table_plus.submit_label', :default=>'Go')" class="search-button" param="search-submit"/>
+        </form>
+      </div>
+    </div>
+
+    <table merge-attrs="&attributes & (attrs_for(:table) + attrs_for(:with_fields))" empty merge-params>
+      <field-heading-row:>
+        <with-field-names merge-attrs="&all_attributes & attrs_for(:with_fields)">
+          <% col = sort_columns[scope.field_path] || scope.field_path
+             sort = sort_field == col && sort_direction == 'asc' ?
+                      "-#{col}" : col
+             sort_url = url_for_page_path(query_parameters_filtered('except' => 'page').merge(:sort => sort))
+             col_heading_name = this.member_class.try.human_attribute_name(scope.field_name, :default=> scope.field_name.titleize) %>
+
+          <th param="#{scope.field_name}-heading">
+            <a href="&sort_url" class="column-sort"
+               param="#{scope.field_name}-heading-link" merge-attrs="&ajax_attrs" ><%= col_heading_name %></a>
+            <if test="&col == sort_field">
+              <do param="up-arrow" if="&sort_direction == 'desc'">&uarr;</do>
+              <do param="down-arrow" if="&sort_direction == 'asc'">&darr;</do>
+            </if>
+          </th>
+        </with-field-names>
+        <th if="&all_parameters[:controls]" class="controls"></th>
+      </field-heading-row>
+    </table>
+    <empty-collection-message param="empty-message"/>
+
+    <page-nav param if="&this.respond_to?(:page_count) || this.respond_to?(:total_pages)" merge-attrs="&ajax_attrs" />
+  </div>
+</def>

data/taglibs/views/a_or_an.dryml

@@ -0,0 +1,10 @@
+<!-- Capitalised version of `<a-or-an>` -->
+<def tag="A-or-An" attrs="word"><%=
+  (word =~ /^[aeiou]/i ? "An " : "A ") + word
+%></def>
+
+<!-- Deprecated. It's harder than you think to do this (e.g. an umbrella, an user)
+-->
+<def tag="a-or-an" attrs="word"><%=
+  (word =~ /^[aeiou]/i ? "an " : "a ") + word
+%></def>

data/taglibs/views/collection_name.dryml

@@ -0,0 +1,28 @@
+<!-- Renders a human readable name of a collection
+
+Use this tag for en locale only. Use human-collection-name for i18n.
+
+### Details
+
+ - Uses `this.origin_attribute` as the name.
+ - Falls back to `<type-name>` otherwise.
+ - By default the name is titleised and plural.
+
+### Attributes
+
+ - singular: singularise the name
+ - lowercase: render the name in all lower case
+ - dasherize: render the name in lower case with dashes instead of spaces.
+
+-->
+<def tag="collection-name" attrs="singular, lowercase, dasherize"><%=
+  if (attr = this.try.origin_attribute)
+    name = attr.to_s
+    name = dasherize ? name.underscore.dasherize : name.titleize
+    name = name.singularize if singular
+    name = name.downcase if lowercase
+    name
+  else
+    type_name(:plural => !singular, :lowercase => lowercase, :dasherize => dasherize)
+  end
+%></def>

data/taglibs/views/comma_list.dryml

@@ -0,0 +1,2 @@
+<!-- Renders a collection of strings joined with ", ", or some other string passed in the `join` attribute -->
+<def tag="comma-list" attrs="join"><%= this.join(join || ", ") %></def>

data/taglibs/views/count.dryml

@@ -0,0 +1,99 @@
+<!--
+A convenience tag used to output a count summary with a correctly localized and pluralised label. Works with any kind of collection such as an `ActiveRecord` association or an array.
+
+### Usage
+
+    <count:comments/> -> <span class="count">1 Comment</span>
+
+    <count:viewings/> -> <span class="count">3 Viewings</span>
+
+The label can be customised using the `label` attribute, e.g.
+
+    <count:comments label="blog post comment"/> -> <span class="count">12 blog post comments</span>
+
+You can pass a summary attribute, which will generate a complete localized sentence. It allows 2 options:
+
+- boolean (e.g. `<count summary/>`): it will lookup the 'tags.count.default' key in the locale file. If the lookup fails, it will fallback to the english default sentences consistent with the count.
+- String (e.g. `<count summary="offer"/>`): it will lookup the 'tags.count.offer' key in the locale file.  If the lookup fails, it will fallback to the english default sentences consistent with the count.
+
+### Examples
+
+    it:
+      tags:
+        count:
+          default:
+            zero: "Non ci sono {{label}}"
+            one: "C'è solo 1 {{label}}"
+            other: "Ci sono {{count}} {{label}}"
+          choice:
+            zero: "Non ci sono {{label}} da scegliere"
+            one: "Puoi scegliere solo una {{label}}"
+            other: "Puoi scegliere tra {{count}} {{label}}"
+
+with :en locale and boolean summary (internal defaults)
+
+    <count:comments summary/> -> <span class="count">There is 1 Comment</span>
+    <count:viewings summary/> -> <span class="count">There are 3 Viewings</span>
+
+(note: just add the locale english strings to use like the following examples)
+
+with :it locale and boolean summary (key "tags.count.default")
+
+    <count:comments summary/>
+    -> count => 0 -> <span class="count">Non ci sono Commenti</span>
+    -> count => 1 -> <span class="count">C'è solo 1 Commento</span>
+    -> count => 5 -> <span class="count">Ci sono 5 Commenti</span>
+
+with :it locale and summary="choice" (key "tags.count.choice")
+
+    <count:comments summary="choice"/>
+    -> count => 0 -> <span class="count">Non ci sono Commenti da scegliere</span>
+    -> count => 1 -> <span class="count">Puoi scegliere solo 1 Commento</span>
+    -> count => 5 -> <span class="count">Puoi scegliere tra 5 Commenti</span>
+
+### Additional Notes
+
+* The `prefix` attribute is deprecated: use summary instead.
+
+* Use the `lowercase` attribute to force the generated label to be lowercase:
+
+        <count:comments lowercase/> -> <span class="count">1 comment</span>
+* Use the `if-any` attribute to output nothing if the count is zero. This can be followed by an `<else>` tag to handle the empty case:
+
+        <count:comments if-any/><else>There are no comments</else>
+-->
+<def tag="count" attrs="summary, label, if-any, lowercase, prefix"><span class="count"><%=
+  raise Exception.new("asked for count of a string") if this.is_a?(String)
+  Rails.logger.warn('The "prefix" attribute is deprecated: please, use a locale string') unless prefix.blank?
+
+  c = collection_count
+
+  # generated label will be pluralized
+  label ||= case
+            when this.is_a?(Class)
+              this.model_name.human(:count=>c)
+            when (attr = this.try.origin_attribute)
+              (this_parent || this.origin).class.human_attribute_name(attr, :count=>c)
+            else
+              this.member_class.model_name.human(:count=>c)
+            end
+
+  label = label.downcase if lowercase
+
+  Dryml.last_if = c > 0 if if_any
+  if if_any && c == 0
+    ""
+  else
+    if summary.blank?  # old behaviour
+      main = label.blank? ? c : "#{c} #{label}"
+      if prefix.in? %w(are is)
+        prefix = c == 1 ? "is" : "are"
+      end
+      (prefix ? "#{prefix} #{main}" : main.to_s)
+    else
+      key = summary.kind_of?(String) ? summary : "default"
+      default = c == 1 ? "There is 1 #{label}" : "There are #{c} #{label}"
+      t "tags.count.#{key}", {:count=>c, :label=>label, :default=>default}.merge(attributes)
+    end
+  end
+%></span></def>

data/taglibs/views/links_for_collection.dryml

@@ -0,0 +1,2 @@
+<!-- Renders a comma separated list of links (`<a>`), or "(none)" if the list is empty -->
+<def tag="links-for-collection"><%= this.empty? ? "(none)" : context_map { a }.safe_join(", ") %></def>