drogus/rails-parts

merb-parts ported to rails 3

Rails Parts¶ ↑

Merb parts ported to rails.

As it’s initial and a bit experimental implementation please note that API can change (currently it’s copied from Merb)

Install¶ ↑

Just add such line to Gemfile:

gem "rails-parts", :require => "parts"

and run:

bundle install

Usage¶ ↑

Generate part class using rails generator:

rails generate part Articles index

Add some logic to index method of your part:

# app/parts/articles_part.rb
class ArticlesPart < Parts::Base
  def index
    @articles = Article.limit(10)
  end
end

and to the view file linked to the part

# app/parts/views/articles_part/index.html.erb
Articles: <%= @article.map(&:title).join(", ") %>

Now you can render it in the view of any controller with:

<%= part ArticlesPart => :index %>

You can also attach params that will be available in Part as params hash:

part ArticlesPart => :index, :limit => 5

# app/parts/articles_part.rb
class ArticlesPart < Parts::Base
  def index
    @articles = Article.limit(params[:limit] || 10)
  end
end

rails-parts's Issues

Why include Parts::Helpers in ActionView::Base and ActionController::Base?

Since the "parts.include_helpers" initializer already exports the #part method from the controller to the view with #helper_method, why include the Parts::Helpers module in both places?

View path is not properly set on Rails 3.0.0 application

Hi,

Little problem and quic'n'dirty workaround:

Background: Fresh Rails 3.0 application, HAML, rails-parts from master installed as plugin.
Part was successfully generated, however while rendering part, "Missing template.." error is thrown.
After looking around, I found out that Parts::Base.view_paths is empty.

Quick workaround is to create initializer with following code:
Parts::Base.append_view_path "app/parts/views"

url_for not available in Parts

Hi,

I am just wondering, is it intentional that url_for (and thus most of paths) is not available in Parts?

I mean -- is it by design, so that it doesn't include too much from ActionController::Base, or it's just not done?
Best,
H.