andrewroth_activeadmin 0.3.4

data/lib/active_admin/views/index_as_table.rb

@@ -0,0 +1,164 @@
+module ActiveAdmin
+  module Views
+
+    # = 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
+    #
+    class IndexAsTable < ActiveAdmin::Component
+
+      def build(page_config, collection)
+        table_options = {
+          :id => active_admin_config.plural_underscored_resource_name,
+          :sortable => true,
+          :class => "index_table",
+          :i18n => active_admin_config.resource
+        }
+
+        table_for collection, table_options do |t|
+          instance_exec(t, &page_config.block)
+        end
+      end
+
+      def table_for(*args, &block)
+        insert_tag IndexTableFor, *args, &block
+      end
+
+      #
+      # Extend the default ActiveAdmin::Views::TableFor with some
+      # methods for quickly displaying items on the index page
+      #
+      class IndexTableFor < ::ActiveAdmin::Views::TableFor
+
+        # Display a column for the id
+        def id_column
+          column('ID', :sortable => :id){|resource| link_to resource.id, resource_path(resource), :class => "resource_id_link"}
+        end
+
+        # Adds links to View, Edit and Delete
+        def default_actions(options = {})
+          options = {
+            :name => ""
+          }.merge(options)
+          column options[:name] do |resource|
+            links = link_to I18n.t('active_admin.view'), resource_path(resource), :class => "member_link view_link"
+            links += link_to I18n.t('active_admin.edit'), edit_resource_path(resource), :class => "member_link edit_link"
+            links += link_to I18n.t('active_admin.delete'), resource_path(resource), :method => :delete, :confirm => I18n.t('active_admin.delete_confirmation'), :class => "member_link delete_link"
+            links
+          end
+        end
+
+        # Display A Status Tag Column
+        #
+        #   index do |i|
+        #     i.status_tag :state
+        #   end
+        #
+        #   index do |i|
+        #     i.status_tag "State", :status_name
+        #   end
+        #
+        #   index do |i|
+        #     i.status_tag do |post|
+        #       post.published? ? 'published' : 'draft'
+        #     end
+        #   end
+        #
+        def status_tag(*args, &block)
+          col = Column.new(*args, &block)
+          data = col.data
+          col.data = proc do |resource|
+            status_tag call_method_or_proc_on(resource, data)
+          end
+          add_column col
+        end
+      end # TableBuilder
+
+    end # Table
+  end
+end

data/lib/active_admin/views/pages/base.rb

@@ -0,0 +1,167 @@
+module ActiveAdmin
+  module Views
+    module Pages
+      class Base < Arbre::HTML::Document
+
+        def build(*args)
+          super
+          add_classes_to_body
+          build_active_admin_head
+          build_page
+        end
+
+        private
+
+
+        def add_classes_to_body
+          @body.add_class(params[:action])
+          @body.add_class(params[:controller].gsub('/', '_'))
+          @body.add_class("logged_in")
+        end
+
+        def build_active_admin_head
+          within @head do
+            meta :"http-equiv" => "Content-type", :content => "text/html; charset=utf-8"
+            insert_tag Arbre::HTML::Title, [title, active_admin_application.site_title].join(" | ")
+            active_admin_application.stylesheets.each do |path|
+              link :href => stylesheet_path(path), :media => "screen", :rel => "stylesheet", :type => "text/css"
+            end
+            active_admin_application.javascripts.each do |path|
+              script :src => javascript_path(path), :type => "text/javascript"
+            end
+            text_node csrf_meta_tag
+          end
+        end
+
+        def build_page
+          within @body do
+            div :id => "wrapper" do
+              build_header
+              build_title_bar
+              build_page_content
+              build_footer
+            end
+          end
+        end
+
+        def build_header
+          div :id => "header" do
+            render view_factory.header
+          end
+        end
+
+        def build_title_bar
+          div :id => "title_bar" do
+            build_titlebar_left
+            build_titlebar_right
+          end
+        end
+        
+        def build_titlebar_left
+          div :id => "titlebar_left" do
+            build_breadcrumb
+            build_title_tag
+          end
+        end
+        
+        def build_titlebar_right
+          div :id => "titlebar_right" do
+            build_action_items
+          end
+        end
+
+        def build_breadcrumb(separator = "/")
+          links = breadcrumb_links
+          return if links.empty?
+          span :class => "breadcrumb" do
+            links.each do |link|
+              text_node link
+              span(separator, :class => "breadcrumb_sep")
+            end
+          end
+        end
+
+        def build_title_tag
+          h2(title, :id => 'page_title')
+        end
+
+        def build_action_items
+          if active_admin_config
+            items = active_admin_config.action_items_for(params[:action])
+            insert_tag view_factory.action_items, items
+          end
+        end
+
+        def build_page_content
+          build_flash_messages
+          div :id => "active_admin_content", :class => (skip_sidebar? ? "without_sidebar" : "with_sidebar") do
+            build_main_content_wrapper
+            build_sidebar unless skip_sidebar?
+          end
+        end
+
+        def build_flash_messages
+          if flash.keys.any?
+            div :class => 'flashes' do
+              flash.each do |type, message|
+                div message, :class => "flash flash_#{type}"
+              end
+            end
+          end
+        end
+
+        def build_main_content_wrapper
+          div :id => "main_content_wrapper" do
+            div :id => "main_content" do
+              main_content
+            end
+          end
+        end
+
+        def main_content
+          I18n.t('active_admin.main_content', :model => self.class.name).html_safe
+        end
+
+        def title
+          self.class.name
+        end
+
+        # Set's the page title for the layout to render
+        def set_page_title
+          set_ivar_on_view "@page_title", title
+        end
+
+
+        # Returns the sidebar sections to render for the current action
+        def sidebar_sections_for_action
+          if active_admin_config
+            active_admin_config.sidebar_sections_for(params[:action])
+          else
+            []
+          end
+        end
+
+        # Renders the sidebar
+        def build_sidebar
+          div :id => "sidebar" do
+            sidebar_sections_for_action.collect do |section|
+              sidebar_section(section)
+            end
+          end
+        end
+
+        def skip_sidebar?
+          sidebar_sections_for_action.empty? || assigns[:skip_sidebar] == true
+        end
+
+        # Renders the content for the footer
+        def build_footer
+          div :id => "footer" do
+            para "Powered by #{link_to("Active Admin", "http://www.activeadmin.info")} #{ActiveAdmin::VERSION}".html_safe
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/active_admin/views/pages/dashboard.rb

@@ -0,0 +1,62 @@
+module ActiveAdmin
+  module Views
+    module Pages
+      class Dashboard < Base
+
+        def main_content
+          if assigns[:dashboard_sections] && assigns[:dashboard_sections].any?
+            render_sections(assigns[:dashboard_sections])
+          else
+            default_welcome_section
+          end
+        end
+
+        protected
+
+        # Dashboards don't have a sidebar
+        def build_sidebar; end
+
+        def title
+          I18n.t("active_admin.dashboard")
+        end
+
+        def render_sections(sections)
+          table :class => "dashboard" do
+            sections.in_groups_of(3, false).each do |row|
+              tr do
+                row.each do |section|
+                  td do
+                    render_section(section)
+                  end
+                end
+              end
+            end
+          end
+        end
+
+        # Renders each section using their renderer
+        def render_section(section)
+          insert_tag section_renderer(section), section
+        end
+
+        def section_renderer(section)
+          if section.options[:as]
+            view_factory["dashboard_section_as_#{section.options[:as]}"]
+          else
+            view_factory.dashboard_section
+          end
+        end
+
+        def default_welcome_section
+          div :class => "blank_slate_container", :id => "dashboard_default_message" do
+            span :class => "blank_slate" do
+              span I18n.t('active_admin.dashboard_welcome.welcome')
+              small I18n.t('active_admin.dashboard_welcome.call_to_action')
+            end
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/active_admin/views/pages/edit.rb

@@ -0,0 +1,28 @@
+module ActiveAdmin
+  module Views
+    module Pages
+      class Edit < Base
+
+        def title
+          I18n.t('active_admin.edit_model', :model => active_admin_config.resource_name)
+        end
+
+        def main_content
+          config = self.form_config.dup
+          config.delete(:block)
+          config.reverse_merge!({
+            :url => resource_path(resource),
+            :as => active_admin_config.underscored_resource_name
+          })
+
+          if form_config[:partial]
+            render form_config[:partial]
+          else
+            active_admin_form_for resource, config, &form_config[:block]
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/active_admin/views/pages/index.rb

@@ -0,0 +1,91 @@
+module ActiveAdmin
+  module Views
+    module Pages
+
+      class Index < Base
+
+        def title
+          active_admin_config.plural_resource_name
+        end
+
+        def config
+          index_config || default_index_config
+        end
+
+        # Render's the index configuration that was set in the
+        # controller. Defaults to rendering the ActiveAdmin::Pages::Index::Table
+        def main_content
+          build_scopes
+
+          if collection.any?
+            render_index
+          else
+            if params[:q]
+              render_empty_results
+            else
+              render_blank_slate
+            end
+          end
+        end
+
+        protected
+
+        def build_scopes
+          if active_admin_config.scopes.any?
+            scopes_renderer active_admin_config.scopes
+          end
+        end
+
+        # Creates a default configuration for the resource class. This is a table
+        # with each column displayed as well as all the default actions
+        def default_index_config
+          @default_index_config ||= ::ActiveAdmin::PageConfig.new(:as => :table) do |display|
+            id_column
+            resource_class.content_columns.each do |col|
+              column col.name.to_sym
+            end
+            default_actions
+          end
+        end
+
+        # Returns the actual class for renderering the main content on the index
+        # page. To set this, use the :as option in the page_config block.
+        def find_index_renderer_class(symbol_or_class)
+          case symbol_or_class
+          when Symbol
+            ::ActiveAdmin::Views.const_get("IndexAs" + symbol_or_class.to_s.camelcase)
+          when Class
+            symbol_or_class
+          else
+            raise ArgumentError, "'as' requires a class or a symbol"
+          end
+        end
+        
+        def render_blank_slate
+          blank_slate_content = I18n.t("active_admin.blank_slate.content", :resource_name => active_admin_config.resource_name.pluralize)
+          if controller.action_methods.include?('new')
+            blank_slate_content += " " + link_to(I18n.t("active_admin.blank_slate.link"), new_resource_path)
+          end
+          insert_tag(view_factory.blank_slate, blank_slate_content)
+        end
+        
+        def render_empty_results
+          empty_results_content = I18n.t("active_admin.pagination.empty", :model => active_admin_config.resource_name.pluralize)
+          insert_tag(view_factory.blank_slate, empty_results_content)
+        end
+        
+        def render_index
+          renderer_class = find_index_renderer_class(config[:as])
+          
+          paginated_collection(collection, :entry_name => active_admin_config.resource_name) do
+            div :class => 'index_content' do
+              insert_tag(renderer_class, config, collection)
+            end
+          end
+        end
+
+      end
+    end
+  end
+end
+