lato_core 2.2.0 → 2.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2bba9533c6d8ca36fccc5d5c43cf5253221c58b2
-  data.tar.gz: b778ebd736a83e911c7f44f5fb4737b71a523533
+SHA256:
+  metadata.gz: 10d0d90847799a6bf6da6765a2b6bf85994cd47afb79dd60fc12a8cad41db9c4
+  data.tar.gz: 03ed9310de285a4245c1b1a110d8f95484dc5763cf16e241b0d93cd97ebe9875
 SHA512:
-  metadata.gz: 54971b4d53cbfe95c08fdd91e26406957880008b831d162f445c4950464b0ba3da2e16697e35833b024d2848259eff8fe17982a8643a9e018346173288f3d3b1
-  data.tar.gz: 0c7ea56aff524d2ec57c07e8075b8d2d762563e0c51cbbbd0c2252bde4c6b0a185693823864de9047bc53c637960ef854f7f44cc0b856242c3b958fe3654c44f
+  metadata.gz: 89af3d72a186ade8517edf0c88a7d11ea579dcd14eb5c5e37e830ab5de6f9779046b376c29f1afb9d6529dbf3f4fb249e5627069e2322c88555324b915d5ac32
+  data.tar.gz: 1742ef179d9b7d4d472e1ad2cb49305d5ad342bb2957e3b1eb5746ec42340d77e8fa6f844d6cf1dc19ed41309b9ac6571e51ed8847ae3ad9a1b2f7e2a1185d1e

data/README.md

@@ -1,17 +1,19 @@
 # Lato Core
 
+[![Gem Version](https://badge.fury.io/rb/lato_core.svg)](https://badge.fury.io/rb/lato_core)
+
 Lato is a Rails engine used to develop modular admin panels. This is the module used to initialize the admin panel.
 The complete documentation is inside the application panel, so you must [install](#installation) it before.
 
-You can always try a demo here: https://lato-server.herokuapp.com
+You can always try a demo here: https://lato-gem.herokuapp.com
 
-![Alt text](lib/screen.png "Title")
+![Lato dashboard screenshot](lib/screen.png)
 
 ## Ecosystem
 
 - [Lato core](https://github.com/ideonetwork/lato-core): The core module used to initialize the panel.
 - [Lato media](https://github.com/ideonetwork/lato-media): A module used to manage attachments and media files.
-- [Lato blog](https://github.com/ideonetwork/lato-blog): A module used to manage a blog.
+- [Lato blog](https://github.com/ideonetwork/lato-blog): A module to manage blog contents.
 
 ## Installation
 
@@ -39,4 +41,42 @@ Exec migrations
 bundle exec rake db:migrate
 ```
 
-Now you can start the server and go to the relative url */lato/core*
+Now you can start the server and go to the relative url */lato/core*
+
+## Command line interface
+
+Lato has some commands that can be used to generate files and configurations.
+
+Inside the Lato admin panel there is a specific list of all command line commands that can be used to work with a lato project.
+
+### Configuration
+
+```console
+rails lato:load_configs
+```
+
+This command should create a list of **lato_*.yml** files inside **config/lato** containing settings and configuration of every module.
+
+### Languages
+
+```console
+rails lato:load_languages
+```
+
+This command should create a list of **lato_*_lang.yml** files inside **config/lato** containing strings that can be replaced for every lato module.
+
+### Generators
+
+#### Initializer
+
+```console
+rails generate lato_core:initializer
+```
+
+This command should create some files that helps you to start to develop with lato.
+
+#### Scaffold
+
+```console
+rails generate lato_core:scaffold ModelName
+```

data/app/assets/stylesheets/lato_core/base/_table.scss

@@ -6,6 +6,30 @@
 
   thead {
     border-bottom: solid 1px darken($color_white, 3);
+
+    .attr-active {
+      color: $color_active;
+    }
+
+    .attr-sort-ASC {
+      position: relative;
+
+      &:after {
+        content: '\2193';
+        position: absolute;
+        right: -1em;
+      }
+    }
+
+    .attr-sort-DESC {
+      position: relative;
+      
+      &:after {
+        content: '\2191';
+        position: absolute;
+        right: -1em;
+      }
+    }
   }
 
   tbody:before {

data/app/assets/stylesheets/lato_core/cells/elements/_button.scss

@@ -27,6 +27,17 @@
   }
 }
 
+.elements-button--block {
+  display: block;
+  width: 100%;
+
+  > .elements-button__element {
+    display: block;
+    width: 100%;
+    text-align: left;
+  }
+}
+
 .elements-button__element--info {
   background-color: $button_info_background;
   color: $button_info_color_text;

data/app/assets/stylesheets/lato_core/cells/widgets/_index.scss

@@ -4,9 +4,25 @@
     padding-bottom: 30px;
     clear: both;
   }
+
+}
+
+.widgets-index--actions-start {
+  .elements-table__table thead th:first-child {
+    text-align: center;
+  }
+
+  .elements-table__row td:first-child {
+    text-align: center;
+    min-width: 250px;
+
+    .elements-button__element {
+      font-size: 0.8em;
+    }
+  }
 }
 
-.widgets-index--actions {
+.widgets-index--actions-end {
   .elements-table__table thead th:last-child {
     text-align: center;
   }

data/app/cells/lato_core/elements/button/cell.rb

@@ -12,6 +12,7 @@ module LatoCore
       icon: nil,
       icon_align: 'left',
       method: 'get',
+      block: false,
       remote: false,
       confirmation: {
         message: nil,
@@ -52,6 +53,8 @@ module LatoCore
                               @args[:confirmation][:negative_response])
         @icon_left = (@args[:icon_align] === 'left')
         @icon_right = (@args[:icon_align] === 'right')
+
+        @block_class = @args[:block] ? ' elements-button--block ' : ' '
       end
 
   end

data/app/cells/lato_core/elements/button/views/button.html.erb

@@ -1,7 +1,11 @@
-<div class="elements-button">
+<div class="elements-button <%= @block_class %>">
 
   <button
-    class="button elements-button__element elements-button__element--<%= @args[:style] %> elements-button__button"
+    class="
+    button
+    elements-button__element
+    elements-button__element--<%= @args[:style] %>
+    elements-button__button"
     title="<%= @args[:label] %>"
     id="<%= @args[:id] %>"
     <% if @show_submit %>

data/app/cells/lato_core/elements/button/views/link.html.erb

@@ -1,7 +1,10 @@
-<div class="elements-button">
+<div class="elements-button <%= @block_class %>">
 
   <a
-    class="button elements-button__element elements-button__element--<%= @args[:style] %> elements-button__link"
+    class="
+    button elements-button__element
+    elements-button__element--<%= @args[:style] %>
+    elements-button__link"
     title="<%= @args[:label] %>"
     id="<%= @args[:id] %>"
     <% if !@show_confirmation %>

data/app/cells/lato_core/widgets/index/cell.rb

@@ -24,7 +24,8 @@ module LatoCore
       },
       table_body: {
         hover: false
-      }
+      },
+      actions_on_start: false
     }
 
     def initialize(args = {})
@@ -48,7 +49,8 @@ module LatoCore
         @total = @args[:records].is_a?(Hash) ? @args[:records][:total] : @args[:records].length
         # conditions for show
         @show_row_actions = @args[:index_url] && @args[:actions] && (@args[:actions][:show] || @args[:actions][:edit] || @args[:actions][:delete])
-        @show_row_actions_class = @show_row_actions ? 'widgets-index--actions' : ''
+        @show_row_actions_class = @args[:actions_on_start] && @show_row_actions ? 'widgets-index--actions-start' : ''
+        @show_row_actions_class = !@args[:actions_on_start] && @show_row_actions ? 'widgets-index--actions-end' : @show_row_actions_class
         @show_search = @args[:index_url] && @args[:search]
         @show_pagiantion = @args[:index_url] && @args[:pagination]
         @show_new_action = @args[:index_url] && @args[:actions] && @args[:actions][:new]
@@ -84,13 +86,41 @@ module LatoCore
 
         if @args[:head] && @args[:head].length > 0
           # manage case with custom head
-          labels = @args[:head]
-          labels.push(LANGUAGES[:lato_core][:mixed][:actions]) if @show_row_actions
-        elsif @records && @records.length > 0
+          labels = []
+          if @args[:actions_on_start] && @show_row_actions
+            labels.push(LANGUAGES[:lato_core][:mixed][:actions])
+          end
+          @args[:head].each do |head|
+            if head.is_a?(Hash)
+              sort_value = @args[:records].is_a?(Hash) ? @args[:records][:sort] : ''
+              sort_dir_value = @args[:records].is_a?(Hash) ? @args[:records][:sort_dir] : 'ASC'
+              active_class = sort_value == head[:sort] ? "attr-active attr-sort-#{sort_dir_value}" : ''
+              active_sort = sort_value == head[:sort] ? (sort_dir_value == 'ASC' ? 'DESC' : 'ASC') : sort_dir_value
+              search_value = @args[:records].is_a?(Hash) ? @args[:records][:search] : ''
+
+              url = core__add_param_to_url(@args[:index_url], 'widget_index[search]', search_value)
+              url = core__add_param_to_url(url, 'widget_index[sort]', head[:sort])
+              url = core__add_param_to_url(url, 'widget_index[sort_dir]', active_sort)
+              string = "<a href='#{url}' class='#{active_class}'>#{head[:label]}</a>"
+              labels.push(string)
+            else
+              labels.push(head)
+            end
+          end
+          if !@args[:actions_on_start] && @show_row_actions
+            labels.push(LANGUAGES[:lato_core][:mixed][:actions])
+          end
+        elsif @records&.length > 0
           # manage case without custom head
-          labels = @records.first.attributes.keys.map {|s| s.gsub('_', ' ')}
+          labels = []
+          if @args[:actions_on_start] && @show_row_actions
+            labels.push(LANGUAGES[:lato_core][:mixed][:actions])
+          end
+          labels = labels + @records.first.attributes.keys.map {|s| s.gsub('_', ' ')}
           labels = labels.map(&:capitalize)
-          labels.push(LANGUAGES[:lato_core][:mixed][:actions]) if @show_row_actions
+          if !@args[:actions_on_start] && @show_row_actions
+            labels.push(LANGUAGES[:lato_core][:mixed][:actions])
+          end
         end
 
         return LatoCore::Elements::Table::Head::Cell.new(labels: labels)
@@ -124,12 +154,16 @@ module LatoCore
 
         @records.each do |record|
           labels = []
+          # add actions to row columns
+          if @args[:actions_on_start] && @show_row_actions
+            labels.push(generate_actions_bottongroup_for_record(record))
+          end
           # add function result to row columns
           columns_functions.each do |column_function|
             labels.push(record.send(column_function))
           end
           # add actions to row columns
-          if @show_row_actions
+          if !@args[:actions_on_start] && @show_row_actions
             labels.push(generate_actions_bottongroup_for_record(record))
           end
           # puts rows on table rows
@@ -194,7 +228,10 @@ module LatoCore
 
       # This function generate and return the search input.
       def generate_search_input
-        search_placeholder = @args[:records].is_a?(Hash) ? @args[:records][:search_key].humanize : ''
+        search_placeholder = ''
+        if @args[:records].is_a?(Hash)
+          search_placeholder = @args[:records][:search_key].is_a?(Array) ? @args[:records][:search_key].to_sentence : @args[:records][:search_key].humanize
+        end
         search_value = @args[:records].is_a?(Hash) ? @args[:records][:search] : ''
         return LatoCore::Inputs::Text::Cell.new(name: 'widget_index[search]', value: search_value, placeholder: search_placeholder)
       end
@@ -216,9 +253,14 @@ module LatoCore
         total_records_per_page = @args[:records].is_a?(Hash) ? @args[:records][:per_page] : @args[:records].length
         total_pages = (total_records.to_f / total_records_per_page.to_f).ceil
         current_page = @args[:records].is_a?(Hash) ? @args[:records][:pagination] : 1
+
         search_value = @args[:records].is_a?(Hash) ? @args[:records][:search] : ''
+        sort_value = @args[:records].is_a?(Hash) ? @args[:records][:sort] : ''
+        sort_dir_value = @args[:records].is_a?(Hash) ? @args[:records][:sort_dir] : ''
 
         url = core__add_param_to_url(@args[:index_url], 'widget_index[search]', search_value)
+        url = core__add_param_to_url(url, 'widget_index[sort]', sort_value)
+        url = core__add_param_to_url(url, 'widget_index[sort_dir]', sort_dir_value)
         return LatoCore::Elements::Pagination::Cell.new(total: total_pages, current: current_page, url: url,
         param: 'widget_index[pagination]')
       end

data/app/views/lato_core/doc/cells_elements/button.html.erb

@@ -367,5 +367,37 @@
 
 <%=raw block.close %>
 
+<%=raw row.close %>
+<!-- / CODE SECTION -->
+
+<hr>
+<%=raw cell(:elements, :title).new(label: 'Button with block style', size: 3) %>
+
+<%=raw row.open %>
+
+  <%=raw block.open %>
+
+    <%=raw cell(:elements, :button).new(label: 'Block link button', block: true, url: '#', remote: true) %>
+    <%=raw cell(:elements, :button).new(label: 'Block button', type: 'button', block: true, url: '#', remote: true) %>
+    
+  <%=raw block.close %>
+
+<%=raw row.close %>
+
+<!-- CODE SECTION -->
+<%=raw row.open %>
+
+<%=raw block.open %>
+
+<%=raw cell(:elements, :title).new(label: 'Code', size: 6) %>
+
+<%=raw code.open %>
+
+<%= erb_open_tag %>=raw cell(:elements, :button).new(label: 'Block button', block: true, url: '#', remote: true) <%= erb_close_tag %>
+
+<%=raw code.close %>
+
+<%=raw block.close %>
+
 <%=raw row.close %>
 <!-- / CODE SECTION -->

data/app/views/lato_core/doc/cells_widgets/index.html.erb

@@ -202,4 +202,51 @@ options</p>
 <%=raw block.close %>
 
 <%=raw row.close %>
-<!-- / CODE SECTION -->
+<!-- / CODE SECTION -->
+
+<hr>
+<%=raw cell(:elements, :title).new(label: 'Index with sortable attributes', size: 3) %>
+
+<%=raw row.open %>
+
+  <%=raw block.open %>
+
+    <%=raw cell(:widgets, :index).new(records: @widget_index_superusers,
+    head: [
+      {label: 'Name', sort: 'name'},
+      {label: 'Surname', sort: 'surname'},
+      'Email', 'Username'
+    ],
+    columns: ['name', 'surname', 'email', 'username'], index_url: lato_core.doc_cells_widgets_index_path,
+    actions: {show: false, edit: false, delete: false, new: false}, search: true, pagination: true,
+    table: { fixed: true, height: 150 }, table_body: { hover: true }) %>
+    
+  <%=raw block.close %>
+
+<%=raw row.close %>
+
+<!-- CODE SECTION -->
+<%=raw row.open %>
+
+<%=raw block.open %>
+
+<%=raw cell(:elements, :title).new(label: 'Code', size: 6) %>
+
+<%=raw code.open %>
+
+<%= erb_open_tag %>raw cell(:widgets, :index).new(records: @widget_index_superusers,
+    head: [
+      {label: 'Name', sort: 'name'},
+      {label: 'Surname', sort: 'surname'},
+      'Email', 'Username'
+    ],
+    columns: ['name', 'surname', 'email', 'username'], index_url: lato_core.doc_cells_widgets_index_path,
+    actions: {show: false, edit: false, delete: false, new: false}, search: true, pagination: true,
+    table: { fixed: true, height: 150 }, table_body: { hover: true })<%= erb_close_tag %>
+
+<%=raw code.close %>
+
+<%=raw block.close %>
+
+<%=raw row.close %>
+<!-- / CODE SECTION -->

data/lib/lato_core/interfaces/cells.rb

@@ -18,14 +18,32 @@ module LatoCore
         per_page: pagination,
         search: '',
         search_key: search,
+        sort: '',
+        sort_dir: 'ASC',
         pagination: 1,
       }
+
       # manage search
       if search && params[:widget_index] && params[:widget_index][:search] && !params[:widget_index][:search].blank?
-        response[:records] = response[:records].where("#{search} like ?", "%#{params[:widget_index][:search]}%")
+        search_array = search.is_a?(Array) ? search : [search]
+        query1 = ''
+        query2 = []
+        search_array.each do |s|
+          query1 += "#{s} like ? OR "
+          query2.push("%#{params[:widget_index][:search]}%")
+        end
+        query1 = query1[0...-4]
+        query = [query1] + query2
+        response[:records] = response[:records].where(query)
         response[:total] = response[:records].length
         response[:search] = params[:widget_index][:search]
       end
+      # manage sort
+      if params[:widget_index] && !params[:widget_index][:sort].blank? && !params[:widget_index][:sort_dir].blank?
+        response[:sort] = params[:widget_index][:sort]
+        response[:sort_dir] = params[:widget_index][:sort_dir]
+        response[:records] = response[:records].order("#{params[:widget_index][:sort]} #{params[:widget_index][:sort_dir]}")
+      end
       # manage pagination
       if pagination
         if params[:widget_index] && params[:widget_index][:pagination]

data/lib/lato_core/version.rb

@@ -2,6 +2,6 @@
 
 module LatoCore
 
-  VERSION = '2.2.0'
+  VERSION = '2.2.2'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lato_core
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.2
 platform: ruby
 authors:
 - Ideonetwork
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-26 00:00:00.000000000 Z
+date: 2018-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -471,7 +471,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.14
+rubygems_version: 2.7.3
 signing_key: 
 specification_version: 4
 summary: Lato core module