andrewroth_activeadmin 0.3.4

data/docs/3-index-pages/index-as-grid.md

@@ -0,0 +1,21 @@
+<!-- Please don't edit this file. It will be clobbered. -->
+
+# Index as a Grid
+
+Sometimes you want to display the index screen for a set of resources as a grid
+(possibly a grid of thumbnail images). To do so, use the :grid option for the
+index block.
+
+    index :as => :grid do |product|
+      link_to(image_tag(product.image_path), admin_products_path(product))
+    end
+
+The block is rendered within a cell in the grid once for each resource in the
+collection. The resource is passed into the block for you to use in the view.
+
+You can customize the number of colums that are rendered using the columns
+option:
+
+    index :as => :grid, :columns => 5 do |product|
+      link_to(image_tag(product.image_path), admin_products_path(product))
+    end

data/docs/3-index-pages/index-as-table.md

@@ -0,0 +1,90 @@
+<!-- Please don't edit this file. It will be clobbered. -->
+
+# Index as a Table
+
+By default, the index page is a table with each of the models content columns and links to
+show, edit and delete the object. There are many ways to customize what gets
+displayed.
+
+## Defining Columns
+
+To display an attribute or a method on a resource, simply pass a symbol into the
+column method:
+
+    index do
+      column :title
+    end
+
+If the default title does not work for you, pass it as the first argument:
+
+    index do
+      column "My Custom Title", :title
+    end
+
+Sometimes calling methods just isn't enough and you need to write some view
+specific code. For example, say we wanted a colum called Title which holds a
+link to the posts admin screen.
+
+The column method accepts a block as an argument which will then be rendered
+within the context of the view for each of the objects in the collection.
+
+    index do
+      column "Title" do |post|
+        link_to post.title, admin_post_path(post)
+      end
+    end
+
+The block gets called once for each resource in the collection. The resource gets passed into
+the block as an argument.
+
+To setup links to View, Edit and Delete a resource, use the default_actions method:
+
+    index do
+      column :title
+      default_actions
+    end
+
+Alternatively, you can create a column with custom links:
+
+    index do
+      column :title
+      column "Actions" do |post|
+        link_to "View", admin_post_path(post)
+      end
+    end
+
+
+## Sorting
+
+When a column is generated from an Active Record attribute, the table is
+sortable by default. If you are creating a custom column, you may need to give
+Active Admin a hint for how to sort the table.
+
+If a column is defined using a block, you must pass the key to turn on sorting. The key
+is the attribute which gets used to sort objects using Active Record.
+
+    index do
+      column "Title", :sortable => :title do |post|
+        link_to post.title, admin_post_path(post)
+      end
+    end
+
+You can turn off sorting on any column by passing false:
+
+    index do
+      column :title, :sortable => false
+    end
+
+## Showing and Hiding Columns
+
+The entire index block is rendered within the context of the view, so you can
+easily do things that show or hide columns based on the current context.
+
+For example, if you were using CanCan:
+
+    index do
+      column :title, :sortable => false
+      if can? :manage, Post
+        column :some_secret_data
+      end
+    end

data/docs/4-csv-format.md

@@ -0,0 +1,14 @@
+# Customizing the CSV format
+
+Active Admin provides CSV file downloads on the index screen for each Resource.
+By default it will render a CSV file with all the content columns of your
+registered model.
+
+Customizing the CSV format is as simple as customizing the index page.
+
+    ActiveAdmin.register Post do
+      csv do
+        column :title
+        column("Author") { |post| post.author.full_name }
+      end
+    end

data/docs/5-forms.md

@@ -0,0 +1,39 @@
+# Customizing the Form
+
+Active Admin gives complete control over the output of the form by creating a thin DSL on top of
+the fabulous DSL created by Formtastic (http://github.com/justinfrench/formtastic).
+
+    ActiveAdmin.register Post do
+
+      form do |f|
+        f.inputs "Details" do
+          f.input :title
+          f.input :published_at, :label => "Publish Post At"
+          f.input :category
+        end
+        f.inputs "Content" do
+          f.input :body
+        end
+        f.buttons
+      end
+
+    end
+
+Please view the documentation for Formtastic to see all the wonderful things you can do:
+http://github.com/justinfrench/formtastic
+
+If you require a more custom form than can be provided through the DSL, you can pass
+a partial in to render the form yourself.
+
+For example:
+
+    ActiveAdmin.register Post do
+      form :partial => "form"
+    end
+
+Then implement app/views/admin/posts/_form.html.erb:
+
+    <%= semantic_form_for [:admin, @post] do |f| %>
+      <%= f.inputs :title, :body %>
+      <%= f.buttons :commit %>
+    <% end %>

data/docs/6-show-screens.md

@@ -0,0 +1,36 @@
+# Customizing the Show Screen
+
+Customizing the show screen is as simple as implementing the show block:
+
+    ActiveAdmin.register Post do
+      show do
+        h3 post.title
+        div do
+          simple_format post.body
+        end
+      end
+    end
+
+The show block is rendered within the context of the view and uses the Arbre HTML DSL. You
+can also render a partial at any point.
+
+    ActiveAdmin.register Post do
+      show do
+        # renders app/views/admin/posts/_some_partial.html.erb
+        render "some_partial"
+      end
+    end
+
+If you'd like to keep the default active_admin look, you can also use "attributes_table":
+
+    ActiveAdmin.register Ad do
+      show do |ad|
+        attributes_table do
+          row :title
+          row :image do
+            image_tag(ad.image.url)
+          end
+        end
+        active_admin_comments
+      end
+    end

data/docs/7-sidebars.md

@@ -0,0 +1,35 @@
+# Sidebar Sections
+
+To add a sidebar section to all the screen within a section, use the sidebar method:
+
+    sidebar :help do
+      "Need help? Email us at help@example.com"
+    end
+
+This will generate a sidebar section on each screen of the resource. With the block as
+the contents of the section. The first argument is the section title.
+
+You can also use Arbre syntax to define the content.
+
+    sidebar :help do
+      ul do
+        li "Second List First Item"
+        li "Second List Second Item"
+      end
+    end
+
+Sidebar sections can be rendered on a specific action by using the :only or :except
+options.
+
+    sidebar :help, :only => :index do
+      "Need help? Email us at help@example.com"
+    end
+
+If you only pass a symbol, Active Admin will attempt to locate a partial to render.
+
+    # Will render app/views/admin/posts/_help_sidebar.html.erb
+    sidebar :help
+
+Or you can pass your own custom partial to render.
+
+    sidebar :help, :partial => "custom_help_partial"

data/docs/8-custom-actions.md

@@ -0,0 +1,123 @@
+# Custom Controller Actions
+
+Active Admin allows you to override and modify the underlying controller which
+is generated for you. There are helpers to add collection and member actions, or
+you can drop right in to the controller and modify its behavior.
+
+## Collection Actions
+
+A collection action is a controller action which operates on the collection of
+resources. This method adds both the action to the controller as well as
+generating a route for you.
+
+To add a collection action, use the collection_action method:
+
+
+    ActiveAdmin.register Post do
+
+      collection_action :import_csv, :method => :post do
+        # Do some CSV importing work here...
+        redirect_to :action => :index, :notice => "CSV imported successfully!"
+      end
+
+    end
+
+This collection action will generate a route at "/admin/posts/import_csv"
+pointing to the Admin::PostsController#import_csv controller action.
+
+## Member Actions
+
+A member action is a controller action which operates on a single resource.
+
+For example, to add a lock action to a user resource, you would do the
+following:
+
+    ActiveAdmin.register User do
+
+      member_action :lock, :method => :put do
+        user = User.find(params[:id])
+        user.lock!
+        redirect_to :action => :show, :notice => "Locked!"
+      end
+
+    end
+
+This will generate a route at "/admin/users/:id/lock" pointing to the
+Admin::UserController#lock controller action.
+
+## Controller Action HTTP Verb
+
+The collection_action and member_actions methods both accept the "method"
+argument to set the HTTP verb for the controller action and route.
+
+The generated routes will be scoped to the given method you pass in. By default
+your action will use the :get verb.
+
+## Rendering in Custom Actions
+
+Custom controller actions support rendering within the standard Active Admin
+layout. 
+
+    ActiveAdmin.register Post do
+
+      # /admin/posts/:id/comments
+      member_action :comments do
+        @post = Post.find(params[:id])
+
+        # This will render app/views/admin/posts/comments.html.erb
+      end
+
+    end
+
+If you would like to use the same view syntax as the rest of Active Admin, you
+can use the Arbre file extension: .arb.
+
+For example, create app/views/admin/posts/comments.html.arb with:
+
+    table_for assigns[:post].comments do
+      column :id
+      column :author
+      column :body do |comment|
+        simple_format comment.body
+      end
+    end
+
+### Page Titles
+
+The page title for the custom action will be the internationalized version of
+the controller action name. For example, a member_action named "upload_csv" will
+look up a translation key of "active_admin.upload_csv". If none are found, it
+just title cases the controller action's name.
+
+If this method doesn't work for your requirements, you can always set the
+@page_title instance variable in your controller action to customize the page
+title.
+
+    ActiveAdmin.register Post do
+
+      # /admin/posts/:id/comments
+      member_action :comments do
+        @post = Post.find(params[:id])
+        @page_title = "#{@post.title}: Comments" # Set the page title
+
+        # This will render app/views/admin/posts/comments.html.erb
+      end
+
+    end
+
+## Modify the Controller
+
+The generated controller is available to you within the registration block by
+using the #controller method.
+
+    ActiveAdmin.register Post do
+
+      controller do
+        # This code is evaluated within the controller class
+
+        def define_a_method
+          # Instance method
+        end
+      end
+
+    end

data/features/comments/commenting.feature

@@ -0,0 +1,112 @@
+Feature: Commenting
+
+  As a user
+  In order to document changes and have a discussion
+  I want to store and view comments on a resource
+
+  Background:
+    Given a post with the title "Hello World" written by "Jane Doe" exists
+
+  Scenario: View a resource with no comments
+    Given a show configuration of:
+      """
+        ActiveAdmin.register Post
+      """
+    Then I should see "Comments (0)"
+    And I should see "No comments yet."
+
+  Scenario: Create a new comment
+    Given a show configuration of:
+      """
+        ActiveAdmin.register Post
+      """
+    When I add a comment "Hello from Comment"
+    Then I should see a flash with "Comment was successfully created"
+    And I should be in the resource section for posts
+    And I should see "Comments (1)"
+    And I should see "Hello from Comment"
+    And I should see a comment by "admin@example.com"
+
+  Scenario: View resource with comments turned off
+    Given a show configuration of:
+    """
+      ActiveAdmin.register Post do
+        config.comments = false
+      end
+    """
+    Then I should not see "Comments"
+
+  Scenario: View a resource in a namespace that doesn't have comments
+    Given a configuration of:
+    """
+      ActiveAdmin.register Post, :namespace => :new_namespace
+    """
+    Given I am logged in
+    When I am on the index page for posts in the new_namespace namespace
+    And I follow "View"
+    Then I should not see "Comments"
+
+  Scenario: Creating a comment in one namespace does not create it in another
+    Given a show configuration of:
+    """
+      ActiveAdmin.application.allow_comments_in << :public
+      ActiveAdmin.register Post
+      ActiveAdmin.register Post, :namespace => :public
+    """
+    When I add a comment "Hello world in admin namespace"
+    Then I should see "Hello world in admin namespace"
+    When I am on the index page for posts in the public namespace
+    And I follow "View"
+    Then I should not see "Hello world in admin namespace"
+    And I should see "Comments (0)"
+
+    When I add a comment "Hello world in public namespace"
+    Then I should see "Hello world in public namespace"
+    When I am on the index page for posts in the admin namespace
+    And I follow "View"
+    Then I should not see "Hello world in public namespace"
+    And I should see "Comments (1)"
+
+  Scenario: Creating a comment on an aliased resource
+    Given a configuration of:
+    """
+    ActiveAdmin.register Post, :as => "Article"
+    """
+    Given I am logged in
+    When I am on the index page for articles
+    And I follow "View"
+    When I add a comment "Hello from Comment"
+    Then I should see a flash with "Comment was successfully created"
+    And I should be in the resource section for articles
+
+  Scenario: Create an empty comment
+    Given a show configuration of:
+      """
+        ActiveAdmin.register Post
+      """
+    When I add a comment ""
+    Then I should see a flash with "Comment wasn't saved, text was empty."
+    And I should see "Comments (0)"
+
+  Scenario: Viewing all commments for a namespace
+    Given a show configuration of:
+      """
+        ActiveAdmin.register Post
+      """
+    When I add a comment "Hello from Comment"
+    When I am on the index page for comments
+    Then I should see a table header with "Body"
+    And I should see "Hello from Comment"
+
+  Scenario: Commenting on a STI subclass
+    Given a configuration of:
+    """
+      ActiveAdmin.register User
+    """
+    Given I am logged in
+    And a publisher named "Pragmatic Publishers" exists
+    When I am on the index page for users
+    And I follow "View"
+    When I add a comment "Hello World"
+    Then I should see a flash with "Comment was successfully created"
+    And I should be in the resource section for users