Puffer - YARAI (Yet Another Rails Admin Interface). Rails 3 only.

Puffer was created to help project owner or moderators view and edit all the project`s data models. It is rails 3 only

Keyfeatures

• Full rails integration. Puffer has no configs, just DSL to create interfaces. And this DSL depends on rails convensions.
• Flexibility. Puffer designed to be as flexible as possible, so you can create your own modules easily.
• I18n. Surely.
• Bla bla

Installation.

You can instal puffer as a gem:

gem install puffer

Or in Gemfile:

gem "puffer"

Next step is:

rails g puffer:install

This will install main puffer config file in your initializers and some css/js.

Introduction.

So, you have some data structure of your project. Let it`ll be like this:

create_table "users", :force => true do |t|
  t.string   "email"
  t.string   "password"
  t.datetime "created_at"
  t.datetime "updated_at"
end

create_table "posts", :force => true do |t|
  t.integer  "user_id"
  t.string   "title"
  t.text     "body"
  t.datetime "created_at"
  t.datetime "updated_at"
end

Also, you have two models:

class User < ActiveRecord::Base
  has_many :posts
  validates_presence_of :email, :password
  validates_length_of :password, :minimum => 6
end

class Profile < ActiveRecord::Base
  belongs_to :user
  validates_presence_of :name, :surname
end

At first, lets generate puffers controllers:

rails g puffer:controller User

and

rails g puffer:controller Post

This will generate a kind of:

class Admin::PostsController < Puffer::Base
  setup do
    group :posts
  end

  index do
    field :id
    field :user_id
    field :title
    field :body
    field :created_at
    field :updated_at
  end

  form do
    field :id
    field :user_id
    field :title
    field :body
    field :created_at
    field :updated_at
  end

end

Puffer controller`s DSL creates all the actions we need. Next step - routing

namespace :admin
  resources :users do
    resources :posts
  end
  resources :posts
end

Let me explain this feature. Puffer tracks all the nested resources. So, with this routing structure we can access, for example, only specified user`s posts:

/admin/users/1/post

Routing nesting defines admin interface resources nesting.

Advanced usage

Puffer can be used in other namespaces, then admin:

rails g puffer:controller moderator/posts

And we`ll get posts controller for moderator:

class Moderator::PostsController < Puffer::Base
  before_filter :require_moderator

  setup do
    destroy false
    group :posting
  end

  index do
    field :user_id
    field :title
    field :body
  end

  form do
    field :user_id
    field :title
    field :body
    field :created_at
    field :updated_at
  end
end

As you can see, moderators can not destroy posts, also moderators posts controller placed at Posting tab of admin interface. And dont forget about routing:

namespace :moderator do
  resources :posts
end