admin_interface

A Rails admin interface generator. Theme stolen from Redmine. Similar to web-app-theme.

Ruby

Deprecated. Please use https://github.com/activeadmin/activeadmin or https://github.com/sferik/rails_admin.

= AdminInterface

A Rails admin interface generator for Rails 3.1+. Theme stolen from Redmine. Similar to web-app-theme.

== More info

Generator to create some nifty admin scaffolds. It can work with MetaSearch and Kaminari.
It also has admin authentication really well implemented.

== Install

=== Rails 3

You should be using v1.2.0+ of the Gem. Add the following to your Gemfile.

gem ‘admin_interface’

== Usage / Example

=== Generate the initial framework (layout, etc.)

rails generate admin_interface:setup

This will:

Create an Admin::BaseController in app/controllers/admin/base_controller.rb
Create a layout in app/views/layouts/admin.html.erb

Change the app/controllers/admin/base_controller.rb to have a before filter
only allowing admins to access it.

To view the admin page go to /admin (username: admin, password: admin).

=== Generate admin models and controllers

Create a scaffold for a model, for example:

rails generate admin_interface:scaffold post
rails generate admin_interface:scaffold post title:string body:text published:boolean
rails generate admin_interface:scaffold purchase order_id:integer amount:decimal

This will:

Create stuff similar to original Rails scaffold generator but for admin interface.
NOT create model since you probably have it already.

Pass the name of the model (in singular form), either CamelCased or
under_scored, as the first argument, and an optional list of attribute
pairs.

Attribute pairs are column_name:sql_type arguments specifying the
model’s attributes. Timestamps are added by default, so you don’t have to
specify them by hand as ‘created_at:datetime updated_at:datetime’.

=== Customize

You should customize your admin area so it can be more functional and nicely looking.

=== See it in action

Go to /admin and you can see everything in action.

== Screenshot

https://raw.github.com/joost/admin_interface/master/doc/screenshot.png

== Error messages

Add this to a initializer or in your environment.rb (see: http://railscasts.com/episodes/39-customize-field-error)
This will make sure the admin errors will show in correct styling.

Change the error from div to span

ActionView::Base.field_error_proc = Proc.new do |html_tag, instance_tag|
“#{html_tag}”.html_safe
end

Note that this might affect the rest of your application. A different solution is
welcome!

== Kudos

Kudos, credits or whatever you like more go to:

Jean-Philippe Lang (creator of {Redmine}[http://www.redmine.org/]).