= MerbAdmin
==== MerbAdmin is a Merb plugin that provides an easy-to-use interface for managing your data.
It currently offers the features listed here[http://sferik.tadalist.com/lists/1352791/public].
Take it for a test drive with sample data here[http://merb-admin.heroku.com/].
== Screenshots
http://github.com/sferik/merb-admin/raw/master/screenshots/list.png
http://github.com/sferik/merb-admin/raw/master/screenshots/edit.png
== Installation
$ gem install merb-admin
In your app, add the following dependency to Gemfile:
gem "merb-admin"
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 http://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}[http://www.fsf.org/licensing/essays/free-sw.html], 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[http://pledgie.com/campaigns/5428]
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[mailto:sferik@gmail.com], GitHub[http://github.com/sferik/], or Twitter[http://twitter.com/sferik].
== Credits
Many thanks to:
* {Wilson Miner}[http://www.wilsonminer.com] for contributing the stylesheets and javascripts from Django[http://www.djangoproject.com]
* {Aaron Wheeler}[http://fightinjoe.com/] for contributing libraries from {Merb AutoScaffold}[http://github.com/fightinjoe/merb-autoscaffold]
* {Lori Holden}[http://loriholden.com/] for contributing the merb-pagination[http://github.com/lholden/merb-pagination] helper
* {Jacques Crocker}[http://merbjedi.com] for adding support for {namespaced models}[http://github.com/merbjedi/merb-admin/commit/8139e2241038baf9b72452056fcdc7c340d79275]
* {Jeremy Evans}[http://code.jeremyevans.net] and {Pavel Kunc}[http://www.merboutpost.com] for reviewing the {patch}[http://github.com/sferik/merb-admin/commit/061fa28f652fc9214e9cf480d66870140181edef] to add Sequel[http://sequel.rubyforge.org/] support
* {Jonah Honeyman}[http://twitter.com/jonuts] for fixing a bug[http://github.com/sferik/merb-admin/commit/9064d10382eadd1ed7a882ef40e2c6a65edfef2c] and adding the {:excluded_models option}[http://github.com/sferik/merb-admin/commit/f6157d1c471dd85162481d6926578164be1b9673]
Also, thanks to beer[http://www.21st-amendment.com].