para 0.4.0 → 0.5.0

data/lib/para/attribute_field/enum.rb

@@ -0,0 +1,22 @@
+module Para
+  module AttributeField
+    class EnumField < AttributeField::Base
+      register :enum, self
+
+      def value_for(instance)
+        if (raw_value = instance.send(name)) &&
+          path = enum_path_for(instance, raw_value)
+          translation = I18n.t("activerecord.#{ path }", default: false)
+
+          translation || raw_value
+        end
+      end
+
+      private
+
+      def enum_path_for(instance, key)
+        ['enums', instance.class.model_name.i18n_key, name, key].join('.')
+      end
+    end
+  end
+end

data/lib/para/attribute_field/file.rb

@@ -3,6 +3,8 @@ module Para
     class FileField < AttributeField::Base
       include ActionView::Helpers::UrlHelper
 
+      register :file, self
+
       field_option :wrapper, :wrapper_name
 
       def value_for(instance)

data/lib/para/attribute_field/has_many.rb

@@ -1,6 +1,8 @@
 module Para
   module AttributeField
     class HasManyField < RelationField
+      register :has_many, self
+
       def field_name
         reflection.name
       end

data/lib/para/attribute_field/image.rb

@@ -3,6 +3,8 @@ module Para
     class ImageField < AttributeField::Base
       include ActionView::Helpers::AssetTagHelper
 
+      register :image, self
+
       def value_for(instance)
         style = attachment_thumb_style_for(instance)
 

data/lib/para/attribute_field/nested_many.rb

@@ -1,12 +1,15 @@
 module Para
   module AttributeField
     class NestedManyField < AttributeField::HasManyField
+      register :nested_many, self
+
       def parse_input(params)
         if (nested_attributes = params[nested_attributes_key])
           nested_attributes.each do |index, attributes|
             nested_model_mappings.fields.each do |field|
               field.parse_input(attributes)
             end
+
             params[nested_attributes_key][index] = attributes
           end
         else

data/lib/para/attribute_field/nested_one.rb

@@ -1,15 +1,15 @@
 module Para
   module AttributeField
     class NestedOneField < AttributeField::BelongsToField
+      register :nested_one, self
+
       def parse_input(params)
         if (nested_attributes = params[nested_attributes_key])
-          nested_attributes.each do |index, attributes|
-            nested_model_mappings.fields.each do |field|
-              field.parse_input(attributes)
-            end
-
-            params[nested_attributes_key][index] = attributes
+          nested_model_mappings.fields.each do |field|
+            field.parse_input(nested_attributes)
           end
+
+          params[nested_attributes_key] = nested_attributes
         else
           super(params)
         end

data/lib/para/attribute_field/password.rb

@@ -1,6 +1,8 @@
 module Para
   module AttributeField
     class PasswordField < AttributeField::Base
+      register :password, self
+
       def initialize(model, options = {})
         options.reverse_merge!(type: 'password', field_type: 'password')
         super(model, options)

data/lib/para/attribute_field/redactor.rb

@@ -4,6 +4,8 @@ module Para
       include ActionView::Helpers::SanitizeHelper
       include ActionView::Helpers::TextHelper
 
+      register :redactor, self
+
       def initialize(model, options = {})
         options.reverse_merge!(type: 'text', field_type: 'redactor')
         super(model, options)

data/lib/para/attribute_field/translation.rb

@@ -1,6 +1,8 @@
 module Para
   module AttributeField
     class Translation < AttributeField::Base
+      register :translation, self
+
       def attribute_column_path
         [:translations, name]
       end

data/lib/para/attribute_field.rb

@@ -0,0 +1,19 @@
+module Para
+  module AttributeField
+  end
+end
+
+require 'para/attribute_field/base'
+require 'para/attribute_field/boolean'
+require 'para/attribute_field/datetime'
+require 'para/attribute_field/password'
+require 'para/attribute_field/file'
+require 'para/attribute_field/image'
+require 'para/attribute_field/enum'
+require 'para/attribute_field/relation'
+require 'para/attribute_field/belongs_to'
+require 'para/attribute_field/has_many'
+require 'para/attribute_field/nested_one'
+require 'para/attribute_field/nested_many'
+require 'para/attribute_field/redactor'
+require 'para/attribute_field/translation'

data/lib/para/attribute_field_mappings.rb

@@ -1,17 +1,3 @@
-require 'para/attribute_field/base'
-require 'para/attribute_field/boolean'
-require 'para/attribute_field/datetime'
-require 'para/attribute_field/password'
-require 'para/attribute_field/file'
-require 'para/attribute_field/image'
-require 'para/attribute_field/relation'
-require 'para/attribute_field/belongs_to'
-require 'para/attribute_field/has_many'
-require 'para/attribute_field/nested_one'
-require 'para/attribute_field/nested_many'
-require 'para/attribute_field/redactor'
-require 'para/attribute_field/translation'
-
 module Para
   class AttributeFieldMappings
     UNEDITABLE_ATTRIBUTES = %w(id component_id created_at updated_at type)
@@ -30,13 +16,19 @@ module Para
     end
 
     def field_for(field_name, type = nil)
-      fields_hash[field_name] ||= if model.new.respond_to?(field_name)
-        build_field_for(field_name, type)
+      existing_field = fields_hash[field_name]
+
+      if !existing_field || (type && !existing_field.type?(type))
+        fields_hash[field_name] = if model.new.respond_to?(field_name)
+          build_field_for(field_name, type)
+        else
+          raise NoMethodError.new(
+            "No attribute or method correspond to ##{ field_name } " +
+            "in the model #{ model.name }. No field could be created."
+          )
+        end
       else
-        raise NoMethodError.new(
-          "No attribute or method correspond to ##{ field_name } " +
-          "in the model #{ model.name }. No field could be created."
-        )
+        existing_field
       end
     end
 
@@ -65,18 +57,12 @@ module Para
 
     def build_field_for(attribute_name, type)
       field_class = field_class_for(type)
-
-      field_class.new(
-        model, name: attribute_name, type: type
-      )
+      field_class.new(model, name: attribute_name, type: type)
     end
 
     def field_class_for(type)
-      case type
-      when :boolean then AttributeField::BooleanField
-      when :date, :datetime then AttributeField::DatetimeField
-      else AttributeField::Base
-      end
+      attribute_class = type && AttributeField::Base.field_types[type.to_sym]
+      attribute_class || AttributeField::Base
     end
   end
 end

data/lib/para/breadcrumbs/breadcrumb.rb

@@ -0,0 +1,43 @@
+module Para
+  module Breadcrumbs
+    class Breadcrumb
+      attr_reader :identifier, :_path, :options
+
+      def initialize(identifier, path, *options)
+        @identifier = identifier
+        @_path = path
+        @options = options
+      end
+
+      def title
+        @title ||= if Symbol === identifier
+          I18n.t("admin.breadcrumbs.#{ identifier }")
+        else
+          identifier
+        end
+      end
+
+      # Allow lazy evaluation of routes to define breadcrumbs before being
+      # able to access request or routes
+      def path
+        @path ||= if Symbol === _path
+          find_route_for(_path, *options)
+        elsif _path
+          _path
+        else
+          '#'
+        end
+      end
+
+      def active?(request)
+        path == request.path || !_path
+      end
+
+      private
+
+      def find_route_for(path, *options)
+        Rails.application.routes.url_helpers.send(:"#{ path }_path", *options)
+      end
+    end
+  end
+end

data/lib/para/breadcrumbs/controller.rb

@@ -0,0 +1,39 @@
+module Para
+  module Breadcrumbs
+    module Controller
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :_class_level_breadcrumbs
+
+        helper_method :add_breadcrumb, :breadcrumbs
+        helper ViewHelper
+      end
+
+      def add_breadcrumb(*args)
+        breadcrumbs.add(*args)
+      end
+
+      def breadcrumbs
+        Para.store[:breadcrumbs] ||= begin
+          manager = Breadcrumbs::Manager.new
+          _class_level_breadcrumbs.each { |args| manager.add(*args) }
+          manager
+        end
+      end
+
+      module ClassMethods
+        def add_breadcrumb(*args)
+          self._class_level_breadcrumbs ||= []
+          self._class_level_breadcrumbs += [args]
+        end
+      end
+
+      module ViewHelper
+        def render_breadcrumbs
+          render partial: 'para/admin/shared/breadcrumbs'
+        end
+      end
+    end
+  end
+end

data/lib/para/breadcrumbs/manager.rb

@@ -0,0 +1,19 @@
+module Para
+  module Breadcrumbs
+    class Manager
+      include Enumerable
+
+      def add(identifier, path = nil, *args)
+        breadcrumbs << Breadcrumb.new(identifier, path, *args)
+      end
+
+      def breadcrumbs
+        @breadcrumbs ||= []
+      end
+
+      def each(&block)
+        breadcrumbs.each(&block)
+      end
+    end
+  end
+end

data/lib/para/breadcrumbs.rb

@@ -0,0 +1,9 @@
+module Para
+  module Breadcrumbs
+    extend ActiveSupport::Autoload
+
+    autoload :Manager
+    autoload :Breadcrumb
+    autoload :Controller
+  end
+end

data/lib/para/component/importable.rb

@@ -0,0 +1,25 @@
+module Para
+  module Component
+    module Importable
+      extend ActiveSupport::Concern
+
+      included do
+        configurable_on :importers
+      end
+
+      def importable?
+        @importable ||= imports.length > 0
+      end
+
+      # TODO : Move :configuration column store to JSON instead of HStore
+      # which handles more data types and will help us avoid eval here
+      def imports
+        @imports ||= if importers.present?
+          eval(importers)
+        else
+          []
+        end
+      end
+    end
+  end
+end

data/lib/para/component/subclassable.rb

@@ -0,0 +1,27 @@
+module Para
+  module Component
+    module Subclassable
+      extend ActiveSupport::Concern
+
+      included do
+        configurable_on :subclasses
+      end
+
+      def subclassable?
+        @subclassable ||= subclass_names.length > 0
+      end
+
+      def subclassable_with?(class_name)
+        subclassable? && class_name.in?(subclass_names)
+      end
+
+      def subclass_names
+        @subclass_names ||= if subclasses.present?
+          eval(subclasses)
+        else
+          []
+        end
+      end
+    end
+  end
+end

data/lib/para/component.rb

@@ -4,9 +4,9 @@ module Para
       @registered_components ||= {}
     end
 
-    def self.registered_component?(model_name)
-      registered_components.any? do |name, component|
-        component.name == model_name
+    def self.registered_component?(identifier)
+      registered_components.any? do |component_identifier, _|
+        component_identifier == identifier
       end
     end
 
@@ -18,6 +18,8 @@ end
 
 # Require concerns
 require 'para/component/exportable'
+require 'para/component/importable'
+require 'para/component/subclassable'
 
 # Require models
 require 'para/component/base'

data/lib/para/components_configuration.rb

@@ -1,5 +1,8 @@
 module Para
   class ComponentsConfiguration
+    class UndefinedComponentTypeError < StandardError
+    end
+
     def draw(&block)
       return unless components_installed?
       eager_load_components!
@@ -85,6 +88,12 @@ module Para
       tables_exist
     end
 
+    # Eager loads every file ending with _component.rb that's included in a
+    # $LOAD_PATH directory which ends in "/components"
+    #
+    # Note : This allows not to process too many folders, but makes it harder to
+    # plug gems into the components system
+    #
     def eager_load_components!
       $LOAD_PATH.each do |path|
         next unless path.match(/\/components$/)
@@ -127,10 +136,17 @@ module Para
     class Component
       attr_accessor :identifier, :type, :options, :model
 
-      def initialize(identifier, type, options = {})
+      def initialize(identifier, type_identifier, options = {})
         self.identifier = identifier.to_s
-        self.type = Para::Component.registered_components[type]
+        self.type = Para::Component.registered_components[type_identifier]
         self.options = options
+
+        unless type
+          raise UndefinedComponentTypeError.new(
+            "Undefined Para component : #{ type_identifier }. " +
+            "Please ensure that your app or gems define this component type."
+          )
+        end
       end
 
       def refresh(attributes = {})

data/lib/para/config.rb

@@ -16,6 +16,30 @@ module Para
     @@default_tree_max_depth = 3
 
     mattr_accessor :resource_name_methods
-    @@resource_name_methods = [:name, :title]
+    @@resource_name_methods = [:admin_name, :admin_title, :name, :title]
+
+    mattr_accessor :ability_class_name
+    @@ability_class_name = 'Para::Ability'
+
+    mattr_accessor :plugins
+    @@plugins = []
+
+    # Allows accessing plugins root module to configure them through a method
+    # from the Para::Config class.
+    #
+    # Example :
+    #
+    #   Para.config do |config|
+    #     config.my_plugin.my_var = 'foo'
+    #   end
+    #
+    def self.method_missing(method_name, *args, &block)
+      if plugins.include?(method_name)
+        plugin = Para::Plugins.module_name_for(method_name).constantize
+        block ? block.call(plugin) : plugin
+      else
+        super
+      end
+    end
   end
 end

data/lib/para/exporter/base.rb

@@ -2,11 +2,24 @@ module Para
   module Exporter
     class Base
       attr_reader :resources
+      class_attribute :model_name
 
       def initialize(resources)
         @resources = resources
       end
 
+      def model
+        @model ||= if (model_name = self.class.model_name)
+          model_name.constantize
+        else
+          raise 'You must define model to export in your exporter as following: `exports \'YourModelName\'`'
+        end
+      end
+
+      def self.exports model_name
+        self.model_name = model_name
+      end
+
       def disposition
         'inline'
       end

data/lib/para/exporter/csv.rb

@@ -31,7 +31,7 @@ module Para
 
       def headers
         fields.map do |field|
-          encode(User.human_attribute_name(field))
+          encode(model.human_attribute_name(field))
         end
       end
 

data/lib/para/form_builder/tabs.rb

@@ -0,0 +1,56 @@
+module Para
+  module FormBuilder
+    module Tabs
+      def tabs(&block)
+        tabs_manager = TabsManager.new(template, object)
+        block.call(tabs_manager)
+
+        template.render partial: 'para/form/tabs', locals: { tabs: tabs_manager.tabs }
+      end
+
+      class TabsManager
+        attr_reader :template, :object
+
+        def initialize(template, object)
+          @template = template
+          @object = object
+        end
+
+        def tab(identifier, options = {}, &block)
+          tabs << Tab.new(template, object, identifier, options, &block)
+          nil
+        end
+
+        def tabs
+          @tabs ||= []
+        end
+      end
+
+      class Tab
+        attr_reader :template, :object, :identifier, :icon, :content
+
+        delegate :capture, to: :template
+
+        def initialize(template, object, identifier, options, &content_block)
+          @template = template
+          @object = object
+          @identifier = identifier
+          @content = capture { content_block.call }
+          @icon = options[:icon]
+        end
+
+        def title
+          if Symbol === identifier
+            I18n.t("forms.tabs.#{ object.class.model_name.i18n_key }.#{ identifier }")
+          else
+            identifier
+          end
+        end
+
+        def dom_id
+          @dom_id = identifier.to_s.parameterize
+        end
+      end
+    end
+  end
+end

data/lib/para/form_builder.rb

@@ -5,6 +5,7 @@ require 'para/form_builder/field_mappings'
 require 'para/form_builder/nested_form'
 require 'para/form_builder/ordering'
 require 'para/form_builder/settings'
+require 'para/form_builder/tabs'
 
 # We'll implement our own form builder later, but for now it would need to
 # patch or override Cocoon to allow creating nested fields with our custom
@@ -17,6 +18,7 @@ SimpleForm::FormBuilder.class_eval do
   include Para::FormBuilder::NestedForm
   include Para::FormBuilder::Ordering
   include Para::FormBuilder::Settings
+  include Para::FormBuilder::Tabs
 end
 
 SimpleForm::FormBuilder.map_type(:inet, to: SimpleForm::Inputs::StringInput)

data/lib/para/generators/component_helpers.rb

@@ -0,0 +1,57 @@
+module Para
+  module Generators
+    module ComponentHelpers
+      private
+
+      def add_component_to_routes(component_type, name)
+        route_file = File.read(Rails.root.join('config/routes.rb'))
+
+        unless route_file.match /^\s+namespace :admin do/
+          route "namespace :admin do\n  end\n"
+        end
+
+        inject_into_file 'config/routes.rb', after: '  namespace :admin do' do
+          "\n    #{ component_type } :#{ name }"
+        end
+      end
+
+      def component_name
+        if class_name.match(/Component/i)
+          class_name
+        else
+          "#{ class_name }Component"
+        end
+      end
+
+      def component_file_name
+        if file_name.match(/component/i)
+          file_name
+        else
+          "#{ file_name }_component"
+        end
+      end
+
+      def decorator_parent_name
+        @decorator_parent_name ||= [component_parent_name, 'Decorator'].join
+      end
+
+      def resources_controller_name
+        @resources_name ||= [
+          singular_name.singularize, 'resources', 'controller'
+        ].join('_')
+      end
+
+      def controller_name
+        @controller_name ||= resources_controller_name.camelize
+      end
+
+      def decorator_file_name
+        @decorator_file_name ||= [component_file_name, 'decorator'].join('_')
+      end
+
+      def decorator_name
+        @decorator_name ||= decorator_file_name.camelize
+      end
+    end
+  end
+end

data/lib/para/generators.rb

@@ -7,5 +7,6 @@ module Para
     autoload :FieldHelpers
     autoload :NamedBase
     autoload :NameHelpers
+    autoload :ComponentHelpers
   end
 end

data/lib/para/importer/base.rb

@@ -0,0 +1,23 @@
+module Para
+  module Importer
+    class Base
+      attr_reader :sheet
+
+      def initialize(file)
+        @sheet = Roo::Spreadsheet.open(file.path)
+      end
+
+      def run
+        ActiveRecord::Base.transaction do
+          (2..(sheet.last_row)).each do |index|
+            import_from_row(sheet.row(index))
+          end
+        end
+      end
+
+      def import_from_row(row)
+        raise '#import_from_row(row) must be defined'
+      end
+    end
+  end
+end

data/lib/para/importer.rb

@@ -0,0 +1,10 @@
+module Para
+  module Importer
+    def self.model_importer_name(model_name)
+      [model_name.to_s.pluralize, 'importer'].join
+    end
+  end
+end
+
+require 'para/importer/base'
+