openproject-meeting 3.0.0

data/app/helpers/meeting_contents_helper.rb

@@ -0,0 +1,68 @@
+#-- copyright
+# OpenProject is a project management system.
+#
+# Copyright (C) 2012-2013 the OpenProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# See doc/COPYRIGHT.rdoc for more details.
+#++
+
+module MeetingContentsHelper
+  def can_edit_meeting_content?(content, content_type)
+    authorize_for(content_type.pluralize, 'update') && content.editable?
+  end
+
+  def saved_meeting_content_text_present?(content)
+    !content.new_record? && content.text.present? && !content.text.empty?
+  end
+
+  def show_meeting_content_editor?(content, content_type)
+    can_edit_meeting_content?(content, content_type) && (!saved_meeting_content_text_present?(content) || content.changed?)
+  end
+
+  def meeting_content_context_menu(content, content_type)
+    menu = []
+    menu << meeting_agenda_toggle_status_link(content, content_type)
+    menu << meeting_content_edit_link(content_type) if can_edit_meeting_content?(content, content_type)
+    menu << meeting_content_history_link(content_type, content.meeting)
+    menu << meeting_content_notify_link(content_type, content.meeting) if saved_meeting_content_text_present?(content)
+    menu.join(" ")
+  end
+
+  def meeting_agenda_toggle_status_link(content, content_type)
+    content.meeting.agenda.present? && content.meeting.agenda.locked? ?
+      open_meeting_agenda_link(content_type, content.meeting) :
+      close_meeting_agenda_link(content_type, content.meeting)
+  end
+
+  def close_meeting_agenda_link(content_type, meeting)
+    case content_type
+    when "meeting_agenda"
+      link_to_if_authorized l(:label_meeting_close), {:controller => '/meeting_agendas', :action => 'close', :meeting_id => meeting}, :method => :put, :class => "icon icon-lock show-meeting_agenda"
+    when "meeting_minutes"
+      link_to_if_authorized l(:label_meeting_agenda_close), {:controller => '/meeting_agendas', :action => 'close', :meeting_id => meeting}, :method => :put, :class => "icon icon-lock show-meeting_minutes"
+    end
+  end
+
+  def open_meeting_agenda_link(content_type, meeting)
+    case content_type
+    when "meeting_agenda"
+      link_to_if_authorized l(:label_meeting_open), {:controller => '/meeting_agendas', :action => 'open', :meeting_id => meeting}, :method => :put, :class => 'icon icon-unlock show-meeting_agenda', :confirm => l(:text_meeting_agenda_open_are_you_sure)
+    when "meeting_minutes"
+    end
+  end
+
+  def meeting_content_edit_link(content_type)
+    link_to l(:button_edit), "#", :class => "icon icon-edit show-#{content_type}", :accesskey => accesskey(:edit), :onclick => "$$('.edit-#{content_type}').invoke('show'); $$('.show-#{content_type}').invoke('hide'); return false;"
+  end
+
+  def meeting_content_history_link(content_type, meeting)
+    link_to_if_authorized l(:label_history), {:controller => '/' + content_type.pluralize, :action => 'history', :meeting_id => meeting}, :class => "icon icon-history show-#{content_type}"
+  end
+
+  def meeting_content_notify_link(content_type, meeting)
+    link_to_if_authorized l(:label_notify), {:controller => '/' + content_type.pluralize, :action => 'notify', :meeting_id => meeting}, :method => :put, :class => "icon icon-notification show-#{content_type}"
+  end
+end

data/app/helpers/meetings_helper.rb

@@ -0,0 +1,16 @@
+#-- copyright
+# OpenProject is a project management system.
+#
+# Copyright (C) 2012-2013 the OpenProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# See doc/COPYRIGHT.rdoc for more details.
+#++
+
+module MeetingsHelper
+  def format_participant_list(participants)
+    participants.sort.collect{|p| link_to_user p.user}.join("; ").html_safe
+  end
+end

data/app/mailers/meeting_mailer.rb

@@ -0,0 +1,28 @@
+#-- copyright
+# OpenProject is a project management system.
+#
+# Copyright (C) 2012-2013 the OpenProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# See doc/COPYRIGHT.rdoc for more details.
+#++
+
+class MeetingMailer < UserMailer
+
+  def content_for_review(content, content_type)
+    @meeting = content.meeting
+    @meeting_url = meeting_url @meeting
+    @project_url = project_url @meeting.project
+    @content_type = content_type
+
+    open_project_headers 'Project' => @meeting.project.identifier,
+                         'Meeting-Id' => @meeting.id
+
+    recipients = @meeting.watcher_recipients.reject{|r| r == @meeting.author.mail}
+
+    subject = "[#{@meeting.project.name}] #{I18n.t(:"label_#{content_type}")}: #{@meeting.title}"
+    mail :to => @meeting.author.mail, :cc => recipients, :subject => subject
+  end
+end

data/app/models/meeting.rb

@@ -0,0 +1,163 @@
+#-- copyright
+# OpenProject is a project management system.
+#
+# Copyright (C) 2012-2013 the OpenProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# See doc/COPYRIGHT.rdoc for more details.
+#++
+
+class Meeting < ActiveRecord::Base
+
+  self.table_name = 'meetings'
+
+  belongs_to :project
+  belongs_to :author, :class_name => 'User', :foreign_key => 'author_id'
+  has_one :agenda, :dependent => :destroy, :class_name => 'MeetingAgenda'
+  has_one :minutes, :dependent => :destroy, :class_name => 'MeetingMinutes'
+  has_many :contents, :class_name => 'MeetingContent', :readonly => true
+  has_many :participants, :dependent => :destroy, :class_name => 'MeetingParticipant'
+
+  default_scope order("#{Meeting.table_name}.start_time DESC")
+  scope :from_tomorrow, :conditions => ['start_time >= ?', Date.tomorrow.beginning_of_day]
+  scope :with_users_by_date, order("#{Meeting.table_name}.title ASC")
+                             .includes({:participants => :user}, :author)
+
+  attr_accessible :title, :location, :start_time, :duration
+
+  acts_as_watchable
+
+  acts_as_searchable :columns => ["#{table_name}.title", "#{MeetingContent.table_name}.text"],
+                     :include => [:contents, :project],
+                     :date_column => "#{table_name}.created_at"
+
+  acts_as_journalized :activity_find_options => {:include => [:agenda, :author, :project]},
+                      :event_title => Proc.new {|o| "#{l :label_meeting}: #{o.title} (#{format_date o.start_time} #{format_time o.start_time, false}-#{format_time o.end_time, false})"},
+                      :event_url => Proc.new {|o| {:controller => '/meetings', :action => 'show', :id => o.journaled}}
+
+  register_on_journal_formatter(:plaintext, 'title')
+  register_on_journal_formatter(:fraction, 'duration')
+  register_on_journal_formatter(:datetime, 'start_time')
+  register_on_journal_formatter(:plaintext, 'location')
+
+  accepts_nested_attributes_for :participants, :allow_destroy => true
+
+  validates_presence_of :title, :start_time, :duration
+
+  before_save :add_new_participants_as_watcher
+
+  after_initialize :set_initial_values
+
+  User.before_destroy do |user|
+    Meeting.update_all ['author_id = ?', DeletedUser.first.id], ['author_id = ?', user.id]
+  end
+
+  def start_date
+    # the text_field + calendar_for form helpers expect a Date
+    start_time.to_date if start_time.present?
+  end
+
+  def start_month
+    start_time.month
+  end
+
+  def start_year
+    start_time.year
+  end
+
+  def end_time
+    start_time + duration.hours
+  end
+
+  def to_s
+    title
+  end
+
+  def text
+    agenda.text if agenda.present?
+  end
+
+  def author=(user)
+    super
+    # Don't add the author as participant if we already have some through nested attributes
+    self.participants.build(:user => user, :invited => true) if (self.new_record? && self.participants.empty? && user)
+  end
+
+   # Returns true if usr or current user is allowed to view the meeting
+  def visible?(user=nil)
+    (user || User.current).allowed_to?(:view_meetings, self.project)
+  end
+
+  def all_possible_participants
+    self.project.users.all(:include => { :memberships => [:roles, :project] } ).select{ |u| self.visible?(u) }
+  end
+
+  def copy(attrs)
+    copy = self.dup
+
+    copy.author = attrs.delete(:author)
+    copy.attributes = attrs
+    copy.send(:set_initial_values)
+
+    copy.participants.clear
+    copy.participants_attributes = self.participants.collect(&:copy_attributes)
+
+    copy
+  end
+
+  def self.group_by_time(meetings)
+    by_start_year_month_date = ActiveSupport::OrderedHash.new do |hy, year|
+      hy[year] = ActiveSupport::OrderedHash.new do |hm, month|
+        hm[month] = ActiveSupport::OrderedHash.new
+      end
+    end
+
+    meetings.group_by(&:start_year).each do |year, objs|
+
+      objs.group_by(&:start_month).each do |month,objs|
+
+        objs.group_by(&:start_date).each do |date,objs|
+
+          by_start_year_month_date[year][month][date] = objs
+
+        end
+
+      end
+
+    end
+
+    by_start_year_month_date
+  end
+
+  def close_agenda_and_copy_to_minutes!
+    self.agenda.lock!
+    self.create_minutes(:text => agenda.text)
+  end
+
+  alias :original_participants_attributes= :participants_attributes=
+  def participants_attributes=(attrs)
+    attrs.each do |participant|
+      participant['_destroy'] = true if !(participant['attended'] || participant['invited'])
+    end
+    self.original_participants_attributes = attrs
+  end
+
+
+  protected
+
+  def set_initial_values
+    # set defaults
+    self.start_time ||= Date.tomorrow + 10.hours
+    self.duration   ||= 1
+  end
+
+  private
+
+  def add_new_participants_as_watcher
+    self.participants.select(&:new_record?).each do |p|
+      add_watcher(p.user)
+    end
+  end
+end

data/app/models/meeting_agenda.rb

@@ -0,0 +1,95 @@
+#-- copyright
+# OpenProject is a project management system.
+#
+# Copyright (C) 2012-2013 the OpenProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# See doc/COPYRIGHT.rdoc for more details.
+#++
+
+class MeetingAgenda < MeetingContent
+
+  acts_as_journalized :activity_type => 'meetings',
+    :activity_permission => :view_meetings,
+    :activity_find_options => {:include => {:meeting => :project}},
+    :event_title => Proc.new {|o| "#{l :label_meeting_agenda}: #{o.meeting.title}"},
+    :event_url => Proc.new {|o| {:controller => '/meetings', :action => 'show', :id => o.meeting}}
+
+  def activity_type
+    'meetings'
+  end
+
+  # TODO: internationalize the comments
+  def lock!(user = User.current)
+    self.comment = "Agenda closed"
+    self.author = user
+    self.locked = true
+    self.save
+  end
+
+  def unlock!(user = User.current)
+    self.comment = "Agenda opened"
+    self.author = user
+    self.locked = false
+    self.save
+  end
+
+  def editable?
+    !locked?
+  end
+
+  MeetingAgendaJournal.class_eval do
+    unloadable
+
+    attr_protected :data
+    after_save :compress_version_text
+
+    # Wiki Content might be large and the data should possibly be compressed
+    def compress_version_text
+      self.text = changed_data["text"].last if changed_data["text"]
+      self.text ||= self.journaled.text if self.journaled.text
+    end
+
+    def text=(plain)
+      case Setting.wiki_compression
+      when "gzip"
+        begin
+          text_hash :text => Zlib::Deflate.deflate(plain, Zlib::BEST_COMPRESSION), :compression => Setting.wiki_compression
+        rescue
+          text_hash :text => plain, :compression => ''
+        end
+      else
+        text_hash :text => plain, :compression => ''
+      end
+      plain
+    end
+
+    def text_hash(hash)
+      changed_data.delete("text")
+      changed_data["data"] = hash[:text]
+      changed_data["compression"] = hash[:compression]
+      update_attribute(:changed_data, changed_data)
+      # changed_data = changed_data
+    end
+
+    def text
+      @text ||= case changed_data[:compression]
+      when 'gzip'
+         Zlib::Inflate.inflate(data)
+      else
+        # uncompressed data
+        changed_data["data"]
+      end
+    end
+
+    def meeting
+      journaled.meeting
+    end
+
+    def editable?
+      false
+    end
+  end
+end

data/app/models/meeting_content.rb

@@ -0,0 +1,67 @@
+#-- copyright
+# OpenProject is a project management system.
+#
+# Copyright (C) 2012-2013 the OpenProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# See doc/COPYRIGHT.rdoc for more details.
+#++
+
+class MeetingContent < ActiveRecord::Base
+
+  belongs_to :meeting
+  belongs_to :author, :class_name => 'User', :foreign_key => 'author_id'
+
+  attr_accessor :comment
+
+  validates_length_of :comment, :maximum => 255, :allow_nil => true
+
+  attr_accessible :text, :lock_version, :comment
+
+  before_save :comment_to_journal_notes
+
+  User.before_destroy do |user|
+    MeetingContent.update_all ['author_id = ?', DeletedUser.first], ['author_id = ?', user.id]
+  end
+
+  def editable?
+    true
+  end
+
+  def diff(version_to=nil, version_from=nil)
+    version_to = version_to ? version_to.to_i : self.version
+    version_from = version_from ? version_from.to_i : version_to - 1
+    version_to, version_from = version_from, version_to unless version_from < version_to
+
+    content_to = self.journals.find_by_version(version_to)
+    content_from = self.journals.find_by_version(version_from)
+
+    (content_to && content_from) ? WikiPage::WikiDiff.new(content_to, content_from) : nil
+  end
+
+  # Compatibility for mailer.rb
+  def updated_on
+    updated_at
+  end
+
+  # Show the project on activity and search views
+  def project
+    meeting.project
+  end
+
+  # Provided for compatibility of the old pre-journalized migration
+  def self.create_versioned_table
+  end
+
+  # Provided for compatibility of the old pre-journalized migration
+  def self.drop_versioned_table
+  end
+
+  private
+
+  def comment_to_journal_notes
+    init_journal(author, comment) unless changes.empty?
+  end
+end

data/app/models/meeting_minutes.rb

@@ -0,0 +1,81 @@
+#-- copyright
+# OpenProject is a project management system.
+#
+# Copyright (C) 2012-2013 the OpenProject Team
+#
+# This program is free software; you can redistribute it and/or
+# modify it under the terms of the GNU General Public License version 3.
+#
+# See doc/COPYRIGHT.rdoc for more details.
+#++
+
+class MeetingMinutes < MeetingContent
+
+  acts_as_journalized :activity_type => 'meetings',
+    :activity_permission => :view_meetings,
+    :activity_find_options => {:include => {:meeting => :project}},
+    :event_title => Proc.new {|o| "#{l :label_meeting_minutes}: #{o.meeting.title}"},
+    :event_url => Proc.new {|o| {:controller => '/meetings', :action => 'show', :id => o.meeting}}
+
+  def activity_type
+    'meetings'
+  end
+
+  def editable?
+    meeting.agenda.present? && meeting.agenda.locked?
+  end
+
+  protected
+
+  MeetingMinutesJournal.class_eval do
+    unloadable
+
+    attr_protected :data
+    after_save :compress_version_text
+
+    # Wiki Content might be large and the data should possibly be compressed
+    def compress_version_text
+      self.text = changed_data["text"].last if changed_data["text"]
+      self.text ||= self.journaled.text if self.journaled.text
+    end
+
+    def text=(plain)
+      case Setting.wiki_compression
+      when "gzip"
+        begin
+          text_hash :text => Zlib::Deflate.deflate(plain, Zlib::BEST_COMPRESSION), :compression => Setting.wiki_compression
+        rescue
+          text_hash :text => plain, :compression => ''
+        end
+      else
+        text_hash :text => plain, :compression => ''
+      end
+      plain
+    end
+
+    def text_hash(hash)
+      changed_data.delete("text")
+      changed_data["data"] = hash[:text]
+      changed_data["compression"] = hash[:compression]
+      update_attribute(:changed_data, changed_data)
+    end
+
+    def text
+      @text ||= case changed_data[:compression]
+      when 'gzip'
+         Zlib::Inflate.inflate(data)
+      else
+        # uncompressed data
+        changed_data["data"]
+      end
+    end
+
+    def meeting
+      journaled.meeting
+    end
+
+    def editable?
+      false
+    end
+  end
+end