nsm-activeadmin 0.2.2

data/docs/6-show-screens.md

@@ -0,0 +1,22 @@
+# 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

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

data/features/comments/viewing_index.feature

@@ -0,0 +1,19 @@
+Feature: Viewing Index of Comments
+
+  Background:
+    Given a post with the title "Hello World" written by "Jane Doe" exists
+    Given a show configuration of:
+      """
+        ActiveAdmin.register Post
+      """
+
+  Scenario: Viewing all commments for a namespace
+    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 a table header with "Resource"
+    And I should see a table header with "Author"
+    And I should see "Hello from Comment"
+    And I should see a link to "Hello World"
+    And I should see "admin@example.com"
+    And I should not see an action item button "New Comment"

data/features/dashboard.feature

@@ -0,0 +1,26 @@
+Feature: Dashboard
+
+  Background:
+    Given I am logged in
+
+
+  Scenario: With no configuration
+    Given a configuration of:
+      """
+      """
+    When I go to the dashboard
+    Then I should see the default welcome message
+
+  Scenario: Displaying a dashboard widget
+    Given a configuration of:
+      """
+      ActiveAdmin::Dashboards.build do
+        section 'Hello World' do
+          para "Hello world from the content"
+        end
+      end
+      """
+    When I go to the dashboard
+    Then I should not see the default welcome message
+    And I should see a dashboard widget "Hello World"
+    And I should see "Hello world from the content"

data/features/edit_page.feature

@@ -0,0 +1,106 @@
+Feature: Edit Page
+
+  Customizing the form to edit resources
+
+  Background:
+    Given a category named "Music" exists
+    And a user named "John Doe" exists
+    And a post with the title "Hello World" written by "John Doe" exists
+    And I am logged in
+    Given a configuration of:
+    """
+      ActiveAdmin.register Post
+    """
+    When I am on the index page for posts
+
+  Scenario: Default form with no config
+    Given I follow "Edit"
+    Then the "Title" field should contain "Hello World"
+    And the "Body" field should contain ""
+    And the "Category" field should contain ""
+    And the "Author" field should contain the option "John Doe"
+    When I fill in "Title" with "Hello World from update"
+    When I press "Update Post"
+    Then I should see "Post was successfully updated."
+    And I should see the attribute "Title" with "Hello World from update"
+    And I should see the attribute "Author" with "John Doe"
+
+  Scenario: Generating a custom form
+    Given a configuration of:
+    """
+      ActiveAdmin.register Post do
+        form do |f|
+          f.inputs "Your Post" do
+            f.input :title
+            f.input :body
+          end
+          f.inputs "Publishing" do
+            f.input :published_at
+          end
+          f.buttons
+        end
+      end
+    """
+    Given I follow "Edit"
+    Then I should see a fieldset titled "Your Post"
+    And I should see a fieldset titled "Publishing"
+    And the "Title" field should contain "Hello World"
+    And the "Body" field should contain ""
+    When I fill in "Title" with "Hello World from update"
+    When I press "Update Post"
+    Then I should see "Post was successfully updated."
+    And I should see the attribute "Title" with "Hello World from update"
+    And I should see the attribute "Author" with "John Doe"
+
+  Scenario: Generating a custom form with :html set, visiting the new page first (bug probing issue #109)
+    Given a configuration of:
+    """
+      ActiveAdmin.register Post do
+        form :html => {} do |f|
+          f.inputs "Your Post" do
+            f.input :title
+            f.input :body
+          end
+          f.inputs "Publishing" do
+            f.input :published_at
+          end
+          f.buttons
+        end
+      end
+    """
+    Given I follow "New"
+    Then I follow "Posts"
+    Then I follow "Edit"
+    Then I should see a fieldset titled "Your Post"
+    And I should see a fieldset titled "Publishing"
+    And the "Title" field should contain "Hello World"
+    And the "Body" field should contain ""
+    When I fill in "Title" with "Hello World from update"
+    When I press "Update Post"
+    Then I should see "Post was successfully updated."
+    And I should see the attribute "Title" with "Hello World from update"
+    And I should see the attribute "Author" with "John Doe"
+
+  Scenario: Generating a form from a partial
+    Given "app/views/admin/posts/_form.html.erb" contains:
+    """
+      <% url = @post.new_record? ? admin_posts_path : admin_post_path(@post) %>
+      <%= active_admin_form_for @post, :url => url do |f|
+            f.inputs :title, :body
+            f.buttons 
+          end %>
+    """
+    Given a configuration of:
+    """
+      ActiveAdmin.register Post do
+        form :partial => "form"
+      end
+    """
+    Given I follow "Edit"
+    Then the "Title" field should contain "Hello World"
+    And the "Body" field should contain ""
+    When I fill in "Title" with "Hello World from update"
+    When I press "Update Post"
+    Then I should see "Post was successfully updated."
+    And I should see the attribute "Title" with "Hello World from update"
+    And I should see the attribute "Author" with "John Doe"