tramway-admin 1.29.1.4 → 1.29.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b59a73d88e6909a7e355dd778bae9f36e5fd6f28b981f548aea85ab07c4ecedd
-  data.tar.gz: 1f0bfa52f18e76ae53b3859fa820e617073f7efcb4821ae429211809ebbef80d
+  metadata.gz: 684985c2ee2576e0240cdf2a35308044f98cbac2cf03d68ac45f6c986b7042ea
+  data.tar.gz: 3c009c10ec87984dea44de3193f37d2bb494f7ffa26e1ecb29e7f0e7fe50cad7
 SHA512:
-  metadata.gz: c003742f10c1c1fce366e32b444f60137f64b7fbc823da6d5b7e4887c012345b834ee9355eeccd7ef3f8d79548526b0d7188f3b013bd90437550d6472a3f9948
-  data.tar.gz: a7fd90211fb9c081484e1032d1af32fc3aa018d38f1f2122b3097d8105d210c96a9c27935fcbbb41d992afa363df0cd4c571a621f1401cc078b59161d8f26c96
+  metadata.gz: 6cc5247ac2bd3006c58aaf0e3eba492d96a2b95478fe199fe2561e62e25aba4b2aa3fd87a05afd06f93707da3a83616675e6f3f7d2f543a75bf5228335781110
+  data.tar.gz: f521d26062127bde2bb94fe5be738bac88d098cc79fd18b826f29080916e3b9c2baf05c7bcb30a3499e01d5f464fa763a3065bd0d99bd9d8e5137900e9f1eaa6

data/README.md

@@ -85,7 +85,16 @@ $> Tramway::User::User.create! email: 'your@email.com', password: '123456789', r
 
 *config/initializers/tramway.rb*
 ```ruby
-Tramway::Admin.navbar_structure YourModel, AnotherYourModel
+Tramway::Admin.navbar_structure(
+  YourModel, # this line will create first-level link in your navbar, which will send you to the YourModel management
+  {
+    my_dropdown: [ # this line contains dropdown link name
+      AnotherYourModel # this line will create 2nd-level link in your navbar, which will send you to the YourModel management,
+      :divider # this line adds bootstrap divider to the dropdown list
+    ]
+  },
+  project: :your_application_name
+)
 ```
 
 #### 9. Create decorator for models
@@ -167,7 +176,79 @@ You can set conditions for functions which are available for any role:
 
 Here docs about changing roles of `Tramway::User::User` model [Readme](https://github.com/ulmic/tramway-dev/tree/develop/tramway#if-you-want-to-edit-roles-to-the-tramwayuseruser-class)
 
+## Associations management
+
+### has_and_belongs_to_many
+
+We have models Game and Packs.
+
+*app/models/game.rb*
+```ruby
+class Game < Tramway::Core::ApplicationRecord
+  has_and_belongs_to_many :packs
+end
+```
+
+*app/models/pack.rb*
+```ruby
+class Pack < Tramway::Core::ApplicationRecord
+  has_and_belongs_to_many :games
+end
+```
+
+**You want to manage games in the Pack show admin page**
+
+#### 1. Add association to PackDecorator
+
+*app/decorators/pack_decorator.rb*
+```ruby
+class PackDecorator < Tramway::Core::ApplicationDecorator
+  decorate_association :games
+end
+```
 
+#### 2. Create `Admin::Packs::AddGameForm` and `Admin::Packs::RemoveGameForm`
+
+*app/forms/admin/packs/add_game_form.rb*
+```ruby
+class Admin::Packs::AddGameForm < Tramway::Core::ApplicationForm
+  properties :game_ids
+  association :games
+
+  def initialize(object)
+    super(object).tap do
+      form_properties games: :association
+    end
+  end
+
+  def submit(params)
+    params[:game_ids].each do |id|
+      model.games << Game.find(id) if id.present?
+    end
+    model.save!
+  end
+end
+```
+
+*app/forms/admin/packs/remove_game_form.rb*
+```ruby
+class Admin::Packs::RemoveGameForm < Tramway::Core::ApplicationForm
+  properties :id
+
+  def submit(params)
+    model.games -= [Game.find(params)] if id.present?
+    model.save!
+  end
+end
+
+```
+
+#### 3. Add this forms to initializer
+
+*config/initializers/tramway/admin/forms.rb*
+```ruby
+Tramway::Admin.forms = 'packs/add_game', 'packs/remove_game'
+```
 
 ## Date Picker locale
 
@@ -216,6 +297,7 @@ Start page of admin panel contains only `application.name` by default. To manage
 
 Example:
 
+*config/initializers/tramway/admin.rb*
 ```ruby
 ::Tramway::Admin.welcome_page_actions = lambda do
   @content = '<a href="http://it-way.pro">IT Way</a>'
@@ -237,7 +319,8 @@ Tramway::Admin.navbar_structure(
       AnotherYourModel # this line will create 2nd-level link in your navbar, which will send you to the YourModel management,
       :divider # this line adds bootstrap divider to the dropdown list
     ]
-  }
+  },
+  project: :your_application_name
 )
 ```
 

data/app/assets/stylesheets/tramway/admin/application.sass

@@ -26,3 +26,8 @@ td.actions
 .smart_button
   float: right
   margin-bottom: 0
+
+.scrollable
+  height: auto
+  max-height: 30em
+  overflow-x: hidden

data/app/helpers/tramway/admin/actions_helper.rb

@@ -23,7 +23,7 @@ module Tramway::Admin::ActionsHelper
 
   # delete_button is in smart-buttons gem
 
-  def edit_button(url:, button_options:, &block)
+  def edit_button(url:, button_options:)
     link_to(url, **button_options) { yield }
   end
 

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

@@ -38,7 +38,7 @@
                 = link_to '#', class: 'nav-link icon-in-navbar dropdown-toggle', id: :notifications_dropdown, role: :button, aria: { haspopup: true, expanded: false }, data: { toggle: :dropdown } do
                   %span.badge.badge-light
                     = @notifications_count
-                .dropdown-menu.dropdown-menu-right{ aria: { labelledby: :notifications_dropdown } }
+                .dropdown-menu.dropdown-menu-right.scrollable{ aria: { labelledby: :notifications_dropdown } }
                   - @notifications.each_with_index do |collection, index|
                     - collection[1].each do |item|
                       = link_to decorator_class(item.class).decorate(item).title, record_path(item, model: item.class), class: 'dropdown-item'

data/lib/tramway/admin/version.rb

@@ -2,6 +2,6 @@
 
 module Tramway
   module Admin
-    VERSION = '1.29.1.4'
+    VERSION = '1.29.1.5'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tramway-admin
 version: !ruby/object:Gem::Version
-  version: 1.29.1.4
+  version: 1.29.1.5
 platform: ruby
 authors:
 - Pavel Kalashnikov
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-14 00:00:00.000000000 Z
+date: 2020-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bootstrap-kaminari-views