yousty-activeadmin 1.0.0.pre

data/lib/active_admin/view_helpers/method_or_proc_helper.rb

@@ -0,0 +1,93 @@
+module MethodOrProcHelper
+
+  # This method will either call the symbol on self or instance_exec the Proc
+  # within self. Any args will be passed along to the method dispatch.
+  #
+  # Calling with a Symbol:
+  #
+  #     call_method_or_exec_proc(:to_s) #=> will call #to_s
+  #
+  # Calling with a Proc
+  #
+  #     my_proc = Proc.new{ to_s }
+  #     call_method_or_exec_proc(my_proc) #=> will instance_exec in self
+  #
+  def call_method_or_exec_proc(symbol_or_proc, *args)
+    case symbol_or_proc
+    when Symbol, String
+      send(symbol_or_proc, *args)
+    when Proc
+      instance_exec(*args, &symbol_or_proc)
+    end
+  end
+
+  # Many times throughout the views we want to either call a method on an object
+  # or instance_exec a proc passing in the object as the first parameter. This
+  # method wraps that pattern.
+  #
+  # Calling with a Symbol:
+  #
+  #     call_method_or_proc_on(@my_obj, :size) same as @my_obj.size
+  #
+  # Calling with a Proc:
+  #
+  #     proc = Proc.new{|s| s.size }
+  #     call_method_or_proc_on(@my_obj, proc)
+  #
+  # By default, the Proc will be instance_exec'd within self. If you would rather
+  # not instance exec, but just call the Proc, then pass along `:exec => false` in
+  # the options hash.
+  #
+  #     proc = Proc.new{|s| s.size }
+  #     call_method_or_proc_on(@my_obj, proc, :exec => false)
+  #
+  # You can pass along any necessary arguments to the method / Proc as arguments. For
+  # example:
+  #
+  #     call_method_or_proc_on(@my_obj, :find, 1) #=> @my_obj.find(1)
+  #
+  def call_method_or_proc_on(receiver, *args)
+    options = { :exec => true }.merge(args.extract_options!)
+
+    symbol_or_proc = args.shift
+
+    case symbol_or_proc
+    when Symbol, String
+      receiver.send(symbol_or_proc.to_sym, *args)
+    when Proc
+      if options[:exec]
+        instance_exec(receiver, *args, &symbol_or_proc)
+      else
+        symbol_or_proc.call(receiver, *args)
+      end
+    end
+  end
+
+  # Many configuration options (Ex: site_title, title_image) could either be
+  # static (String), methods (Symbol) or procs (Proc). This helper takes care of
+  # returning the content when String or call call_method_or_proc_on when Symbol or Proc.
+  #
+  def render_or_call_method_or_proc_on(obj, string_symbol_or_proc, options = {})
+    case string_symbol_or_proc
+    when Symbol, Proc
+      call_method_or_proc_on(obj, string_symbol_or_proc, options)
+    when String
+      string_symbol_or_proc
+    end
+  end
+
+  # This method is different from the others in that it calls `instance_exec` on the reciever,
+  # passing it the proc. This evaluates the proc in the context of the reciever, thus changing
+  # what `self` means inside the proc.
+  def render_in_context(context, obj, *args)
+    context ||= self # default to `self`
+    case obj
+    when Proc
+      context.instance_exec *args, &obj
+    when Symbol
+      context.send obj, *args
+    else
+      obj
+    end
+  end
+end

data/lib/active_admin/view_helpers/sidebar_helper.rb

@@ -0,0 +1,15 @@
+module ActiveAdmin
+  module ViewHelpers
+    module SidebarHelper
+
+      def skip_sidebar!
+        @skip_sidebar = true
+      end
+
+      def skip_sidebar?
+        @skip_sidebar == true
+      end
+
+    end
+  end
+end

data/lib/active_admin/view_helpers/title_helper.rb

@@ -0,0 +1,11 @@
+module ActiveAdmin
+  module ViewHelpers
+    module TitleHelper
+
+      def title(_title)
+        @page_title = _title
+      end
+
+    end
+  end
+end

data/lib/active_admin/view_helpers/view_factory_helper.rb

@@ -0,0 +1,11 @@
+module ActiveAdmin
+  module ViewHelpers
+    module ViewFactoryHelper
+
+      def view_factory
+        active_admin_namespace.view_factory
+      end
+
+    end
+  end
+end

data/lib/active_admin/view_helpers.rb

@@ -0,0 +1,21 @@
+module ActiveAdmin
+  module ViewHelpers
+
+    # Require all ruby files in the view helpers dir
+    Dir[File.expand_path('../view_helpers', __FILE__) + "/*.rb"].each{|f| require f }
+
+    include AssignsWithIndifferentAccessHelper
+    include ActiveAdminApplicationHelper
+    include AutoLinkHelper
+    include BreadcrumbHelper
+    include DisplayHelper
+    include IconHelper
+    include MethodOrProcHelper
+    include SidebarHelper
+    include FormHelper
+    include TitleHelper
+    include ViewFactoryHelper
+    include FlashHelper
+
+  end
+end

data/lib/active_admin/views/action_items.rb

@@ -0,0 +1,17 @@
+module ActiveAdmin
+  module Views
+
+    class ActionItems < ActiveAdmin::Component
+
+      def build(action_items)
+        action_items.each do |action_item|
+          span :class => "action_item" do
+            instance_eval(&action_item.block)
+          end
+        end
+      end
+
+    end
+
+  end
+end

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

@@ -0,0 +1,29 @@
+require 'active_admin/views/components/popover'
+
+module ActiveAdmin
+  module Views
+    # Build an ActionListPopover
+    class ActionListPopover < ActiveAdmin::Views::Popover
+      builder_method :action_list_popover
+
+
+      def build(*args, &block)
+        @contents = ul :class => "popover_contents"
+
+        options = args.extract_options!
+
+        super(options)
+      end
+
+      def action(title, url, *args)
+        options = args.extract_options!
+        within @contents do
+          li do
+            text_node link_to( title, url, options )
+          end
+        end
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,103 @@
+module ActiveAdmin
+  module Views
+
+    class AttributesTable < ActiveAdmin::Component
+      builder_method :attributes_table_for
+
+      def build(record_or_collection, *attrs)
+        @collection = Array(record_or_collection)
+        @resource_class = @collection.first.class
+        options = { }
+        options[:for] = @collection.first if single_record?
+        super(options)
+        @table = table
+        build_colgroups
+        rows(*attrs)
+      end
+
+      def rows(*attrs)
+        attrs.each {|attr| row(attr) }
+      end
+
+      def row(*args, &block)
+        title   = args[0]
+        options = args.extract_options!
+        classes = [:row]
+        if options[:class]
+          classes << options[:class]
+        elsif title.present?
+          classes << "row-#{title.to_s.parameterize('_')}"
+        end
+        options[:class] = classes.join(' ')
+
+        @table << tr(options) do
+          th do
+            header_content_for(title)
+          end
+          @collection.each do |record|
+            td do
+              content_for(record, block || title)
+            end
+          end
+        end
+      end
+
+      protected
+
+      def default_id_for_prefix
+        'attributes_table'
+      end
+
+      # Build Colgroups
+      #
+      # Colgroups are only necessary for a collection of records; not
+      # a single record.
+      def build_colgroups
+        return if single_record?
+        reset_cycle(self.class.to_s)
+        within @table do
+          col # column for row headers
+          @collection.each do |record|
+            classes = Arbre::HTML::ClassList.new
+            classes << cycle(:even, :odd, :name => self.class.to_s)
+            classes << dom_class_name_for(record)
+            col(:id => dom_id_for(record), :class => classes)
+          end
+        end
+      end
+
+      def header_content_for(attr)
+        if @resource_class.respond_to?(:human_attribute_name)
+          @resource_class.human_attribute_name(attr, :default => attr.to_s.titleize)
+        else
+          attr.to_s.titleize
+        end
+      end
+
+      def empty_value
+        span I18n.t('active_admin.empty'), :class => "empty"
+      end
+
+      def content_for(record, attr)
+        previous = current_arbre_element.to_s
+        value    = pretty_format find_attr_value(record, attr)
+        value.blank? && previous == current_arbre_element.to_s ? empty_value : value
+      end
+
+      def find_attr_value(record, attr)
+        if attr.is_a?(Proc)
+          attr.call(record)
+        elsif attr.to_s[/\A(.+)_id\z/] && record.respond_to?($1.to_sym)
+          record.send($1.to_sym)
+        else
+          record.send(attr.to_sym)
+        end
+      end
+
+      def single_record?
+        @single_record ||= @collection.size == 1
+      end
+    end
+
+  end
+end

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

@@ -0,0 +1,17 @@
+module ActiveAdmin
+  module Views
+    # Build a Blank Slate
+    class BlankSlate < ActiveAdmin::Component
+      builder_method :blank_slate
+
+      def default_class_name
+        'blank_slate_container'
+      end
+
+      def build(content)
+        super(span(content.html_safe, :class => "blank_slate"))
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,150 @@
+module ActiveAdmin
+  module Views
+
+    # = Columns Component
+    #
+    # The Columns component allows you draw content into scalable columns. All
+    # you need to do is define the number of columns and the component will
+    # take care of the rest.
+    #
+    # == Simple Columns
+    #
+    # To display columns, use the #columns method. Within the block, call the
+    # #column method to create a new column.
+    #
+    # To createa a two column layout:
+    #
+    #     colums do
+    #       column do
+    #         span "Column # 1
+    #       end
+    #       column do
+    #         span "Column # 2
+    #       end
+    #     end
+    #
+    #
+    # == Multiple Span Columns
+    #
+    # To make a column span multiple, pass the :span option to the column method:
+    #
+    #     colums do
+    #       column :span => 2 do
+    #         span "Column # 1
+    #       end
+    #       column do
+    #         span "Column # 2
+    #       end
+    #     end
+    #
+    # By default, each column spans 1 column. So the above layout would have 2 columns,
+    # the first being 2 time bigger than the second.
+    #
+    #
+    # == Max and Mix Column Sizes
+    #
+    # Active Admin is a fluid width layout, which means that columns are all defined
+    # using percentages. Sometimes this can cause issues if you don't want a column
+    # to shrink or expand past a certain point.
+    #
+    # To overcome this, columns include a :max_width and :min_width option.
+    #
+    #     colums do
+    #       column :max_width => "200px", :min_width => "100px" do
+    #         span "Column # 1
+    #       end
+    #       column do
+    #         span "Column # 2
+    #       end
+    #     end
+    #
+    # Now the first column will not grow bigger than 200px and will not shrink smaller
+    # than 100px.
+    class Columns < ActiveAdmin::Component
+      builder_method :columns
+
+
+      # For documentation, please take a look at Column#build
+      def column(*args, &block)
+        insert_tag Column, *args, &block
+      end
+
+      # Override add child to set widths
+      def add_child(*)
+        super
+        calculate_columns!
+      end
+
+      protected
+
+      # Override the closing tag to include a clear
+      def closing_tag
+        "<div style=\"clear:both;\"></div>" + super
+      end
+
+      def margin_size
+        2
+      end
+
+      # Calculate our columns sizes and margins
+      def calculate_columns!
+        span_count = columns_span_count
+        columns_count = children.size
+
+        all_margins_width = margin_size * (span_count - 1)
+        column_width = (100.00 - all_margins_width) / span_count
+
+        children.each_with_index do |col, i|
+          is_last_column = i == (columns_count - 1)
+          col.set_column_styles(column_width, margin_size, is_last_column)
+        end
+      end
+
+      def columns_span_count
+        count = 0
+        children.each {|column| count += column.span_size }
+
+        count
+      end
+
+    end
+
+    class Column < ActiveAdmin::Component
+
+      attr_accessor :span_size, :max_width, :min_width
+
+      # @param [Hash] options An options hash for the column
+      #
+      # @options options [Integer] :span The columns this column should span
+      def build(options = {})
+        options = options.dup
+        @span_size = options.delete(:span) || 1
+        @max_width = options.delete(:max_width)
+        @min_width = options.delete(:min_width)
+
+        super(options)
+      end
+
+      def set_column_styles(column_width, margin_width, is_last_column = false)
+        column_with_span_width = (span_size * column_width) + ((span_size - 1) * margin_width)
+
+        styles = []
+
+        styles << "width: #{column_with_span_width}%;"
+
+        if max_width
+          styles << "max-width: #{max_width};"
+        end
+
+        if min_width
+          styles << "min-width: #{min_width};"
+        end
+
+        styles << "margin-right: #{margin_width}%;" unless is_last_column
+
+        set_attribute :style, styles.join(" ")
+      end
+
+    end
+  end
+end

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

@@ -0,0 +1,73 @@
+require 'active_admin/views/components/popover'
+
+module ActiveAdmin
+  module Views
+
+    # Action List - A button with a drop down menu of links
+    #
+    # Creating a new action list:
+    #
+    #     dropdown_menu "Administration" do
+    #       item "Edit Details", edit_details_path
+    #       item "Edit My Account", edit_my_acccount_path
+    #     end
+    #
+    # This will create a button with the label "Administration" and
+    # a drop down once clicked with 2 options.
+    #
+    class DropdownMenu < ActiveAdmin::Component
+      builder_method :dropdown_menu
+
+      # Build a new action list
+      #
+      # @param [String] name  The name to display in the button
+      #
+      # @param [Hash] options A set of options that get passed along to
+      #                       to the parent dom element.
+      def build(name, options = {})
+        options = options.dup
+
+        # Easily set options for the button or menu
+        button_options  = options.delete(:button) || {}
+        menu_options = options.delete(:menu) || {}
+
+        @button  = build_button(name, button_options)
+        @menu = build_menu(menu_options)
+
+        super(options)
+      end
+
+      def item(*args)
+        within @menu do
+          li link_to(*args)
+        end
+      end
+
+      private
+
+      def build_button(name, button_options)
+        button_options[:class] ||= ""
+        button_options[:class] << " dropdown_menu_button"
+
+        button_options[:href] = "#"
+
+        a name, button_options
+      end
+
+      def build_menu(options)
+        options[:class] ||= ""
+        options[:class] << " dropdown_menu_list"
+
+        menu_list = nil
+
+        div :class => "dropdown_menu_list_wrapper", :style => "display:none;" do
+          menu_list = ul(options)
+        end
+
+        menu_list
+      end
+
+    end
+
+  end
+end

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

@@ -0,0 +1,68 @@
+require 'active_admin/helpers/collection'
+
+module ActiveAdmin
+	module Views
+
+    # Renders a collection of index views available to the resource
+    # as a list with a separator
+		class IndexList < ActiveAdmin::Component
+      builder_method :index_list_renderer
+
+      include ::ActiveAdmin::Helpers::Collection
+
+      def default_class_name
+        "indexes table_tools_segmented_control"
+      end
+
+      def tag_name
+        'ul'
+      end
+
+      # Builds the links for presenting different index views to the user
+      #
+      # @param [Array] index_classes The class constants that represent index page presenters
+      def build(index_classes)
+        unless current_filter_search_empty?
+          index_classes.each do |index_class|
+            build_index_list(index_class)
+          end
+        end
+      end
+
+      protected
+
+      # Builds the individual link and HTML classes for each index page presenter
+      #
+      # @param [Class] index_class The class on which to build the link and html classes
+      def build_index_list(index_class)
+        li :class => classes_for_index(index_class) do
+          a :href => url_for(params.merge(:as => index_class.index_name.to_sym)), :class => "table_tools_button" do
+            name = index_class.index_name
+            I18n.t("active_admin.index_list.#{name}", :default => name.to_s.titleize)
+          end
+        end
+      end
+
+      def classes_for_index(index_class)
+        classes = ["index"]
+        classes << "selected" if current_index?(index_class)
+        classes.join(" ")
+      end
+
+      def current_index?(index_class)
+        if params[:as]
+          params[:as] == index_class.index_name
+        else
+          active_admin_config.default_index_class == index_class
+        end
+      end
+
+      def current_filter_search_empty?
+        params.include?(:q) && collection_is_empty?
+      end
+
+		end
+	end
+end
+
+