activeadministration 0.0.1

data/lib/active_admin/resource_controller/resource_class_methods.rb

@@ -0,0 +1,24 @@
+module ActiveAdmin
+  class ResourceController < BaseController
+    module ResourceClassMethods
+
+      # Override the default `resource_class` class and instance
+      # methods to only return the class defined in the instance
+      # of ActiveAdmin::Resource
+      def override_resource_class_methods!
+        class_exec do
+          def self.resource_class=(klass); end
+
+          def self.resource_class
+            @active_admin_config ? @active_admin_config.resource_class : nil
+          end
+
+          def resource_class
+            self.class.resource_class
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/active_admin/resource_controller/scoping.rb

@@ -0,0 +1,31 @@
+module ActiveAdmin
+  class ResourceController < BaseController
+
+    # This module deals with scoping entire controllers to a relation
+    module Scoping
+      extend ActiveSupport::Concern
+
+      protected
+
+      # Override the default InheritedResource #begin_of_association_chain to allow
+      # the scope to be defined in the active admin configuration.
+      #
+      # If scope_to is a proc, we eval it, otherwise we call the method on the controller.
+      #
+      # Collection can be scoped conditionally with an :if or :unless proc.
+      def begin_of_association_chain
+        return nil unless active_admin_config.scope_to?(self)
+        render_in_context(self, active_admin_config.scope_to_method)
+      end
+
+      # Overriding from InheritedResources::BaseHelpers
+      #
+      # Returns the method for the association chain when using
+      # the scope_to option
+      def method_for_association_chain
+        active_admin_config.scope_to_association_method || super
+      end
+
+    end
+  end
+end

data/lib/active_admin/resource_controller/sidebars.rb

@@ -0,0 +1,18 @@
+module ActiveAdmin
+  class ResourceController < BaseController
+
+    module Sidebars
+
+      protected
+
+      def skip_sidebar!
+        @skip_sidebar = true
+      end
+
+      def skip_sidebar?
+        @skip_sidebar == true
+      end
+    end
+
+  end
+end

data/lib/active_admin/resource_dsl.rb

@@ -0,0 +1,171 @@
+module ActiveAdmin
+  # This is the class where all the register blocks are evaluated.
+  class ResourceDSL < DSL
+    def initialize(config, resource_class)
+      @resource = resource_class
+      super(config)
+    end
+
+    private
+
+    def belongs_to(target, options = {})
+      config.belongs_to(target, options)
+    end
+
+    # Scope collection to a relation
+    def scope_to(*args, &block)
+      config.scope_to(*args, &block)
+    end
+
+    # Create a scope
+    def scope(*args, &block)
+      config.scope(*args, &block)
+    end
+
+    #
+    # Rails 4 Strong Parameters Support
+    #
+    # Either
+    #
+    #   permit_params :title, :author, :body
+    #
+    # Or
+    #
+    #   permit_params do
+    #     defaults = [:title, :body]
+    #     if current_user.admin?
+    #       defaults + [:author]
+    #     else
+    #       defaults
+    #     end
+    #   end
+    #
+    def permit_params(*args, &block)
+      resource_sym = config.resource_name.singular.to_sym
+
+      controller do
+        define_method :permitted_params do
+          params.permit resource_sym =>
+                        block ? instance_exec(&block) : args
+        end
+      end
+    end
+
+    # Configure the index page for the resource
+    def index(options = {}, &block)
+      options[:as] ||= :table
+      config.set_page_presenter :index, ActiveAdmin::PagePresenter.new(options, &block)
+    end
+
+    # Configure the show page for the resource
+    def show(options = {}, &block)
+      config.set_page_presenter :show, ActiveAdmin::PagePresenter.new(options, &block)
+    end
+
+    def form(options = {}, &block)
+      config.set_page_presenter :form, ActiveAdmin::PagePresenter.new(options, &block)
+    end
+
+    # Configure the CSV format
+    #
+    # For example:
+    #
+    #   csv do
+    #     column :name
+    #     column("Author") { |post| post.author.full_name }
+    #   end
+    #
+    #   csv col_sep: ";", force_quotes: true do
+    #     column :name
+    #   end
+    #
+    def csv(options={}, &block)
+      options[:resource] = @resource
+
+      config.csv_builder = CSVBuilder.new(options, &block)
+    end
+
+    # Member Actions give you the functionality of defining both the
+    # action and the route directly from your ActiveAdmin registration
+    # block.
+    #
+    # For example:
+    #
+    #   ActiveAdmin.register Post do
+    #     member_action :comments do
+    #       @post = Post.find(params[:id]
+    #       @comments = @post.comments
+    #     end
+    #   end
+    #
+    # Will create a new controller action comments and will hook it up to
+    # the named route (comments_admin_post_path) /admin/posts/:id/comments
+    #
+    # You can treat everything within the block as a standard Rails controller
+    # action.
+    #
+    def action(set, name, options = {}, &block)
+      set << ControllerAction.new(name, options)
+      title = options.delete(:title)
+
+      controller do
+        before_filter(only: [name]) { @page_title = title } if title
+        define_method(name, &block || Proc.new{})
+      end
+    end
+
+    def member_action(name, options = {}, &block)
+      action config.member_actions, name, options, &block
+    end
+
+    def collection_action(name, options = {}, &block)
+      action config.collection_actions, name, options, &block
+    end
+
+    # Defined Callbacks
+    #
+    # == After Build
+    # Called after the resource is built in the new and create actions.
+    #
+    # ActiveAdmin.register Post do
+    #   after_build do |post|
+    #     post.author = current_user
+    #   end
+    # end
+    #
+    # == Before / After Create
+    # Called before and after a resource is saved to the db on the create action.
+    #
+    # == Before / After Update
+    # Called before and after a resource is saved to the db on the update action.
+    #
+    # == Before / After Save
+    # Called before and after the object is saved in the create and update action.
+    # Note: Gets called after the create and update callbacks
+    #
+    # == Before / After Destroy
+    # Called before and after the object is destroyed from the database.
+    #
+    delegate :before_build,   :after_build,   to: :controller
+    delegate :before_create,  :after_create,  to: :controller
+    delegate :before_update,  :after_update,  to: :controller
+    delegate :before_save,    :after_save,    to: :controller
+    delegate :before_destroy, :after_destroy, to: :controller
+
+    # Standard rails filters
+    delegate :before_filter, :skip_before_filter, :after_filter, :skip_after_filter, :around_filter, :skip_filter,
+             to: :controller
+
+    # Specify which actions to create in the controller
+    #
+    # Eg:
+    #
+    #   ActiveAdmin.register Post do
+    #     actions :index, :show
+    #   end
+    #
+    # Will only create the index and show actions (no create, update or delete)
+    delegate :actions, to: :controller
+
+  end
+end

data/lib/active_admin/router.rb

@@ -0,0 +1,106 @@
+module ActiveAdmin
+  class Router
+    def initialize(application)
+      @application = application
+    end
+
+    # Creates all the necessary routes for the ActiveAdmin configurations
+    #
+    # Use this within the routes.rb file:
+    #
+    #   Application.routes.draw do |map|
+    #     ActiveAdmin.routes(self)
+    #   end
+    #
+    def apply(router)
+      define_root_routes router
+      define_resource_routes router
+    end
+
+    def define_root_routes(router)
+      router.instance_exec @application.namespaces.values do |namespaces|
+        namespaces.each do |namespace|
+          if namespace.root?
+            root to: namespace.root_to
+          else
+            namespace namespace.name do
+              root to: namespace.root_to
+            end
+          end
+        end
+      end
+    end
+
+    # Defines the routes for each resource
+    def define_resource_routes(router)
+      router.instance_exec @application.namespaces, self do |namespaces, aa_router|
+        resources = namespaces.values.map{ |n| n.resources.values }.flatten
+        resources.each do |config|
+          routes = aa_router.resource_routes(config)
+
+          # Add in the parent if it exists
+          if config.belongs_to?
+            belongs_to = routes
+            routes     = Proc.new do
+              # If it's optional, make the normal resource routes
+              instance_exec &belongs_to if config.belongs_to_config.optional?
+
+              # Make the nested belongs_to routes
+              # :only is set to nothing so that we don't clobber any existing routes on the resource
+              resources config.belongs_to_config.target.resource_name.plural, only: [] do
+                instance_exec &belongs_to
+              end
+            end
+          end
+
+          # Add on the namespace if required
+          unless config.namespace.root?
+            nested = routes
+            routes = Proc.new do
+              namespace config.namespace.name do
+                instance_exec &nested
+              end
+            end
+          end
+
+          instance_exec &routes
+        end
+      end
+    end
+
+    def resource_routes(config)
+      Proc.new do
+        # Builds one route for each HTTP verb passed in
+        build_route  = proc{ |verbs, *args|
+          [*verbs].each{ |verb| send verb, *args }
+        }
+        # Deals with +ControllerAction+ instances
+        build_action = proc{ |action|
+          build_route.call(action.http_verb, action.name)
+        }
+        case config
+        when ::ActiveAdmin::Resource
+          resources config.resource_name.route_key, only: config.defined_actions do
+            member do
+              config.member_actions.each &build_action
+            end
+
+            collection do
+              config.collection_actions.each &build_action
+              post :batch_action if config.batch_actions_enabled?
+            end
+          end
+        when ::ActiveAdmin::Page
+          page = config.underscored_resource_name
+          get "/#{page}" => "#{page}#index"
+          config.page_actions.each do |action|
+            build_route.call action.http_verb, "/#{page}/#{action.name}" => "#{page}##{action.name}"
+          end
+        else
+          raise "Unsupported config class: #{config.class}"
+        end
+      end
+
+    end
+  end
+end

data/lib/active_admin/scope.rb

@@ -0,0 +1,57 @@
+module ActiveAdmin
+  class Scope
+
+    attr_reader :scope_method, :id, :scope_block, :display_if_block, :show_count, :default_block
+
+    # Create a Scope
+    #
+    # Examples:
+    #
+    #   Scope.new(:published)
+    #   # => Scope with name 'Published' and scope method :published
+    #
+    #   Scope.new('Published', :public)
+    #   # => Scope with name 'Published' and scope method :public
+    #
+    #   Scope.new 'Published', :public, if: proc { current_admin_user.can? :manage, resource_class } do |articles|
+    #     articles.where published: true
+    #   end
+    #   # => Scope with name 'Published' and scope method :public, optionally displaying the scope per the :if block
+    #
+    #   Scope.new('Published') { |articles| articles.where(published: true) }
+    #   # => Scope with name 'Published' using a block to scope
+    #
+    #   Scope.new ->{Date.today.strftime '%A'}, :published_today
+    #   # => Scope with dynamic title using the :published_today scope method
+    #
+    def initialize(name, method = nil, options = {}, &block)
+      @name, @scope_method = name, method.try(:to_sym)
+
+      if name.is_a? Proc
+        raise "A string/symbol is required as the second argument if your label is a proc." unless method
+        @id = method.to_s.parameterize("_")
+      else
+        @scope_method ||= name.to_sym
+        @id = name.to_s.parameterize("_")
+      end
+
+      @scope_method               = nil        if @scope_method == :all
+      @scope_method, @scope_block = nil, block if block_given?
+
+      @show_count       = options[:show_count].nil? ? true : options[:show_count]
+      @display_if_block = options[:if]      || proc{ true }
+      @default_block    = options[:default] || proc{ false }
+
+    end
+
+    def name
+      case @name
+        when Proc   then @name.call.to_s
+        when String then @name
+        when Symbol then @name.to_s.titleize
+        else             @name.to_s
+      end
+    end
+
+  end
+end

data/lib/active_admin/sidebar_section.rb

@@ -0,0 +1,45 @@
+module ActiveAdmin
+
+  class SidebarSection
+    include ActiveAdmin::OptionalDisplay
+
+    attr_accessor :name, :options, :block
+
+    def initialize(name, options = {}, &block)
+      @name, @options, @block = name, options, block
+      normalize_display_options!
+    end
+
+    # The id gets used for the div in the view
+    def id
+      "#{name.to_s.downcase.underscore}_sidebar_section".parameterize
+    end
+
+    def icon?
+      !!options[:icon]
+    end
+
+    def icon
+      options[:icon] if icon?
+    end
+
+    # The title gets displayed within the section in the view
+    def title
+      I18n.t("active_admin.sidebars.#{name.to_s}", default: name.to_s.titlecase)
+    end
+
+    # If a block is not passed in, the name of the partial to render
+    def partial_name
+      options[:partial] || "#{name.to_s.downcase.gsub(' ', '_')}_sidebar"
+    end
+
+    def custom_class
+      options[:class]
+    end
+
+    def priority
+      options[:priority] || 10
+    end
+  end
+
+end