File: README.rdoc [padrino-admin-0.12.5 Documentation]

### Home Classes Methods

### Files

- README.rdoc

### Class Index

Quicksearch

- Padrino
- Padrino::Admin
- Padrino::Admin::AccessControl
- Padrino::Admin::AccessControl::Authorization
- Padrino::Admin::AccessControl::Base
- Padrino::Admin::AccessControl::ProjectModule
- Padrino::Admin::AccessControlError
- Padrino::Admin::Generators
- Padrino::Admin::Generators::Orm
- Padrino::Admin::Generators::OrmError
- Padrino::Admin::Helpers
- Padrino::Admin::Helpers::AuthenticationHelpers
- Padrino::Admin::Helpers::ViewHelpers
- Padrino::Generators
- Padrino::Generators::Admin
- Padrino::Generators::Admin::Actions
- Padrino::Generators::AdminApp
- Padrino::Generators::AdminPage

No matching classes.

# Admin Dashboard and Authentication (padrino-admin)

### Overview

Padrino has a beautiful Admin management dashboard with these features:

Orm Agnostic | Data Adapters for Datamapper, Activerecord, Sequel, Mongomapper, Mongoid, Couchrest, Dynamoid
Template Agnostic | Erb, Erubis and Haml Renderer
Authentication | Support for Account authentication, Account Permission management
Scaffold | You can simply create a new "admin interface" by providing a Model
Access Control | Supports authentication and role permissions for your application

### Admin Dashboard Usage

For a complete look at usage of the Admin dashboard functionality, be sure to check out the Padrino Admin guide.

Create a new project:

    $ padrino-gen project demo
    $ cd demo

Create the admin subapplication:

    demo$ padrino-gen admin

Next, follow the admin setup steps:

- configure your `config/database.rb` to connect to the correct data.

- run `padrino rake dm:migrate` # or ar:migrate if you use activerecord

- run `padrino rake seed`

Your admin panel now is ready and you can start your server with `padrino start` and point your browser to `/admin`!

To create a new "scaffold" you need to provide only a Model name to the command:

    demo$ padrino-gen model post --skip-migration # edit your post.rb model and add some fields
    demo$ padrino-gen rake dm:auto:migrate
    demo$ padrino-gen admin_page post
    demo$ padrino start # and go to http://localhost:3000/admin

That's all!!

### Admin Access Control

Padrino Admin use a model Account for manage role, membership and permissions.

For an ecommerce website, usually certain actions require permissions and authentication. This is supported by the admin access control features:

    class EcommerceSite < Padrino::Application
      register Padrino::Admin::AccessControl
      enable :store_location
      set    :login_page, "/login"

      access_control.roles_for :any do |role|
        role.protect "/customer/orders"
        role.protect "/cart/checkout"
      end
    end

In this example `if` we visit URLs that start with /`customer`/`orders` or /`cart/checkout` we will be redirected to our :`login_page` "/login". Once we are correctly logged in we can visit these pages.

For a more complete look at using the Admin panel functionality and access features, be sure to check out the Padrino Admin guide.

## Copyright

Copyright (c) 2011-2013 Padrino. See LICENSE for details.

[Validate]

Generated with the Darkfish Rdoc Generator 2.