MerbAdmin¶ ↑

MerbAdmin is a Merb plugin that provides an easy-to-use interface for managing your data.¶ ↑

It currently offers the features listed here.

Take it for a test drive with sample data here.

The status of the latest build is available here.

Various code metrics are available here.

Screenshots¶ ↑

Installation¶ ↑

$ gem install merb-admin -s http://gemcutter.org

In your app, add the following dependency to config/dependencies.rb:

dependency "merb-admin", "0.7.6"

Add the following route to config/router.rb:

add_slice(:merb_admin, :path_prefix => "admin")

Then, run the following rake task:

$ rake slices:merb-admin:install

Configuration (optional)¶ ↑

If you’re feeling crafty, you can set a couple configuration options in config/init.rb:

Merb::BootLoader.before_app_loads do
  Merb::Slices::config[:merb_admin][:app_name] = "My App"
  Merb::Slices::config[:merb_admin][:per_page] = 100
  Merb::Slices::config[:merb_admin][:excluded_models] = ["Top", "Secret"]
end

Usage¶ ↑

Start the server:

$ merb

You should now be able to administer your site at localhost:4000/admin.

WARNING¶ ↑

MerbAdmin does not implement any authorization scheme. Make sure to apply authorization logic before deploying to production!

Contributing¶ ↑

In the spirit of free software, people of all abilities are encouraged to help improve MerbAdmin.

There are many ways to contribute:

• by reporting bugs

• by suggesting new features

• by writing documentation

• by writing specifications

• by writing code (no patch is too small: fix typos in comments or inconsistent whitespace)

• by refactoring code

• by reviewing patches

• financially

All contributors will be added to the credits below and will receive the respect and gratitude of the author.

Contact¶ ↑

If you are interested in contributing to MerbAdmin, please contact Erik Michaels-Ober via email, GitHub, or Twitter.

Credits¶ ↑

Many thanks to:

• Wilson Miner for contributing the stylesheets and javascripts from Django

• Aaron Wheeler for contributing libraries from Merb AutoScaffold

• Lori Holden for contributing the merb-pagination helper

• Jacques Crocker for adding support for namespaced models

• Jeremy Evans and Pavel Kunc for reviewing the patch to add Sequel support

• Jonah Honeyman for fixing a bug and adding the :excluded_models option

Also, thanks to beer.