Sha256: 7d4c680d622ffbfc75440c0372de2a418f89f8d725a5620bd38c0506d9b451b8
Contents?: true
Size: 1.93 KB
Versions: 16
Compression:
Stored size: 1.93 KB
Contents
---
layout: default
title: "Quick start: admin_assistant 1"
---
<div class="note">
This document assumes you are highly familiar with Ruby and Rails; if you are a beginning Rails user you might want to start with our <a href="/admin_assistant/v1/tutorial.html">tutorial</a>.
</div>
1) Include the gem in `config/environment.rb`.
config.gem 'admin_assistant', :version => '1.0.2'
2) Install the gem and dependencies into `vendor/gems`.
rake gems:unpack:dependencies
3) admin\_assistant comes packaged with standard CSS and Javascript that you should include in whatever layout your admin controllers will be using. You'll also need to make sure to include prototype.js, effects.js, and controls.js, if you're not including them already.
<html>
<head>
<%= javascript_include_tag("prototype", "effects", "controls") %>
<%= admin_assistant_includes %>
</head>
...
</html>
4) Setup an admin controller by attaching it to a model and using the admin layout:
class Admin::BlogPostsController < ApplicationController
layout 'admin'
admin_assistant_for BlogPost
end
That's it for the basic version. You should now be able to go to /admin/blog\_posts in your app and search, paginate, create, and edit blog posts.
Depending on the model you're using, you might notice a few things:
* Boolean values can be toggled on and off in the index view.
* Any belongs-to associations are handled in the form by either a drop-down, or an Ajax autocompleter, depending on how many choices there are for the association.
* There is no `destroy` action out of the box. This is intended as a safe default, but you can add it if you like.
* If you have more than 10 pages of a given model, the pagination at the bottom includes a jump form to let you automatically jump to a page you enter.
For more, check out the [API reference](/admin_assistant/v1/api/).
Version data entries
16 entries across 16 versions & 1 rubygems