archangel 0.3.0 → 0.4.0

data/app/controllers/concerns/archangel/controllers/authorizable_concern.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Archangel
+  ##
+  # Controller concerns
+  #
+  module Controllers
+    ##
+    # Controller authorize concern
+    #
+    module AuthorizableConcern
+      extend ActiveSupport::Concern
+
+      included do
+        after_action :verify_authorized
+      end
+    end
+  end
+end

data/app/controllers/concerns/archangel/controllers/metatagable_concern.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Archangel
+  ##
+  # Controller concerns
+  #
+  module Controllers
+    ##
+    # Controller meta tag concern
+    #
+    module MetatagableConcern
+      extend ActiveSupport::Concern
+
+      included do
+        before_action :apply_default_meta_tags, if: -> { request.get? },
+                                                unless: -> { request.xhr? }
+      end
+
+      ##
+      # Set meta tags
+      #
+      # @param meta_tags [Hash] list of meta tags
+      #
+      def assign_meta_tags(meta_tags = {})
+        meta = meta_tags.reject { |_name, value| value.blank? }
+
+        set_meta_tags(meta)
+      end
+
+      protected
+
+      def apply_default_meta_tags
+        assign_meta_tags(default_meta_tags)
+      end
+
+      def default_meta_tags
+        {
+          reverse: true,
+          site: current_site.name,
+          canonical: request.url
+        }
+      end
+    end
+  end
+end

data/app/controllers/concerns/archangel/controllers/paginatable_concern.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Archangel
+  ##
+  # Controller concerns
+  #
+  module Controllers
+    ##
+    # Controller pagination concern
+    #
+    module PaginatableConcern
+      extend ActiveSupport::Concern
+
+      included do
+        helper_method :page_num, :per_page
+      end
+
+      ##
+      # Record limt count
+      #
+      # @return [Integer] the record count limit
+      #
+      def per_page
+        params.fetch(:per, per_page_default).to_i
+      end
+
+      ##
+      # Current page number
+      #
+      # @return [Integer] the page number
+      #
+      def page_num
+        params.fetch(Kaminari.config.param_name, 1).to_i
+      end
+
+      protected
+
+      def per_page_default
+        Kaminari.config.default_per_page
+      end
+    end
+  end
+end

data/app/controllers/concerns/archangel/controllers/resourceful_concern.rb

@@ -8,6 +8,41 @@ module Archangel
     ##
     # Resourceful concern
     #
+    # Usage
+    #   module Archangel
+    #     module Backend
+    #       class ExamplesController < BackendController
+    #         include Archangel::Controllers::ResourcefulConcern
+    #
+    #         protected
+    #
+    #         def permitted_attributes
+    #           %w[bar bat baz]
+    #         end
+    #
+    #         def resources_content
+    #           @examples = current_site.examples.all
+    #
+    #           authorize @examples
+    #         end
+    #
+    #         def resource_content
+    #           resource_id = params.fetch(:id)
+    #
+    #           @example = current_site.examples.find_by!(id: resource_id)
+    #
+    #           authorize @example
+    #         end
+    #
+    #         def resource_new_content
+    #           @example = current_site.examples.new(resource_new_params)
+    #
+    #           authorize @example
+    #         end
+    #       end
+    #     end
+    #   end
+    #
     module ResourcefulConcern
       extend ActiveSupport::Concern
 
@@ -33,7 +68,7 @@ module Archangel
       #   ]
       #
       def index
-        resources = resources_content
+        resources = resources_content || []
 
         respond_with resources
       end
@@ -60,7 +95,7 @@ module Archangel
       #   }
       #
       def show
-        resource = resource_content
+        resource = resource_content || {}
 
         respond_with resource
       end
@@ -84,7 +119,7 @@ module Archangel
       #   }
       #
       def new
-        resource = resource_new_content
+        resource = resource_new_content || nil
 
         respond_with resource
       end
@@ -99,7 +134,7 @@ module Archangel
       #   POST /resources
       #   POST /resources.json
       #
-      # Paramaters
+      # Parameters
       #   {
       #     "resource": {
       #       "id": 123,
@@ -108,9 +143,9 @@ module Archangel
       #   }
       #
       def create
-        resource = resource_new_content
+        resource = resource_new_content || {}
 
-        resource.save unless resource.blank?
+        resource.save if resource.present?
 
         respond_with resource, location: -> { location_after_create }
       end
@@ -137,7 +172,7 @@ module Archangel
       #   }
       #
       def edit
-        resource = resource_content
+        resource = resource_content || {}
 
         respond_with resource
       end
@@ -157,7 +192,7 @@ module Archangel
       #   PUT   /resources/:id
       #   PUT   /resources/:id.json
       #
-      # Paramaters
+      # Parameters
       #   {
       #     "resource": {
       #       "id": 123,
@@ -166,9 +201,9 @@ module Archangel
       #   }
       #
       def update
-        resource = resource_content
+        resource = resource_content || {}
 
-        resource.update(resource_params)
+        resource.update(resource_params) if resource.present?
 
         respond_with resource, location: -> { location_after_update }
       end
@@ -187,9 +222,9 @@ module Archangel
       #   DELETE /resources/:id.json
       #
       def destroy
-        resource = resource_content
+        resource = resource_content || nil
 
-        resource.destroy unless resource.blank?
+        resource.destroy if resource.present?
 
         respond_with resource, location: -> { location_after_destroy }
       end
@@ -197,19 +232,11 @@ module Archangel
       protected
 
       def permitted_attributes
-        %w[]
+        permitted_resource_attributes || %w[]
       end
 
-      def resources_content
-        []
-      end
-
-      def resource_content
-        {}
-      end
-
-      def resource_new_content
-        action_name.to_sym == :create ? {} : nil
+      def permitted_new_attributes
+        permitted_attributes
       end
 
       def resource_controller
@@ -221,15 +248,23 @@ module Archangel
       end
 
       def resource_namespace
-        nil
+        controller_path.split("/").second.to_sym
       end
 
       def resource_params
-        params.require(resource_scope).permit(permitted_attributes)
+        permitted = permitted_attributes
+
+        params.require(resource_scope).permit(permitted)
+      end
+
+      def resource_params_new
+        permitted = permitted_new_attributes
+
+        params.require(resource_scope).permit(permitted)
       end
 
       def resource_new_params
-        action_name.to_sym == :create ? resource_params : nil
+        action_name.to_sym == :create ? resource_params_new : nil
       end
 
       def location_after_create
@@ -248,6 +283,8 @@ module Archangel
         resources_path
       end
 
+      private
+
       def resources_path(options = {})
         location_path = [resource_namespace, resource_controller].compact
 

data/app/controllers/concerns/archangel/controllers/skip_authorizable_concern.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Archangel
+  ##
+  # Controller concerns
+  #
+  module Controllers
+    ##
+    # Controller skip authorize concern
+    #
+    module SkipAuthorizableConcern
+      extend ActiveSupport::Concern
+
+      included do
+        after_action :skip_authorization
+      end
+    end
+  end
+end

data/app/controllers/concerns/archangel/controllers/themable_concern.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Archangel
+  ##
+  # Controller concerns
+  #
+  module Controllers
+    ##
+    # Controller theme concern
+    #
+    module ThemableConcern
+      extend ActiveSupport::Concern
+
+      ##
+      # ThemableConcern class methods
+      #
+      module ClassMethods
+        ##
+        # Converts the object into textual markup given a specific format.
+        #
+        # @param theme [String,Symbol,Proc] the theme
+        # @param options [Hash] the theme options
+        # @return [Object] the theme object
+        #
+        def theme(theme, options = {})
+          @_theme = theme
+          @_theme_options = options
+
+          Archangel::Theme::ThemableController.apply_theme(self, theme, options)
+        end
+      end
+    end
+  end
+end

data/app/controllers/concerns/archangel/helpers/actionable_concern.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Archangel
+  ##
+  # Helper concerns
+  #
+  module Helpers
+    ##
+    # Helper action concern
+    #
+    module ActionableConcern
+      extend ActiveSupport::Concern
+
+      included do
+        helper_method :action,
+                      :collection_action?,
+                      :edit_action?,
+                      :index_action?,
+                      :member_action?,
+                      :new_action?,
+                      :show_action?
+      end
+
+      %w[edit index new show].each do |rest_action|
+        define_method("#{rest_action}_action?".to_sym) do
+          action?(rest_action)
+        end
+      end
+
+      ##
+      # Controller action name as a symbol
+      #
+      # @return [Symbol] the action name
+      #
+      def action
+        action_name.to_sym
+      end
+
+      ##
+      # Test if action is a collection action
+      #
+      # Actions include [:index]
+      #
+      # @return [Boolean] if action is a collection action
+      #
+      def collection_action?
+        collection_actions.include?(action)
+      end
+
+      ##
+      # Test if action is a member action
+      #
+      # Actions include [:show, :edit, :update]
+      #
+      # @return [Boolean] if action is a member action
+      #
+      def member_action?
+        member_actions.include?(action)
+      end
+
+      protected
+
+      def action?(action_method)
+        action == action_method.to_sym
+      end
+
+      def collection_actions
+        %i[index]
+      end
+
+      def member_actions
+        %i[edit show update]
+      end
+    end
+  end
+end

data/app/helpers/archangel/application_helper.rb

@@ -5,7 +5,28 @@ module Archangel
   # Application helpers
   #
   module ApplicationHelper
-    include FontAwesome::Rails::IconHelper
+    ##
+    # Frontend resource permalink.
+    #
+    # Same as `frontend_page_path` except it prints out nested resources in a
+    # nice way.
+    #
+    # Example
+    #   <%= frontend_resource_path('amazing/grace') %> #=> /amazing/grace
+    #   <%= frontend_resource_path(@page) %> #=> /amazing/grace
+    #
+    # @return [String] frontend resource permalink
+    #
+    def frontend_resource_path(resource)
+      permalink_path = proc do |permalink|
+        archangel.frontend_page_path(permalink).sub("%2F", "/")
+      end
+
+      return permalink_path.call(resource) unless resource.class == Page
+      return archangel.frontend_root_path if resource.homepage?
+
+      permalink_path.call(resource.permalink)
+    end
 
     ##
     # Site locale. Default `en`
@@ -30,5 +51,18 @@ module Archangel
     def text_direction
       Archangel.t("language.#{locale}.direction", default: "ltr")
     end
+
+    ##
+    # Check if active backend menu for a controller
+    #
+    # Example
+    #   <%= active_backend_menu_for("users") %> #=> true
+    #   <%= active_backend_menu_for("pages") %> #=> false
+    #
+    # @return [Boolean] if current controller
+    #
+    def active_backend_menu_for(ctrlr)
+      params.fetch(:controller) == "archangel/backend/#{ctrlr}"
+    end
   end
 end