saulolso-activeadmin 0.2.2

data/lib/active_admin/views/components/paginated_collection.rb

@@ -0,0 +1,92 @@
+module ActiveAdmin
+  module Views
+
+    # Wraps the content with pagination and available formats.
+    #
+    # *Example:*
+    #
+    #   paginated_collection collection, :entry_name => "Post" do
+    #     div do
+    #       h2 "Inside the
+    #     end
+    #   end
+    #
+    # This will create a div with a sentence describing the number of
+    # posts in one of the following formats:
+    #
+    # * "No Posts found"
+    # * "Displaying all 10 Posts"
+    # * "Displaying Posts 1 - 30 of 31 in total"
+    #
+    # It will also generate pagination links.
+    #
+    class PaginatedCollection < ActiveAdmin::Component
+      builder_method :paginated_collection
+
+
+      # Builds a new paginated collection component
+      #
+      # @param [Array] collection  A "paginated" collection from kaminari
+      # @param [Hash]  options     These options will be passed on to the page_entries_info
+      #                            method.
+      #                            Useful keys:
+      #                             :entry_name - The name to display for this resource collection
+      def build(collection, options = {})
+        @collection = collection
+        div(page_entries_info(options).html_safe, :class => "pagination_information")
+        @contents = div(:class => "paginated_collection_contents")
+        build_pagination_with_formats
+        @built = true
+      end
+
+      # Override add_child to insert all children into the @contents div
+      def add_child(*args, &block)
+        if @built
+          @contents.add_child(*args, &block)
+        else
+          super
+        end
+      end
+
+      protected
+
+      def build_pagination_with_formats
+        div :id => "index_footer" do
+          build_download_format_links
+          build_pagination
+        end
+      end
+
+      def build_pagination
+        text_node paginate(collection)
+      end
+
+      # TODO: Refactor to new HTML DSL
+      def build_download_format_links(formats = [:csv, :xml])
+        links = formats.collect do |format|
+          link_to format.to_s.upcase, { :format => format}.merge(request.query_parameters.except(:commit, :format))
+        end
+        text_node [I18n.t('active_admin.download'), links].flatten.join("&nbsp;").html_safe
+      end
+
+      # modified from will_paginate
+      def page_entries_info(options = {})
+        entry_name = options[:entry_name] ||
+          (collection.empty?? 'entry' : collection.first.class.name.underscore.sub('_', ' '))
+
+        if collection.num_pages < 2
+          case collection.size
+          when 0; I18n.t('active_admin.pagination.empty', :model => entry_name.pluralize)
+          when 1; I18n.t('active_admin.pagination.one', :model => entry_name)
+          else;   I18n.t('active_admin.pagination.one_page', :model => entry_name.pluralize, :n => collection.size)
+          end
+        else
+          offset = collection.current_page * active_admin_application.default_per_page
+          total  = collection.total_count
+          I18n.t('active_admin.pagination.multiple', :model => entry_name.pluralize, :from => (offset - active_admin_application.default_per_page + 1), :to => offset > total ? total : offset, :total => total)
+        end
+      end
+
+    end
+  end
+end

data/lib/active_admin/views/components/panel.rb

@@ -0,0 +1,26 @@
+module ActiveAdmin
+  module Views
+
+    class Panel < ActiveAdmin::Component
+      builder_method :panel
+
+      def build(title, attributes = {})
+        icon_name = attributes.delete(:icon)
+        icn = icon_name ? icon(icon_name) : ""
+        super(attributes)
+        add_class "panel"
+        @title = h3(icn + title.to_s)
+        @contents = div(:class => "panel_contents")
+      end
+
+      def add_child(child)
+        if @contents
+          @contents << child
+        else
+          super
+        end
+      end
+    end
+
+  end
+end

data/lib/active_admin/views/components/scopes.rb

@@ -0,0 +1,70 @@
+module ActiveAdmin
+  module Views
+
+    # Renders a collection of ActiveAdmin::Scope objects as a
+    # simple list with a seperator
+    class Scopes < ActiveAdmin::Component
+      builder_method :scopes_renderer
+
+      def build(scopes)
+        scopes.each do |scope|
+          build_scope(scope)
+        end
+      end
+
+      protected
+
+      def build_scope(scope)
+        span :class => classes_for_scope(scope) do
+          begin
+            scope_name = I18n.t!("active_admin.scopes.#{scope.scope_method}")
+          rescue I18n::MissingTranslationData
+            scope_name = scope.name
+          end
+
+          if current_scope?(scope)
+            em(scope_name)
+          else
+            a(scope_name, :href => url_for(params.merge(:scope => scope.id, :page => 1)))
+          end
+          text_node(" ")
+          scope_count(scope)
+          text_node(" ")
+        end
+      end
+
+      def classes_for_scope(scope)
+        classes = ["scope", scope.id]
+        classes << "selected" if current_scope?(scope)
+        classes.join(" ")
+      end
+
+      def current_scope?(scope)
+        if params[:scope]
+          params[:scope] == scope.id
+        else
+          active_admin_config.default_scope == scope
+        end
+      end
+
+      def scope_count(scope)
+        span :class => 'count' do
+          "(" + get_scope_count(scope).to_s + ")"
+        end
+      end
+
+      def get_scope_count(scope)
+        if scope.scope_method
+          scoping_class.send(scope.scope_method).count
+        else
+          instance_exec(scoping_class, &scope.scope_block).count
+        end
+      end
+
+      def scoping_class
+        assigns["before_scope_collection"] || active_admin_config.resource
+      end
+
+    end
+  end
+end

data/lib/active_admin/views/components/sidebar_section.rb

@@ -0,0 +1,30 @@
+module ActiveAdmin
+  module Views
+
+    class SidebarSection < Panel
+      builder_method :sidebar_section
+
+      # Takes a ActiveAdmin::Sidebar::Section instance
+      def build(section)
+        @section = section
+        super(@section.title, :icon => @section.icon)
+        self.id = @section.id
+        build_sidebar_content
+      end
+
+      protected
+
+      def build_sidebar_content
+        if @section.block
+          rvalue = instance_eval(&@section.block)
+          self << rvalue if rvalue.is_a?(String)
+        else
+          self << capture do
+            render @section.partial_name
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/active_admin/views/components/status_tag.rb

@@ -0,0 +1,55 @@
+module ActiveAdmin
+  module Views
+    # Build a StatusTag
+    class StatusTag < ActiveAdmin::Component
+      builder_method :status_tag
+
+      def tag_name
+        'span'
+      end
+
+      def default_class_name
+        'status'
+      end
+
+      # @method status_tag(status, type = nil, options = {})
+      #
+      # @param [String] status the status to display. One of the span classes will be an underscored version of the status.
+      # @param [Symbol] type type of status. Will become a class of the span. ActiveAdmin provide style for :ok, :warning and :error.
+      # @param [Hash] options such as :class, :id etc
+      #
+      # @return [ActiveAdmin::Views::StatusTag]
+      #
+      # Examples:
+      #   status_tag('In Progress')
+      #   # => <span class='status in_progress'>In Progress</span>
+      #
+      #   status_tag('active', :ok)
+      #   # => <span class='status active ok'>Active</span>
+      #
+      #   status_tag('active', :ok, :class => 'important', :id => 'status_123')
+      #   # => <span class='status active ok important' id='status_123'>Active</span>
+      # 
+      def build(*args)
+        options = args.extract_options!
+        status = args[0]
+        type = args[1]
+        classes = options.delete(:class)
+
+        status = status.titleize if status
+
+        super(status, options)
+
+        add_class(status_to_class(status)) if status
+        add_class(type.to_s) if type
+        add_class(classes) if classes
+      end
+
+      protected
+
+      def status_to_class(status)
+        status.titleize.gsub(/\s/, '').underscore
+      end
+    end
+  end
+end

data/lib/active_admin/views/components/table_for.rb

@@ -0,0 +1,193 @@
+module ActiveAdmin
+  module Views
+    class TableFor < Arbre::HTML::Table
+      builder_method :table_for
+
+      def tag_name
+        'table'
+      end
+
+      def build(collection, options = {})
+        @sortable = options.delete(:sortable)
+        @resource_class = options.delete(:i18n)
+        @collection = collection
+        @columns = []
+        build_table
+        super(options)
+      end
+
+      def column(*args, &block)
+        options = default_options.merge(args.last.is_a?(::Hash) ? args.pop : {})
+        title = args[0]
+        data  = args[1] || args[0]
+
+        col = Column.new(title, data, options, &block)
+        @columns << col
+
+        # Build our header item
+        within @header_row do
+          build_table_header(col)
+        end
+
+        # Add a table cell for each item
+        @collection.each_with_index do |item, i|
+          within @tbody.children[i] do
+            build_table_cell(col, item)
+          end
+        end
+      end
+
+      def sortable?
+        @sortable
+      end
+
+      # Returns the columns to display based on the conditional block
+      def visible_columns
+        @visible_columns ||= @columns.select{|col| col.display_column? }
+      end
+
+      protected
+
+      def build_table
+        build_table_head
+        build_table_body
+      end
+
+      def build_table_head
+        @thead = thead do
+          @header_row = tr
+        end
+      end
+
+      def build_table_header(col)
+        if sortable? && col.sortable?
+          build_sortable_header_for(col.title, col.sort_key)
+        else
+          th(col.title)
+        end
+      end
+
+      def build_sortable_header_for(title, sort_key)
+        classes = Arbre::HTML::ClassList.new(["sortable"])
+        if current_sort[0] == sort_key
+          classes << "sorted-#{current_sort[1]}"
+        end
+
+        th :class => classes do
+          link_to(title, params.merge(:order => "#{sort_key}_#{order_for_sort_key(sort_key)}").except(:page))
+        end
+      end
+
+      def build_table_body
+        @tbody = tbody do
+          # Build enough rows for our collection
+          @collection.each{|_| tr(:class => cycle('odd', 'even')) }
+        end
+      end
+
+      def build_table_cell(col, item)
+        td do
+          rvalue = call_method_or_proc_on(item, col.data, :exec => false)
+          if col.data.is_a?(Symbol)
+            rvalue = pretty_format(rvalue)
+          end
+          rvalue
+        end
+      end
+
+      # Returns an array for the current sort order
+      #   current_sort[0] #=> sort_key
+      #   current_sort[1] #=> asc | desc
+      def current_sort
+        @current_sort ||= if params[:order] && params[:order] =~ /^([\w\_\.]+)_(desc|asc)$/
+          [$1,$2]
+        else
+          []
+        end
+      end
+
+      # Returns the order to use for a given sort key
+      #
+      # Default is to use 'desc'. If the current sort key is
+      # 'desc' it will return 'asc'
+      def order_for_sort_key(sort_key)
+        current_key, current_order = current_sort
+        return 'desc' unless current_key == sort_key
+        current_order == 'desc' ? 'asc' : 'desc'
+      end
+
+      def default_options
+        {
+          :i18n => @resource_class
+        }
+      end
+
+      class Column
+
+        attr_accessor :title, :data
+
+        def initialize(*args, &block)
+          @options = default_options.merge(args.last.is_a?(::Hash) ? args.pop : {})
+          @title = pretty_title args[0]
+          @data  = args[1] || args[0]
+          @data = block if block
+        end
+
+        def sortable?
+          if @data.is_a?(Proc)
+            [String, Symbol].include?(@options[:sortable].class)
+          else
+            @options[:sortable]
+          end
+        end
+
+        #
+        # Returns the key to be used for sorting this column
+        #
+        # Defaults to the column's method if its a symbol
+        #   column :username
+        #   # => Sort key will be set to 'username'
+        #
+        # You can set the sort key by passing a string or symbol
+        # to the sortable option:
+        #   column :username, :sortable => 'other_column_to_sort_on'
+        #
+        # If you pass a block to be rendered for this column, the column
+        # will not be sortable unless you pass a string to sortable to
+        # sort the column on:
+        #
+        #   column('Username', :sortable => 'login'){ @user.pretty_name }
+        #   # => Sort key will be 'login'
+        #
+        def sort_key
+          if @options[:sortable] == true || @options[:sortable] == false
+            @data.to_s
+          else
+            @options[:sortable].to_s
+          end
+        end
+
+        private
+
+        def pretty_title(raw)
+          if raw.is_a?(Symbol)
+            if @options[:i18n] && @options[:i18n].respond_to?(:human_attribute_name) && human_name = @options[:i18n].human_attribute_name(raw)
+              raw = human_name
+            end
+
+            raw.to_s.titleize
+          else
+            raw
+          end
+        end
+
+        def default_options
+          {
+            :sortable => true
+          }
+        end
+
+      end
+    end
+  end
+end

data/lib/active_admin/views/dashboard_section_renderer.rb

@@ -0,0 +1,19 @@
+module ActiveAdmin
+  module Views
+    class DashboardSection < ActiveAdmin::Views::Panel
+
+      def build(section)
+        @section = section
+        super(title, :icon => @section.icon)
+        instance_eval &@section.block
+      end
+
+      protected
+
+      def title
+        @section.name.to_s.titleize
+      end
+
+    end
+  end
+end

data/lib/active_admin/views/header_renderer.rb

@@ -0,0 +1,37 @@
+module ActiveAdmin
+  module Views
+
+    # Renderer for the header of the application. Includes the page
+    # title, global navigation and utility navigation.
+    class HeaderRenderer < ::ActiveAdmin::Renderer
+
+      def to_html
+        title + global_navigation + utility_navigation
+      end
+
+      protected
+
+      def title
+        content_tag 'h1', active_admin_application.site_title, :id => 'site_title'
+      end
+
+      # Renders the global navigation returned by
+      # ActiveAdmin::ResourceController#current_menu
+      #
+      # It uses the ActiveAdmin.tabs_renderer option
+      def global_navigation
+        render view_factory.global_navigation, current_menu
+      end
+
+      def utility_navigation
+        content_tag 'p', :id => "utility_nav" do
+          if current_active_admin_user?
+            content_tag(:span, display_name(current_active_admin_user), :class => "current_user") +
+              link_to(I18n.t('active_admin.logout'), "/#{active_admin_application.default_namespace}/logout")
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/active_admin/views/index_as_block.rb

@@ -0,0 +1,24 @@
+module ActiveAdmin
+  module Views
+
+    # Simplest rendering possible. Calls the block for each element in the collection.
+    #
+    # Example:
+    #
+    #   ActiveAdmin.register Post do
+    #     index :as => :block do |post|
+    #       # render the post partial (app/views/admin/posts/_post)
+    #       render 'post', :post => post 
+    #     end
+    #   end
+    class IndexAsBlock < ActiveAdmin::Component
+
+      def build(page_config, collection)
+        collection.each do |obj|
+          instance_exec(obj, &page_config.block)
+        end
+      end
+
+    end
+  end
+end

data/lib/active_admin/views/index_as_blog.rb

@@ -0,0 +1,89 @@
+module ActiveAdmin
+  module Views
+    class IndexAsBlog < ActiveAdmin::Component
+
+      def build(page_config, collection)
+        @page_config = page_config
+        @collection = collection
+
+        # Call the block passed in. This will set the 
+        # title and body methods
+        instance_eval &page_config.block if page_config.block
+
+        build_posts
+      end
+
+      # Setter method for the configuration of the title
+      #
+      #   index :as => :blog do
+      #     title :a_method_to_call #=> Calls #a_method_to_call on the resource
+      #
+      #     # OR
+      #
+      #     title do |post|
+      #       post.a_method_to_call
+      #     end
+      #   end
+      def title(method = nil, &block)
+        if block_given? || method
+          @title = block_given? ? block : method
+        end
+        @title
+      end
+
+      # Setter method for the configuration of the body
+      #
+      #   index :as => :blog do
+      #     title :my_title
+      #
+      #     body :a_method_to_call #=> Calls #a_method_to_call on the resource
+      #
+      #     # OR
+      #
+      #     title do |post|
+      #       post.a_method_to_call
+      #     end
+      #   end
+      def body(method = nil, &block)
+        if block_given? || method
+          @body = block_given? ? block : method
+        end
+        @body
+      end
+
+      private
+
+      def build_posts
+        @collection.each do |post|
+          build_post(post)
+        end
+      end
+
+      def build_post(post)
+        div :for => post do
+          build_title(post)
+          build_body(post)
+        end
+      end
+
+      def build_title(post)
+        if @title
+          h3 do
+            link_to(call_method_or_proc_on(post, @title), resource_path(post))
+          end
+        else
+          h3 do
+            auto_link(post)
+          end
+        end
+      end
+
+      def build_body(post)
+        if @body
+          div(call_method_or_proc_on(post, @body), :class => 'content')
+        end
+      end
+
+    end # Posts
+  end
+end

data/lib/active_admin/views/index_as_grid.rb

@@ -0,0 +1,49 @@
+module ActiveAdmin
+  module Views
+    class IndexAsGrid < ActiveAdmin::Component
+
+      def build(page_config, collection)
+        @page_config = page_config
+        @collection = collection
+        build_table
+      end
+
+      def number_of_columns
+        @page_config[:columns] || default_number_of_columns
+      end
+
+      protected
+
+      def build_table
+        table :class => "index_grid" do
+          collection.in_groups_of(number_of_columns).each do |group|
+            build_row(group)
+          end
+        end
+      end
+
+      def build_row(group)
+        tr do
+          group.each do |item|
+            item ? build_item(item) : build_empty_cell
+          end
+        end
+      end
+
+      def build_item(item)
+        td :for => item do
+          instance_exec(item, &@page_config.block)
+        end
+      end
+
+      def build_empty_cell
+        td '&nbsp;'.html_safe
+      end
+
+      def default_number_of_columns
+        3
+      end
+
+    end
+  end
+end