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.