openproject-meeting 3.0.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NzIwZjYwNThkYmVkNjllYWYzZDViN2I2MGU3MDVhMTljNDY1MTMwMA==
+  data.tar.gz: !binary |-
+    MjZhNzM5YzUwN2MwYTExZDgwNjFhMWYxMWFiZDIyMjNkYzBmMzYyZA==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZWNlY2VmODcwYWFjN2JlNzY5N2QxZGY1YjMxYmI1NDJkMjhmYWZkYmE2ZGFl
+    M2YxYjYxMjc1OGNlZjk1MjRlNTNhNDU4ZWU0YzRkY2UyMmQ1ODNmMWI5YzU3
+    MjI5YTA2NTU5NDUxOWY2OThlNzEwOTA5ZTQyZWM1YzkzZTQ1YjQ=
+  data.tar.gz: !binary |-
+    NDY3MzRkZDYyMTFhYzVkMWRlOTAwOGRhNWJhOTBlZmViNDQ0OTBhZDQxOTFl
+    MGQ4NzI4MDI1Njg5MTBhYzM1NjJkOTI1NGYwODg3NWEyYjAzMzdmNTIxNWEz
+    ZjBkYjgzNTk5NTNjOWFmNWM0YTk5ZWNiMGYyMTUyZDM2YTU4MWE=

data/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+## 3.0.0
+
+* `#1554` Execute release
+
+## 3.0.0.rc2
+
+* `#1529` First public release
+* `#1551` Fixed bug: Not possible to withdraw invitation
+
+## 2013-07-04 Christian Ratz <c.ratz@finn.de>
+
+	* fix time zones bug
+
+## 2013-06-27 Christian Ratz <c.ratz@finn.de>
+
+	* new pagination
+	* fix time zones bug
+
+## 2013-06-21 Christian Ratz <c.ratz@finn.de>
+
+	* Use final plugin name schema
+
+## 2013-06-14 Christian Ratz <c.ratz@finn.de>
+
+	* added dependency to OpenProject core >= 3.0.0beta1
+
+## 2013024 Christian Ratz <c.ratz@finn.de>
+
+	* RC1 of the Rails 3 version
+	* This version is no longer compatible with the Rails 2 core
+
+## 2013-03-22 Jens Ulferts <j.ulferts@finn.de>
+
+  * fixes routes
+	* removes unnecessary code
+	* shows only the users as possible participants who have the required
+	  permissions
+	* adds missing html_safe
+	* fixes mailer i18n issue
+
+## 2013-03-18  Hagen Schink <h.schink@finn.de>
+
+	* Swtiched to version 0.2.5
+	* Rails 3.2-ified plug-in

data/README.md

@@ -0,0 +1,82 @@
+OpenProject Meeting Plugin
+==========================
+
+This plugin adds functions to support project meetings to
+[OpenProject](https://www.openproject.org). Meetings
+can be scheduled selecting invitees from the same project to take
+part in the meeting. An agenda can be created and sent to the invitees.
+After the meeting, attendants can be selected and minutes can be
+created based on the agenda. Finally, the minutes can be sent to
+all attendants and invitees.
+
+A more detailed feature tour can be found [here](https://www.openproject.org/projects/openproject/wiki/Meetings).
+
+Requirements
+------------
+
+The meetings plugin currently requires the [OpenProject Core](https://github.com/opf/openproject/) in
+version 3.0.0pre9 or newer.
+
+
+Installation
+------------
+
+Please follow the default [plugin installation instructions for
+OpenProject](https://www.openproject.org/projects/openproject/wiki/Installation#222-Add-plugins),
+adding the following line to the Gemfile.plugins:
+
+`gem "openproject-meeting", :git => "https://github.com/finnlabs/openproject-meeting"`
+
+Afterwards, run:
+
+`bundle install`
+
+This plugin contains migrations. To migrate the database, run:
+
+`rake openproject_meeting:install:migrations`
+
+`rake db:migrate`
+
+Deinstallation
+--------------
+
+Remove the line
+
+`gem "openproject-meeting", :git => "https://github.com/finnlabs/openproject-meeting"`
+
+from the file `Gemfile.plugins` and run:
+
+`bundle install`
+
+Please not that this leaves plugin data in the database. Currently, we do not
+support full uninstall of the plugin.
+
+Bug Reporting
+-------------
+
+If you find any bugs, you can create a bug ticket at
+
+https://www.openproject.org/projects/plugin-meetings
+
+Development
+-----------
+
+To contribute, you can create pull request on the official repository at
+
+`https://github.com/finnlabs/openproject-meeting`
+
+Credits
+-------
+
+Special thanks go to
+
+* Deutsche Telekom AG (opensource@telekom.de) for project sponsorhip
+* Le Moign Vincent and his fabulous Minicons icons on [webalys.com](http://www.webalys.com/minicons/icons-free-pack.php)
+
+License
+-------
+
+(c) 2011 - 2013 - Finn GmbH
+
+This plugin is licensed under the GNU GPL v3. See doc/COPYRIGHT.rdoc and
+doc/GPL.txt for details.

data/app/assets/stylesheets/meeting/meeting.css.erb

@@ -0,0 +1,39 @@
+.meetings div.meeting {padding-bottom: 1em;}
+div.meeting_content {padding-bottom: 2em;}
+div.meetings_by_date {padding: 1em 0 1em 2em;}
+dl.meetings p, div#activity dl.meetings dd, div#activity dl.meetings dt {padding: 0;}
+dl.meetings {margin-bottom: 2em;}
+
+div.tabular > div { margin: 0;
+  padding: 5px 0 8px 0;
+  padding-left: 180px; /*width of left column containing the label elements*/
+  height: 1%;
+  clear:left;
+}
+
+#meeting_agenda_preview fieldset {margin-top: 1em; background: url(<%= asset_path 'draft.png' %>);}
+#meeting_minutes_preview fieldset {margin-top: 1em; background: url(<%= asset_path 'draft.png' %>);}
+
+dt.meeting {
+  background-image: url(<%= asset_path 'meeting/meeting.png' %>);
+}
+
+dt.meeting-agenda {
+  background-image: url(<%= asset_path 'meeting/agenda.png' %>);
+}
+
+dt.meeting-minutes {
+  background-image: url(<%= asset_path 'meeting/minutes.png' %>);
+}
+div#activity dl.meetings dt span {
+  padding-left: 15px;
+}
+
+div.flash.notice a.link_to_profile {
+  cursor:pointer;
+  color: #008BD0;
+}
+
+div.flash.notice a.link_to_profile:hover {
+  text-decoration: underline;
+}

data/app/controllers/meeting_agendas_controller.rb

@@ -0,0 +1,33 @@
+#-- 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 MeetingAgendasController < MeetingContentsController
+
+  menu_item :meetings
+
+  def close
+    @meeting.close_agenda_and_copy_to_minutes!
+
+    redirect_back_or_default :controller => '/meetings', :action => 'show', :id => @meeting
+  end
+
+  def open
+    @content.unlock!
+    redirect_back_or_default :controller => '/meetings', :action => 'show', :id => @meeting
+  end
+
+  private
+
+  def find_content
+    @content = @meeting.agenda || @meeting.build_agenda
+    @content_type = "meeting_agenda"
+  end
+end

data/app/controllers/meeting_contents_controller.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 MeetingContentsController < ApplicationController
+
+  include PaginationHelper
+
+  menu_item :meetings
+
+  helper :watchers
+  helper :wiki
+  helper :meetings
+  helper :meeting_contents
+  helper :watchers
+  helper :meetings
+
+  before_filter :find_meeting, :find_content
+  before_filter :authorize
+
+  def show
+    # Redirect links to the last version
+    (redirect_to :controller => '/meetings', :action => :show, :id => @meeting, :tab => @content_type.sub(/^meeting_/, '') and return) if params[:id].present? && @content.version == params[:id].to_i
+
+    @content = @content.journals.at params[:id].to_i unless params[:id].blank?
+    render 'meeting_contents/show'
+  end
+
+  def update
+    (render_403; return) unless @content.editable? # TODO: not tested!
+    @content.attributes = params[:"#{@content_type}"]
+    @content.author = User.current
+    if @content.save
+      flash[:notice] = l(:notice_successful_update)
+      redirect_back_or_default :controller => '/meetings', :action => 'show', :id => @meeting
+    else
+    end
+  rescue ActiveRecord::StaleObjectError
+    # Optimistic locking exception
+    flash.now[:error] = l(:notice_locking_conflict)
+    params[:tab] ||= "minutes" if @meeting.agenda.present? && @meeting.agenda.locked?
+    render 'meetings/show'
+  end
+
+  def history
+    # don't load text
+    @content_versions = @content.journals.select("id, user_id, notes, created_at, version")
+                                         .order('version DESC')
+                                         .page(page_param)
+                                         .per_page(per_page_param)
+
+    render 'meeting_contents/history', :layout => !request.xhr?
+  end
+
+  def diff
+    @diff = @content.diff(params[:version_to], params[:version_from])
+    render 'meeting_contents/diff'
+  rescue ActiveRecord::RecordNotFound
+    render_404
+  end
+
+  def notify
+    unless @content.new_record?
+      MeetingMailer.content_for_review(@content, @content_type).deliver
+      flash[:notice] = l(:notice_successful_notification)
+    end
+    redirect_back_or_default :controller => '/meetings', :action => 'show', :id => @meeting
+  end
+
+  def preview
+    (render_403; return) unless @content.editable?
+    @text = params[:text]
+    render :partial => 'common/preview'
+  end
+
+  def default_breadcrumb
+    MeetingsController.new.send(:default_breadcrumb)
+  end
+  private
+
+  def find_meeting
+    @meeting = Meeting.find(params[:meeting_id], :include => [:project, :author, :participants, :agenda, :minutes])
+    @project = @meeting.project
+    @author = User.current
+  rescue ActiveRecord::RecordNotFound
+    render_404
+  end
+end

data/app/controllers/meeting_minutes_controller.rb

@@ -0,0 +1,22 @@
+#-- 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 MeetingMinutesController < MeetingContentsController
+
+  menu_item :meetings
+
+  private
+
+  def find_content
+    @content = @meeting.minutes || @meeting.build_minutes
+    @content_type = "meeting_minutes"
+  end
+end

data/app/controllers/meetings_controller.rb

@@ -0,0 +1,150 @@
+#-- 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 MeetingsController < ApplicationController
+
+  around_filter :set_time_zone
+  before_filter :find_project, :only => [:index, :new, :create]
+  before_filter :find_meeting, :except => [:index, :new, :create]
+  before_filter :convert_params, :only => [:create, :update]
+  before_filter :authorize
+
+  helper :journals
+  helper :watchers
+  helper :meeting_contents
+  include WatchersHelper
+  include PaginationHelper
+
+  menu_item :new_meeting, :only => [:new, :create]
+
+  def index
+    scope = @project.meetings
+
+    # from params => today's page otherwise => first page as fallback
+    tomorrows_meetings_count = scope.from_tomorrow.count
+    @page_of_today = 1 + tomorrows_meetings_count / per_page_param
+
+    page = params['page'] ?
+             page_param :
+             @page_of_today
+
+    @meetings = scope.with_users_by_date
+                     .page(page)
+                     .per_page(per_page_param)
+
+    @meetings_by_start_year_month_date = Meeting.group_by_time(@meetings)
+  end
+
+  def show
+    params[:tab] ||= "minutes" if @meeting.agenda.present? && @meeting.agenda.locked?
+  end
+
+  def create
+    @meeting.participants.clear # Start with a clean set of participants
+    @meeting.participants_attributes = params[:meeting].delete(:participants_attributes)
+    @meeting.attributes = params[:meeting]
+    if params[:copied_from_meeting_id].present? && params[:copied_meeting_agenda_text].present?
+      @meeting.agenda = MeetingAgenda.new(
+        :text => params[:copied_meeting_agenda_text],
+        :comment => "Copied from Meeting ##{params[:copied_from_meeting_id]}")
+      @meeting.agenda.author = User.current
+    end
+    if @meeting.save
+      text = l(:notice_successful_create)
+      if User.current.time_zone.nil?
+        link = l(:notice_timezone_missing, :zone => Time.zone)
+        text += " #{view_context.link_to(link, {:controller => '/my', :action => :account},:class => "link_to_profile")}"
+      end
+      flash[:notice] = text.html_safe
+
+      redirect_to :action => 'show', :id => @meeting
+    else
+      render :action => 'new', :project_id => @project
+    end
+  end
+
+  def new
+  end
+
+  def copy
+    params[:copied_from_meeting_id] = @meeting.id
+    params[:copied_meeting_agenda_text] = @meeting.agenda.text if @meeting.agenda.present?
+    @meeting = @meeting.copy(:author => User.current)
+    render :action => 'new', :project_id => @project
+  end
+
+  def destroy
+    @meeting.destroy
+    flash[:notice] = l(:notice_successful_delete)
+    redirect_to :action => 'index', :project_id => @project
+  end
+
+  def edit
+  end
+
+  def update
+    @meeting.participants_attributes = params[:meeting].delete(:participants_attributes)
+    @meeting.attributes = params[:meeting]
+    if @meeting.save
+      flash[:notice] = l(:notice_successful_update)
+      redirect_to :action => 'show', :id => @meeting
+    else
+      render :action => 'edit'
+    end
+  end
+
+  private
+
+  def set_time_zone
+    old_time_zone = Time.zone
+    zone = User.current.time_zone
+    if zone.nil?
+      localzone = Time.now.utc_offset
+      localzone-= 3600 if Time.now.dst?
+      zone = ::ActiveSupport::TimeZone[localzone]
+    end
+    Time.zone = zone
+    yield
+  ensure
+    Time.zone = old_time_zone
+  end
+
+  def find_project
+    @project = Project.find(params[:project_id])
+    @meeting = Meeting.new
+    @meeting.project = @project
+    @meeting.author = User.current
+  end
+
+  def find_meeting
+    @meeting = Meeting.find(params[:id], :include => [:project, :author, {:participants => :user}, :agenda, :minutes])
+    @project = @meeting.project
+  rescue ActiveRecord::RecordNotFound
+    render_404
+  end
+
+  def convert_params
+    start_date = params[:meeting].delete(:start_date)
+    start_time_4i = params[:meeting].delete(:"start_time(4i)")
+    start_time_5i = params[:meeting].delete(:"start_time(5i)")
+    begin
+      timestring = "#{start_date} #{start_time_4i}:#{start_time_5i}"
+      time = Time.zone.parse(timestring)
+      params[:meeting][:start_time] = time
+    rescue ArgumentError
+      params[:meeting][:start_time] = nil
+    end
+    params[:meeting][:duration] = params[:meeting][:duration].to_hours
+    # Force defaults on participants
+    params[:meeting][:participants_attributes] ||= {}
+    params[:meeting][:participants_attributes].each {|p| p.reverse_merge! :attended => false, :invited => false}
+  end
+end