para 0.4.0

data/app/controllers/para/admin/resources_controller.rb

@@ -0,0 +1,163 @@
+require_dependency "para/application_controller"
+
+module Para
+  module Admin
+    class ResourcesController < Para::Admin::BaseController
+      include Para::ModelHelper
+
+      class_attribute :resource_name, :resource_class
+      load_and_authorize_component
+      helper_method :resource
+
+      def new
+        render 'para/admin/resources/new'
+      end
+
+      def create
+        # Assign component the resource belongs to it
+        resource.component = @component if resource.respond_to?(:component=)
+
+        if resource.save
+          flash_message(:success, resource)
+          redirect_to after_form_submit_path
+        else
+          flash_message(:error, resource)
+          render 'new'
+        end
+      end
+
+      def edit
+        render 'para/admin/resources/edit'
+      end
+
+      def update
+        if resource.update_attributes(resource_params)
+          flash_message(:success, resource)
+          redirect_to after_form_submit_path
+        else
+          flash_message(:error, resource)
+          render 'edit'
+        end
+      end
+
+      def destroy
+        resource.destroy
+        flash_message(:success, resource)
+        redirect_to @component.path
+      end
+
+      def order
+        ActiveRecord::Base.transaction do
+          resources_data.each do |resource_params|
+            resource = resources_hash[resource_params[:id]]
+            resource.position = resource_params[:position].to_i
+            resource.save(validate: false)
+          end
+        end
+
+        head 200
+      end
+
+      def tree
+        ActiveRecord::Base.transaction do
+          resources_data.each do |resource_params|
+            resource = resources_hash[resource_params[:id]]
+            resource.assign_attributes(
+              position: resource_params[:position].to_i,
+              parent_id: resource_params[:parent_id]
+            )
+            resource.save(validate: false)
+          end
+        end
+
+        head 200
+      end
+
+      private
+
+      def after_form_submit_path
+        if params[:_save_and_edit]
+          { action: 'edit', id: resource.to_param }
+        elsif params[:_save_and_add_another]
+          { action: 'new' }
+        else
+          params.delete(:return_to).presence || @component.path
+        end
+      end
+
+      def resource_model
+        self.class.resource_model
+      end
+
+      def resource
+        @resource ||= begin
+          self.class.ensure_resource_name_defined!
+          instance_variable_get(:"@#{ self.class.resource_name }")
+        end
+      end
+
+      def resource_params
+        @resource_params ||= parse_resource_params(
+          params.require(:resource).permit!
+        )
+      end
+
+      def parse_resource_params(hash)
+        model_field_mappings(resource_model).fields.each do |field|
+          field.parse_input(hash)
+        end
+
+        hash
+      end
+
+      def self.resource(name, options = {})
+        default_options = {
+          class: name.to_s.camelize,
+          through: :component,
+          parent: false
+        }
+
+        default_options.each do |key, value|
+          options[key] = value unless options.key?(key)
+        end
+
+        self.resource_name = name
+        self.resource_class = options[:class]
+
+        load_and_authorize_resource(name, options)
+      end
+
+      def self.resource_model
+        @resource_model ||= begin
+          ensure_resource_name_defined!
+          Para.const_get(resource_class)
+        end
+      end
+
+      def self.ensure_resource_name_defined!
+        unless resource_name.presence
+          raise "Resource not defined in your controller. " \
+                "You can define the resource of your controller with the " \
+                "`resource :resource_name` macro when subclassing " \
+                "Para::Admin::ResourcesController"
+        end
+      end
+
+      def resources_data
+        @resources_data ||= params[:resources].values
+      end
+
+      def resources_hash
+        @resources_hash ||= begin
+
+          ids = resources_data.map { |resource| resource[:id] }
+
+          resources = resource_model.where(id: ids)
+          resources.each_with_object({}) do |resource, hash|
+            hash[resource.id.to_s] = resource
+          end
+        end
+      end
+    end
+  end
+end

data/app/controllers/para/admin/settings_component_controller.rb

@@ -0,0 +1,11 @@
+module Para
+  module Admin
+    class SettingsComponentController < Para::Admin::BaseController
+      load_and_authorize_component
+
+      def show
+        @settings = SettingsRails::Form.new
+      end
+    end
+  end
+end

data/app/controllers/para/admin/settings_form_controller.rb

@@ -0,0 +1,21 @@
+module Para
+  module Admin
+    class SettingsFormController < Para::Admin::BaseController
+      load_and_authorize_component
+
+      def update
+        form = SettingsRails::Form.new
+        form.settings_attributes = settings_params[:settings_attributes]
+        form.save
+        flash_message(:success, form)
+        redirect_to admin_settings_path(@component)
+      end
+
+      private
+
+      def settings_params
+        params.require(:resource).permit(settings_attributes: [:key, :_type, :value])
+      end
+    end
+  end
+end

data/app/controllers/para/admin/singleton_resource_component_controller.rb

@@ -0,0 +1,14 @@
+module Para
+  module Admin
+    class SingletonResourceComponentController < Para::Admin::BaseController
+      load_and_authorize_component
+
+      attr_accessor :resource
+      helper_method :resource
+
+      def show
+        self.resource = @component.resource
+      end
+    end
+  end
+end

data/app/controllers/para/admin/singleton_resources_controller.rb

@@ -0,0 +1,30 @@
+require_dependency "para/application_controller"
+
+module Para
+  module Admin
+    class SingletonResourcesController < Para::Admin::ResourcesController
+      include Para::Admin::ResourceControllerConcerns
+
+      before_filter :load_and_authorize_singleton_resource
+      after_filter :attach_resource_to_component, only: [:create]
+
+      private
+
+      def attach_resource_to_component
+        return unless resource.persisted?
+        @component.resource = resource
+        @component.save
+      end
+
+      def load_and_authorize_singleton_resource
+        loader = self.class.cancan_resource_class.new(
+          self, :resource, parent: false, class: resource_model.name,
+          singleton: true, through: :component
+        )
+
+        loader.load_and_authorize_resource
+        instance_variable_set(:"@#{ resource_name }", @resource)
+      end
+    end
+  end
+end

data/app/controllers/para/application_controller.rb

@@ -0,0 +1,7 @@
+module Para
+  class ApplicationController < ActionController::Base
+    def current_ability
+      @current_ability ||= Ability.new(current_admin_user)
+    end
+  end
+end

data/app/decorators/para/component/base_decorator.rb

@@ -0,0 +1,48 @@
+module Para
+  module Component
+    module BaseDecorator
+      include Rails.application.routes.mounted_helpers
+      include ActionDispatch::Routing::PolymorphicRoutes
+
+      def path(options = {})
+        find_path([:admin, self], options)
+      end
+
+      def relation_path(controller_or_resource, options = {})
+        find_path([:admin, self, controller_or_resource], options)
+      end
+
+      private
+
+      # Try to find a polymorphic path for the given arguments
+      #
+      # If no route exist, we try all the existing engines too
+      # This is quite dirty but for now should work as desired
+      # The only problem is if we have engines that declare the same routes
+      #
+      def find_path(path, options)
+        polymorphic_path(path, options)
+      rescue NoMethodError, NameError => original_error
+        mounted_proxy_methods.each do |proxy_method|
+          begin
+            proxy = send(proxy_method)
+            return polymorphic_path(([proxy] + path), options)
+          rescue NoMethodError, NameError => e
+            next
+          end
+        end
+
+        raise original_error
+      end
+
+      def mounted_proxy_methods
+        @mounted_proxy_methods ||= begin
+          routes = Rails.application.routes
+          routes.mounted_helpers.instance_methods.select do |name|
+            /^[^_]/ =~ name
+          end
+        end
+      end
+    end
+  end
+end

data/app/decorators/para/component/crud_decorator.rb

@@ -0,0 +1,32 @@
+module Para
+  module Component
+    module CrudDecorator
+      include Para::Component::BaseDecorator
+
+      def relation_path(controller_or_resource, options = {})
+        if (id = extract_id_from(controller_or_resource))
+          options[:id] = id
+        end
+
+        route_key = route_key_for(options[:id], options)
+        options[:model] = model.model_name.singular_route_key
+
+        polymorphic_path([:admin, self, route_key].compact, options)
+      end
+
+      private
+
+      def extract_id_from(object)
+        object.id if object.respond_to?(:persisted?) && object.persisted?
+      end
+
+      def route_key_for(id, options)
+        if id || options[:action].presence && options[:action].to_sym == :new
+          :crud_resource
+        else
+          :crud_resources
+        end
+      end
+    end
+  end
+end

data/app/decorators/para/component/settings_decorator.rb

@@ -0,0 +1,11 @@
+module Para
+  module Component
+    module SettingsDecorator
+      include Para::Component::BaseDecorator
+
+      def path(options = {})
+        admin_settings_path(self, options)
+      end
+    end
+  end
+end

data/app/decorators/para/component/singleton_resource_decorator.rb

@@ -0,0 +1,11 @@
+module Para
+  module Component
+    module SingletonResourceDecorator
+      include Para::Component::BaseDecorator
+
+      def relation_path(controller_or_resource, options = {})
+        polymorphic_path([:admin, self, :singleton_resource].compact, options)
+      end
+    end
+  end
+end

data/app/decorators/para/component_section_decorator.rb

@@ -0,0 +1,4 @@
+module Para
+  module ComponentSectionDecorator
+  end
+end

data/app/helpers/para/admin/base_helper.rb

@@ -0,0 +1,57 @@
+module Para
+  module Admin
+    module BaseHelper
+      include Para::ApplicationHelper
+
+      def find_partial_for(relation, partial)
+        if relation.kind_of? ActiveRecord::Base
+          relation = relation.class
+        end
+
+        relation = relation.to_s.underscore.pluralize
+
+        if lookup_context.find_all("admin/#{relation}/_#{ partial }").any?
+          "admin/#{ relation }/#{ partial }"
+        else
+          "para/admin/resources/#{ partial }"
+        end
+      end
+
+      def template_path_lookup(*paths)
+        paths.find do |path|
+          lookup_context.find_all(path).any?
+        end
+      end
+
+      def resource_title_for(resource)
+        resource.try(:title) || resource.try(:name) ||
+        t('para.form.shared.edit.title', model: resource.class.model_name.human)
+      end
+
+      def registered_components_options
+        Para::Component.registered_components.keys.map do |identifier|
+          [
+            t("para.component.#{ identifier }.name", default: identifier.to_s.humanize),
+            identifier
+          ]
+        end
+      end
+
+      def flash_message(type, resource = nil)
+        key = "#{ flash_shared_key }.#{ params[:action] }.#{ type }"
+
+        translation = if resource
+          I18n.t(key, model: resource.class.model_name.human)
+        else
+          I18n.t(key)
+        end
+
+        flash[type] = translation
+      end
+
+      def flash_shared_key
+        'para.flash.shared'
+      end
+    end
+  end
+end

data/app/helpers/para/admin/component_groups_helper.rb

@@ -0,0 +1,4 @@
+module Para
+  module Admin::ComponentGroupsHelper
+  end
+end

data/app/helpers/para/admin/components_helper.rb

@@ -0,0 +1,4 @@
+module Para
+  module Admin::ComponentsHelper
+  end
+end

data/app/helpers/para/admin/resources_helper.rb

@@ -0,0 +1,27 @@
+module Para
+  module Admin
+    module ResourcesHelper
+      def resource_form_path(resource)
+        if resource.new_record?
+          resource_path(resource, :index)
+        else
+          resource_path(resource, :show)
+        end
+      end
+
+      def resource_path(resource, action =:index)
+        resource = resource.kind_of?(Class) ? resource.new : resource
+        route_key = resource.class.model_name.route_key
+
+        component_path = @component && @component.to_param
+        id = resource.id
+
+        if [:index, :show, :create, :update, :destroy].include?(action)
+          action = nil
+        end
+
+        ["", "admin", component_path, route_key, id, action].compact.join('/')
+      end
+    end
+  end
+end

data/app/helpers/para/application_helper.rb

@@ -0,0 +1,14 @@
+module Para
+  module ApplicationHelper
+    include Para::SearchHelper
+    include Para::ModelHelper
+    include Para::OrderingHelper
+    include Para::NavigationHelper
+    include Para::FormHelper
+    include Para::MarkupHelper
+    include Para::TagHelper
+    include Para::TreeHelper
+    include Para::FlashHelper
+    include Para::ExportsHelper
+  end
+end

data/app/helpers/para/exports_helper.rb

@@ -0,0 +1,11 @@
+module Para
+  module ExportsHelper
+    def export_name_for(model, export)
+      model_name = (
+        export[:model] && export[:model].constantize.model_name.human
+      ) || model.model_name.human
+
+      t('para.export.name', name: model_name)
+    end
+  end
+end

data/app/helpers/para/flash_helper.rb

@@ -0,0 +1,48 @@
+module Para
+  module FlashHelper
+    def display_admin_flash
+      # Render empty string if no flash
+      return "" if flash.empty?
+
+      # Make a div.alert for each message and join the whole
+      messages = flash.map do |type, message|
+        flash.delete(type)
+        type = homogenize_flash_type(type)
+
+        icon = content_tag(:div, class: "alert-icon-container pull-left") do
+          content_tag(:i, "", class: "fa #{ icon_class_for(type) }") +
+          ' '.html_safe
+        end
+
+        alert(type: type) do
+          icon + content_tag(:p, message.html_safe)
+        end
+      end
+
+      # Join the messages and make sure markup is correctly displayed
+      messages.join.html_safe
+    end
+
+    private
+
+    # Converts flash types to :success or :error to conform to what
+    # twitter bootstrap can handle
+    #
+    def homogenize_flash_type type
+      case type.to_sym
+      when :notice then :success
+      when :alert then :warning
+      when :error then :danger
+      else type
+      end
+    end
+
+    def icon_class_for type
+      case type
+      when :success then "fa-check"
+      when :error then "fa-warning"
+      else "fa-exclamation-triangle"
+      end
+    end
+  end
+end

data/app/helpers/para/form_helper.rb

@@ -0,0 +1,28 @@
+module Para
+  module FormHelper
+    def para_form_for(resource, options = {}, &block)
+      default_options = {
+        as: :resource,
+        wrapper: :horizontal_form,
+        html: { class: '' }
+      }
+
+      options = default_options.deep_merge(options)
+
+      options[:html][:class] = [
+        options[:html][:class].presence,
+        'form-horizontal form-group-separated'
+      ].compact.join(' ')
+
+      unless options.key?(:url)
+        options[:url] = @component.relation_path(resource)
+      end
+
+      if options.fetch(:fixed_actions, true)
+        default_options[:html][:class] << ' form-fixed-actions'
+      end
+
+      simple_form_for(resource, options, &block)
+    end
+  end
+end

data/app/helpers/para/markup_helper.rb

@@ -0,0 +1,15 @@
+module Para
+  module MarkupHelper
+    def alert(message, options = {}, &block)
+      Para::Markup::Alert.new(self).container(message, options, &block)
+    end
+
+    def resources_table(options = {}, &block)
+      Para::Markup::ResourcesTable.new(self).container(options, &block)
+    end
+
+    def panel(options = {}, &block)
+      Para::Markup::Panel.new(self).container(options, &block)
+    end
+  end
+end

data/app/helpers/para/model_helper.rb

@@ -0,0 +1,38 @@
+module Para
+  module ModelHelper
+    def attribute_field_mappings_for(component, relation)
+      model = relation_klass_for(component, relation)
+      model_field_mappings(model).fields
+    end
+
+    def model_field_mappings(model, attributes = nil)
+      store_key = ['model', 'mappings', model.name.underscore].join(':')
+
+      Para.store[store_key] ||= Para::AttributeFieldMappings.new(
+        model, whitelist_attributes: attributes
+      )
+    end
+
+    def relation_klass_for(component, relation)
+      component.class.reflect_on_association(relation).klass
+    end
+
+    def field_value_for(object, field_name, type = nil)
+      field = model_field_mappings(object.class).field_for(field_name, type)
+      value = field.value_for(object)
+      excerpt_value_for(value)
+    end
+
+    def excerpt_value_for(value)
+      return value unless value.kind_of?(String)
+
+      value = sanitize(value, tags: [])
+      
+      if (truncated = value[0..100]) != value
+        "#{ truncated }..."
+      else
+        value
+      end
+    end
+  end
+end

data/app/helpers/para/navigation_helper.rb

@@ -0,0 +1,8 @@
+module Para
+  module NavigationHelper
+    def component_section_active?(component_section)
+      (@component_section && @component_section == component_section) ||
+      (@component && @component.component_section_id == component_section.id)
+    end
+  end
+end

data/app/helpers/para/ordering_helper.rb

@@ -0,0 +1,20 @@
+module Para
+  module OrderingHelper
+    def reorder_anchor(options = {})
+      options[:class] ||= ''
+      options[:class] = [options[:class], 'order-anchor'].join(' ')
+
+      field = if (form = options.delete(:form))
+        form.hidden_field(:position, class: 'resource-position-field')
+      else
+        value = options.delete(:value) || 0
+        hidden_field_tag(:position, value, class: 'resource-position-field')
+      end
+
+      content_tag(:span, options) do
+        content_tag(:i, '', class: 'fa fa-bars') +
+        field
+      end
+    end
+  end
+end

data/app/helpers/para/search_helper.rb

@@ -0,0 +1,22 @@
+module Para
+  module SearchHelper
+    def fulltext_search_param_for(attributes)
+      "#{ searchable_attributes(attributes) }_cont"
+    end
+
+    def filtered?(attributes)
+      params[:q] && params[:q][fulltext_search_param_for(attributes)].present?
+    end
+
+    def searchable_attributes(attributes)
+      whitelist = attributes.select do |attribute|
+        [:string, :text].include?(attribute.type.to_sym) &&
+          !attribute.name.match(/password/)
+      end
+
+      whitelist.map do |attribute|
+        attribute.attribute_column_path.join('_')
+      end.join('_or_')
+    end
+  end
+end