simple_calendar-timeslot 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6707f6b5e80e3b24e0329d17e629cfef2d39179c3e725baad3a60d526503963a
-  data.tar.gz: c05379b32ca660ac1cee7d0c44ee09c2666c0bbbbf60759c169127e057c90d1d
+  metadata.gz: 7522e42ad4d981ea9307e4ec7af21b95bbf1c330d321e73fd8e265d73955346e
+  data.tar.gz: d6562afe5db9a28979553bc1a089fa2ad0454af8dae55f120bcefd8b3d617f36
 SHA512:
-  metadata.gz: 74c59bce0c06b79e65b9838b39c4222b5e481546f43a577acaf56cda80781bf553a86d29bfd21366aeb0b0daa226fe5b7e630b482f5e435bd3280dd438316e6a
-  data.tar.gz: 7c7583c4197f06951d76bc784a7444ec3c2c17bfcad0e466d7d3c3449407ec1de3f93b314f83c1e40c83322106554edabe6f5f6f8239916b8529308cf0d65e90
+  metadata.gz: 6557f1572ef373f53325412e0e8f47eb9acaa01f639cfce83b128a1a1e31a4657eb9ff841a01e3dec96d7fd69970675c33237e3fa5e6e8b60303a53a1e15e62d
+  data.tar.gz: ddafaefd0434bf85d5f29b01d31c9bb279028123ffd957a8332710d25bcf125d51d475f70f4133c652869ce21c40d6aff24ec29938dca2ae51e639bacf0f99f6

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    simple_calendar-timeslot (0.3.0)
+    simple_calendar-timeslot (0.4.0)
       simple_calendar (~> 2.0)
 
 GEM

data/README.md

@@ -2,10 +2,18 @@
 
 This is an extension of the rubygem `simple_calendar` by Chris Oliver aka excid3. It allows 
 for simple calendar creation in a Ruby on Rails app with an timeslot representation of events 
-in a 24h day. This helps to visually grasps the length of events and the time between them. In case of overlapping, the respective events are shown side-by-side. It is also possible to categorise events in buckets according to some function, then they will be shown next to one another in the 24h timeline.
+in a 24h day. 
+
+This helps to visually grasps the length of events and the time between them. In case of overlapping, the respective events are shown side-by-side. It is also possible to categorise events in buckets according to some function, then they will be shown next to one another in the 24h timeline.
+
 Horizontal and vertical layout is selectable via options, just like many other ones.
 
-TODO: show examples
+Horizontal example
+![Horizontal Calendar](img/simple_calendar-timeslot_horizontal.png)
+
+Vertical example
+![Vertical Calendar](img/simple_calendar-timeslot_vertical.png)
+
 
 ## Installation
 
@@ -23,12 +31,51 @@ Or install it yourself as:
 
     $ gem install simple_calendar-timeslot
 
-TODO: include stylesheet, show sprockets and scss usecases
+
+**Important** Then include the stylesheet in your rails app.
+
+If you an `application.css` file, include the following:
+```ruby
+*= require simple_calendar-timeslot
+```
+If you use an SCSS file (`application.scss`), add the following line instead:
+```ruby
+@import 'simple_calendar-timeslot';
+```
 
 ## Usage
 
 TODO: Write usage instructions here
 
+```erb
+<%= timeslot_calendar(events: @events,
+                      number_of_days: 2,
+                      px_per_minute: 1.5,
+                      orientation: :horizontal,
+                      horizontal_height_px: 250,
+                      # display_grid: false,
+                      # display_bucket_title: :event_type,
+                      # bucket_title_size: 30,
+                      # grid_width: "20px",
+                      # split_by_type: :event_type
+                     ) do |event| %>
+  <div class="timeslot-event">
+    <%= event.title %>
+  </div>
+<% end %>
+
+```
+
+Shortversion in the meantime:
+- orientation (:vertical, :horizontal, default: :vertical)
+- horizontal_height_px default: 300
+- split_by_type (model function to call in case of bucketung f.ex.`:event_type`, default: false)
+- px_per_minute default: 0.65
+- display_bucket_title (model function to call in case of bucketung f.ex.`:event_type_name`, default: false)
+- bucket_title_size default: 20
+- grid_width default: 20px
+- display_grid default: true
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/simple_calendar/timeslot/timeslot_calendar.rb

@@ -1,53 +1,31 @@
 require "simple_calendar"
 
 module SimpleCalendar
-  module Timeslot
+  module Timeslot    
     class TimeslotCalendar < SimpleCalendar::Calendar
       MINUTE_HEIGHT_PX = 0.65
       FIRST_HOUR_SLOT = 0
-    
-      def height
-        h = (24 - TimeslotCalendar::FIRST_HOUR_SLOT) * 60 * px_per_minute
-        h = h+bucket_title_size if display_bucket_title
-        h
-      end
-    
-      def event_height(event, day)
-        minutes = if event.start_time.to_date != day
-                    (event.end_time - event.end_time.midnight)/60
-                  elsif event.start_time.to_date < event.end_time.to_date
-                    (event.end_time.midnight - 60 - event.start_time)/60
-                  else
-                    event.duration
-                  end
-        minutes * px_per_minute
-      end
-    
-      def event_top_distance(event, day)
-        return 0 if event.start_time.to_date != day
-        (event.start_time.hour - TimeslotCalendar::FIRST_HOUR_SLOT) * 60 * px_per_minute + event.start_time.min * px_per_minute
-      end
-    
+
       def orientation
         @options.fetch(:orientation, :vertical)
       end
-    
+
       def horizontal_height_px
         @options.fetch(:horizontal_height_px, 300)
       end
-    
+
       def split_by_type
         @options.fetch(:split_by_type, false)
       end
-    
+
       def px_per_minute
         @options.fetch(:px_per_minute, TimeslotCalendar::MINUTE_HEIGHT_PX)
       end
-    
+
       def display_bucket_title
         @options.fetch(:display_bucket_title, false)
       end
-    
+
       def bucket_title_size
         if display_bucket_title
           @options.fetch(:bucket_title_size, 20)
@@ -55,11 +33,11 @@ module SimpleCalendar
           0
         end
       end
-    
+
       def grid_top_offset(hour)
         4.16666667 * hour
       end
-    
+
       def grid_width
         if display_grid
           @options.fetch(:grid_width, "20px")
@@ -67,11 +45,35 @@ module SimpleCalendar
           0
         end
       end
-    
+
       def display_grid
         @options.fetch(:display_grid, true)
       end
-    
+
+      def height
+        #h = (24 - TimeslotCalendar::FIRST_HOUR_SLOT) * 60 * px_per_minute
+        h = 24 * 60 * px_per_minute
+        h = h+bucket_title_size if display_bucket_title
+        h
+      end
+
+      def event_height(event, day)
+        minutes = if event.send(attribute).to_date != day
+                    (event.send(end_attribute) - event.send(end_attribute).midnight)/60
+                  elsif event.send(attribute).to_date < event.send(end_attribute).to_date
+                    (event.send(end_attribute).midnight - 60 - event.send(attribute))/60
+                  else
+                    event.duration
+                  end
+        minutes * px_per_minute
+      end
+
+      def event_top_distance(event, day)
+        return 0 if event.send(attribute).to_date != day
+        #(event.send(attribute).hour - TimeslotCalendar::FIRST_HOUR_SLOT) * 60 * px_per_minute + event.send(attribute).min * px_per_minute
+        event.send(attribute).hour * 60 * px_per_minute + event.send(attribute).min * px_per_minute
+      end
+
       def split_into_buckets(events)
         if split_by_type
           events.group_by{|e| e.send split_by_type}.values
@@ -79,33 +81,34 @@ module SimpleCalendar
           [events]
         end
       end
-    
+
       def slot_events(events, day)
         r = {}
         events.each do |event|
           r[event] = [0, 0, event_height(event, day), event_top_distance(event, day)]
         end
-        #
+        # Credit: https://stackoverflow.com/questions/11311410/visualization-of-calendar-events-algorithm-to-layout-events-with-maximum-width
+        # Author: Markus Jarderot (https://stackoverflow.com/users/22364/markus-jarderot)
         columns = [[]]
         last_event_ending = nil
         events.each do |event|
-          if(!last_event_ending.nil? && event.start_time > last_event_ending)
+          if !last_event_ending.nil? && event.send(attribute) > last_event_ending
             pack_events(r, columns)
-            colums = [[]]
+            columns = [[]]
             last_event_ending = nil
           end
           placed = false
           columns.each do |col|
-            if !events_collide(r, col.last, event)
+            unless events_collide(r, col.last, event)
               col << event
               placed = true
               break
             end
           end
-          if !placed
+          unless placed
             columns << [event]
           end
-          event_end_time = event.start_time + event.duration.minutes
+          event_end_time = event.send(end_attribute)
           if last_event_ending.nil? || event_end_time > last_event_ending
             last_event_ending = event_end_time
           end
@@ -115,7 +118,9 @@ module SimpleCalendar
         end
         r
       end
-    
+
+      private
+
       def pack_events(r, columns)
         num_columns = columns.size.to_f
         columns.each_with_index do |col, iter_col|
@@ -126,14 +131,14 @@ module SimpleCalendar
           end
         end
       end
-    
+
       def events_collide(r, event1, event2)
         return false if event1.nil? || event2.nil?
         event1_bottom = r[event1][3] + r[event1][2]
         event2_bottom = r[event2][3] + r[event2][2]
         event1_bottom > r[event2][3] && r[event1][3] < event2_bottom
       end
-    
+
       def expand_event(r, event, iter_col, columns)
         col_span = 1
         columns.each_with_index do |column, index|
@@ -146,8 +151,6 @@ module SimpleCalendar
         end
         col_span
       end
-    
-      private
     end
   end
 end

data/lib/simple_calendar/timeslot/version.rb

@@ -2,6 +2,6 @@
 
 module SimpleCalendar
   module Timeslot
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simple_calendar-timeslot
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Kim Laplume
@@ -88,6 +88,8 @@ files:
 - app/views/simple_calendar/timeslot/_timeslot_calendar.html.erb
 - bin/console
 - bin/setup
+- img/simple_calendar-timeslot_horizontal.png
+- img/simple_calendar-timeslot_vertical.png
 - lib/simple_calendar/timeslot.rb
 - lib/simple_calendar/timeslot/railtie.rb
 - lib/simple_calendar/timeslot/timeslot_calendar.rb