Helperful 0.3.0

Simone Carletti — Mon, 16 Mar 2009 23:46:34 +0000

Last week I released a new minor version of the Helperful GEM. This is essentially a bugfix release, although it comes with one minor new feature: the javascript_content_for tag. The following overview is taken directly from the documentation.

The javascript_content_for helper combines the features of content_for and javascript_tag into a single helper.

1
2
3

<% javascript_content_for :head do %>
$("#id").hide();
<% end %>

The block is passed as it is to javascript_tag, then the result is stored as content_for :head.

Now you can call yield and output your javascript content.

1 2	<%= yield :head %>

This example is equal to the following statements.

1
2
3
4

<% javascript_content_for :head do; javascript_tag do %> $("#id").hide(); <% end; end %>
<% javascript_content_for :head do %>

<% end %>

This feature also addresses an annoying bug in the has_content helper method caused by an undefined variable.

To install or upgrade:

1	gem install weppos-helperful --source http://gems.github.com

More features still to come. Visit the project page for further details.

Helperful: a large collection of Rails Helpers

Simone Carletti — Thu, 26 Feb 2009 08:28:19 +0000

Helperful aims to be a collection of useful and reusable Rails helpers.

Rails Installation

As a Gem

This is the preferred way to install Helperful and the best way if you want install a stable version.

1	$ gem install weppos-helperful --source http://gems.github.com"

You can specify the GEM dependency in your application environment.rb file:

1
2
3
4
5
6

Rails::Initializer.run do |config|
# other configurations
# ...

config.gem "weppos-helperful", :lib => "helperful", :source => "http://gems.github.com"
end

As a Plugin

This is the preferred way if you want to live on the edge and install a development version.

1	$ script/plugin install git://github.com/weppos/helperful.git

Available Helpers

The list of available helpers actually includes AffiliationsHelper, ContentHelper and the more famous TitleHelper.

Affiliations Helper

Provides a set of helpers for working with online affiliations.

For example, the tradedoubler_verification_tag helper method returns the site verification tag required by Tradedoubler to verify the publisher account ownership.

1
2
3
4
5

# In your template
<%= tradedoubler_verification_tag('00112233') %>

# Will produce the following output.

Content Helper

Provides a set of helpers for capturing and working with your page content in a more effective way.

Fo example, the has_content? helper is a natural fulfillment for the original content_for helper.

1
2
3
4
5
6

<% content_for :foo do %>

This is a foo content.

<% end %>

<% has_content? :foo # => true %>
<% has_content? "foo" # => true %>

Title Helper

Provides an helper for managing page title in Rails views and layouts.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# Include the helper in your controller.
# You might want to include it in ApplicationController to make it available
# always and everywhere in your templates.
class ApplicationController < ActionController::Base
helperful :title
end

# Now you can use set a title in your action
# Example. index.html.rb

<%= title 'This is a title' %>

# And print the title with a :site decorator in your layout.
<%= title :site => 'My Cool Site!' %>

<%= yield %>

Documentation and Repository

Visit the project page or the documentation for further details. The repository is available on GitHub for forking or reference. Feel free to add more helpers and send me a pull request. Please ensure new helpers come with an appropriate test suite.

Simone Carletti's Blog » helpers