tramway-admin 1.32.2.2 → 1.32.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54810b97b5d2f0fd856461953a58e2b36dcae76ad116f408ccff7bec841ba498
-  data.tar.gz: b802cfb92fdf6c8b6153eb9ed308ddb8284756f6754072369f309266a0d540eb
+  metadata.gz: f79d0aa9d04ed68aef471f0dc570d73e4d601270521be63081ae558a18a5f1be
+  data.tar.gz: 2d57de82ee1b753978a5ad2ac0534a0a93a67b2b41ff456606265ab12f3e5097
 SHA512:
-  metadata.gz: dac5f5fa0d8cb6b85c30ad9bf7c4c5b6779f93ddbdba2513ef8d351a7e316bfbec4140f87f356a8bf842b1c6a78182c92d335fe8dd0deff1bd8d46fdb18b6cc8
-  data.tar.gz: 963ad750519bba6a9863d365548d45ec008761363473071b9e6caf27e5f7a02ca88d02a8d943d28ed6aa657a223fad2e88c33027a05d3380dfff35706fdc7075
+  metadata.gz: 1c3a64f26bfcce263809d2a7b2a2d906b53966855866b90bb6500da180a09c577a59ea6a2d092d93f8a40a32b929989c5095f74884fcd5a542e87b7380d16f12
+  data.tar.gz: bfe8a88ee5c4c903f280a56bdeffdb2352e1953456f836aff20f66d11c52e15ce784e659472c201f4717ba0118458181fd1fa3573459dc5b9a00233c890a34e5

data/README.md

@@ -88,31 +88,46 @@ Tramway::Admin.navbar_structure(
   project: :your_application_name
 )
 ```
+#### 9. Create decorators and forms for all available_models.
+You can run generator that will create all necessary files
+```bash
+$ rails g tramway:admin:install
+```
+Or generate decorator and form for only one model
+```bash
+$ rails g tramway:admin:model Coworking
+```
+If you're using several user roles in your admin dashboard, then you can specify scope for the form(default scope is `admin`)
+```bash
+$ rails g tramway:admin:install --user-role=partner
+```
 
-#### 9. Create decorator for models
+Or you can create forms and decorators manually as it written below:
+
+#### 9a. Create decorator for models [manual option]
 
 *app/decorators/your_model_decorator.rb*
 ```ruby
 class YourModelDecorator < Tramway::Core::ApplicationDecorator
   decorate_associations :messages, :posts
-  
+
   class << self
     def collections
       [ :all, :scope1, :scope2 ]
     end
-    
+
     def list_attributes
       [ :begin_date, :end_date ]
     end
-    
+
     def show_attributes
       [ :begin_date, :end_date ]
     end
-    
+
     def show_associations
       [ :messages ]
     end
-    
+
     def list_filters
       {
         filter_name: {
@@ -131,7 +146,7 @@ class YourModelDecorator < Tramway::Core::ApplicationDecorator
       }
     end
   end
-  
+
   delegate_attributes :title
 end
 ```
@@ -171,15 +186,7 @@ en:
             end_date Your end date filter
 ```
 
-#### 10. Add inheritance to YourModel
-
-*app/models/your_model.rb*
-```ruby
-class YourModel < Tramway::Core::ApplicationRecord
-end
-```
-
-#### 11. Create `Admin::YourModelForm`
+#### 9b. Create `Admin::YourModelForm` [manual option]
 
 *app/forms/admin/your_model_form.rb
 ```ruby
@@ -204,7 +211,15 @@ class Admin::YourModelForm < Tramway::Core::ApplicationForm
 end
 ```
 
-### 12. You can add search to your index page
+#### 10. Add inheritance to YourModel
+
+*app/models/your_model.rb*
+```ruby
+class YourModel < Tramway::Core::ApplicationRecord
+end
+```
+
+### 11. You can add search to your index page
 
 Tramway use gem [PgSearch](https://github.com/Casecommons/pg_search`) as search engine
 

data/app/inputs/multiple_file_input.rb

@@ -0,0 +1,5 @@
+class MultipleFileInput < SimpleForm::Inputs::FileInput
+  def input(wrapper_options)
+    super(wrapper_options.merge! multiple: true)
+  end
+end

data/app/views/layouts/tramway/admin/shared/_navbar.html.haml

@@ -11,8 +11,8 @@
         %ul.navbar-nav
           - ::Tramway::Admin.navbar_items_for(@application_engine || @application.name, role: current_admin.role)&.each do |item|
             - case item.keys.first
-            - when Class
-              - model = item.keys.first
+            - when Class, String
+              - model = item.keys.first.is_a?(String) ? item.keys.first.constantize : item.keys.first
               - case item.values.first
               - when :singleton
                 = model_menu_item model: model, route: ::Tramway::Admin::Engine.routes.url_helpers.singleton_path(model: model)
@@ -28,7 +28,7 @@
                     - if sub_item.values.first == :singleton
                       = dropdown_model_item model: model, route: ::Tramway::Admin::Engine.routes.url_helpers.singleton_path(model: model)
                     - if sub_item.values.first == :record
-                      = dropdown_model_item model: model, route: ::Tramway::Admin::Engine.routes.url_helpers.records_path(model: model, scope: decorator_class(model).collections.first), pluralize: plural(model.model_name).capitalize
+                      = dropdown_model_item model: model, route: ::Tramway::Admin::Engine.routes.url_helpers.records_path(model: model, scope: decorator_class(model).collections.first), pluralize: plural(model.constantize.model_name).capitalize
 
       %ul.nav.navbar-nav.ml-auto
         - if current_admin

data/lib/tramway/admin.rb

@@ -10,6 +10,7 @@ require 'tramway/admin/notifications'
 require 'tramway/admin/welcome_page_actions'
 require 'tramway/admin/navbar'
 require 'tramway/error'
+require 'tramway/admin/generators/install_generator'
 
 module Tramway
   Auth.layout_path = 'tramway/admin/application'

data/lib/tramway/admin/generators/install_generator.rb

@@ -0,0 +1,20 @@
+require 'rails/generators'
+require 'tramway/admin/generators/model_generator'
+
+module Tramway
+  module Admin
+    module Generators
+      class InstallGenerator < ::Rails::Generators::Base
+        source_root File.expand_path('templates', __dir__)
+        class_option :user_role, type: :string, default: 'admin'
+
+        def run_decorator_generators
+          project = Tramway::Core.application.name
+          ::Tramway::Admin.available_models_for(project).map do |model|
+            generate 'tramway:admin:model', model.to_s, "--user-role=#{options[:user_role]}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/tramway/admin/generators/model_generator.rb

@@ -0,0 +1,109 @@
+require 'rails/generators/named_base'
+
+module Tramway
+  module Admin
+    module Generators
+      class ModelGenerator < ::Rails::Generators::NamedBase
+        source_root File.expand_path('templates', __dir__)
+        class_option :user_role, type: :string, default: 'admin'
+
+        COLLECTION_ATTRIBUTE_LIMIT = 4 # limiting columns in #index table
+        ATTRIBUTE_TYPE_MAPPING = {
+          date: :date_picker,
+          datetime: :date_picker,
+          time: :date_picker,
+          text: :text,
+          string: :string,
+          uuid: :string,
+          float: :float,
+          integer: :integer,
+          boolean: :boolean,
+        }
+        DEFAULT_FIELD_TYPE = :string
+        READ_ONLY_ATTRIBUTES = %w[id uuid created_at updated_at]
+
+        def run_decorator_generator
+          template(
+            'decorator.rb.erb',
+            Rails.root.join("app/decorators/#{file_name}_decorator.rb"),
+          )
+        end
+
+        def run_forms_generator
+          template(
+            'form.rb.erb',
+            Rails.root.join("app/forms/#{user_role}/#{file_name}_form.rb"),
+          )
+        end
+
+        private
+
+        def user_role
+          options[:user_role]
+        end
+
+        def attributes
+          # TODO: this for model associations, but they probably should be handled differently
+          # klass.reflections.keys +
+
+          klass.columns.map(&:name) -
+            redundant_attributes
+        end
+
+        def form_attributes
+          attributes - READ_ONLY_ATTRIBUTES
+        end
+
+        def form_type(attribute)
+          type = column_type_for_attribute(attribute.to_s)
+
+          if type
+            ATTRIBUTE_TYPE_MAPPING.fetch(type, DEFAULT_FIELD_TYPE)
+          # else
+          #   association_type(attribute)
+          end
+        end
+
+        def redundant_attributes
+          klass.reflections.keys.flat_map do |relationship|
+            redundant_attributes_for(relationship)
+          end.compact
+        end
+
+        def redundant_attributes_for(relationship)
+          case association_type(relationship)
+          when :polymorphic
+            [relationship + '_id', relationship + '_type']
+          when :belongs_to
+            relationship + '_id'
+          end
+        end
+
+        def association_type(attribute)
+          relationship = klass.reflections[attribute.to_s]
+          if relationship.has_one?
+            :has_one
+          elsif relationship.collection?
+            :has_many
+          elsif relationship.polymorphic?
+            :polymorphic
+          else
+            :belongs_to
+          end
+        end
+
+        def column_type_for_attribute(attr)
+          column_types(attr)
+        end
+
+        def column_types(attr)
+          klass.columns.find { |column| column.name == attr }.try(:type)
+        end
+
+        def klass
+          @klass ||= Object.const_get(class_name)
+        end
+      end
+    end
+  end
+end

data/lib/tramway/admin/generators/templates/decorator.rb.erb

@@ -0,0 +1,52 @@
+class <%= class_name %>Decorator < Tramway::Core::ApplicationDecorator
+  # Associations you want to show in admin dashboard
+  # decorate_associations :messages, :posts
+
+  class << self
+    def collections
+      # [ :all, :scope1, :scope2 ]
+      [ :all ]
+    end
+
+    def list_attributes
+      [
+<% attributes.first(COLLECTION_ATTRIBUTE_LIMIT).each do |attr| -%>
+        :<%= attr %>,
+<% end -%>
+      ]
+    end
+
+    def show_attributes
+      [
+<% attributes.each do |attr| -%>
+        :<%= attr %>,
+<% end -%>
+      ]
+    end
+
+    def show_associations
+      # Associations you want to show in admin dashboard
+      # [ :messages ]
+    end
+
+    def list_filters
+      # {
+      #   filter_name: {
+      #     type: :select,
+      #     select_collection: filter_collection,
+      #     query: lambda do |list, value|
+      #       list.where some_attribute: value
+      #     end
+      #   },
+      #   date_filter_name: {
+      #     type: :dates,
+      #     query: lambda do |list, begin_date, end_date|
+      #       list.where 'created_at > ? AND created_at < ?', begin_date, end_date
+      #     end
+      #   }
+      # }
+    end
+  end
+
+  # delegate_attributes :title
+end

data/lib/tramway/admin/generators/templates/form.rb.erb

@@ -0,0 +1,22 @@
+class <%= user_role.capitalize %>::<%= class_name %>Form < Tramway::Core::ApplicationForm
+  properties <%= form_attributes.map{ |a| ":#{a}" }.join(', ') %>
+
+  def initialize(object)
+    super(object).tap do
+      # Here is the mapping from model attributes to simple_form inputs.
+      # form_properties title: :string,
+      #   logo: :file,
+      #   description: :ckeditor,
+      #   games: :association,
+      #   date: :date_picker,
+      #   text: :text,
+      #   birth_date: {
+      #     type: :default,
+      #     input_options: {
+      #       hint: 'It should be more than 18'
+      #     }
+      #   }
+      form_properties <%= form_attributes.map{ |attr| "#{attr}: :#{form_type(attr)}"}.join(",\n        ") %>
+    end
+  end
+end

data/lib/tramway/admin/navbar.rb

@@ -9,7 +9,7 @@ module Tramway::Admin::Navbar
   def navbar_items_for(project, role:)
     project = project.underscore.to_sym unless project.is_a? Symbol
     @navbar_structure[project]&.map do |item|
-      if item.is_a? Class
+      if item.is_a?(Class) || item.is_a?(String)
         should_be_in_navbar_as item, project, role
       elsif item.is_a? Hash
         sub_items = item.values.first.map do |sub_item|
@@ -23,10 +23,10 @@ module Tramway::Admin::Navbar
   private
 
   def should_be_in_navbar_as(item, project, role)
-    if singleton_models_for(project, role: role).include?(item)
-      { item => :singleton }
-    elsif available_models_for(project, role: role).include?(item)
-      { item => :record }
+    if singleton_models_for(project, role: role).map(&:to_s).include?(item.to_s)
+      { item.to_s => :singleton }
+    elsif available_models_for(project, role: role).map(&:to_s).include?(item.to_s)
+      { item.to_s => :record }
     elsif item.is_a? Symbol
       :divider
     end

data/lib/tramway/admin/records_models.rb

@@ -6,10 +6,10 @@ module Tramway::Admin::RecordsModels
     @available_models[project] ||= {}
     @available_models[project][role] ||= {}
     models.each do |model|
-      if model.class == Class
-        @available_models[project][role].merge! model => %i[index show update create destroy]
+      if model.class == Class || model.class == String
+        @available_models[project][role].merge! model.to_s => %i[index show update create destroy]
       elsif model.class == Hash
-        @available_models[project][role].merge! model
+        @available_models[project][role].merge! model.to_s
       end
     end
     @available_models = @available_models.with_indifferent_access
@@ -32,7 +32,10 @@ module Tramway::Admin::RecordsModels
         end
       end.flatten.compact
     end
-    models
+    # TODO: somehow cache results?
+    models.map do |model|
+      model.class == String ? model.constantize : model
+    end
   end
 
   def available_models(role:)

data/lib/tramway/admin/singleton_models.rb

@@ -7,9 +7,9 @@ module Tramway::Admin::SingletonModels
     @singleton_models[project][role] ||= {}
     models.each do |model|
       if model.class == Class
-        @singleton_models[project][role].merge! model => %i[index show update create destroy]
+        @singleton_models[project][role].merge! model.to_s => %i[index show update create destroy]
       elsif model.class == Hash
-        @singleton_models[project][role].merge! model
+        @singleton_models[project][role].merge! model.to_s
       end
     end
     @singleton_models = @singleton_models.with_indifferent_access

data/lib/tramway/admin/version.rb

@@ -2,6 +2,6 @@
 
 module Tramway
   module Admin
-    VERSION = '1.32.2.2'
+    VERSION = '1.32.2.4'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tramway-admin
 version: !ruby/object:Gem::Version
-  version: 1.32.2.2
+  version: 1.32.2.4
 platform: ruby
 authors:
 - Pavel Kalashnikov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-12-09 00:00:00.000000000 Z
+date: 2020-12-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tramway-core
@@ -252,6 +252,7 @@ files:
 - app/helpers/tramway/admin/records_helper.rb
 - app/helpers/tramway/admin/russian_cases_helper.rb
 - app/helpers/tramway/admin/singleton_helper.rb
+- app/inputs/multiple_file_input.rb
 - app/jobs/tramway/admin/application_job.rb
 - app/mailers/tramway/admin/application_mailer.rb
 - app/models/tramway/user/user.rb
@@ -290,6 +291,10 @@ files:
 - lib/tramway/admin/additional_buttons.rb
 - lib/tramway/admin/engine.rb
 - lib/tramway/admin/forms.rb
+- lib/tramway/admin/generators/install_generator.rb
+- lib/tramway/admin/generators/model_generator.rb
+- lib/tramway/admin/generators/templates/decorator.rb.erb
+- lib/tramway/admin/generators/templates/form.rb.erb
 - lib/tramway/admin/navbar.rb
 - lib/tramway/admin/notifications.rb
 - lib/tramway/admin/record_routes_helper.rb