1  # RedMine - project management software
   2  # Copyright (C) 2006-2011  Jean-Philippe Lang
   3  #
   4  # This program is free software; you can redistribute it and/or
   5  # modify it under the terms of the GNU General Public License
   6  # as published by the Free Software Foundation; either version 2
   7  # of the License, or (at your option) any later version.
   8  #
   9  # This program is distributed in the hope that it will be useful,
  10  # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  # GNU General Public License for more details.
  13  #
  14  # You should have received a copy of the GNU General Public License
  15  # along with this program; if not, write to the Free Software
  16  # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  17 
  18  class Document < ActiveRecord::Base
  19    include Redmine::SafeAttributes
  20    belongs_to :project
  21    belongs_to :category, :class_name => "DocumentCategory", :foreign_key => "category_id"
  22    acts_as_attachable :delete_permission => :manage_documents
  23 
  24    acts_as_searchable :columns => ['title', "#{table_name}.description"], :include => :project
  25    acts_as_event :title => Proc.new {|o| "#{l(:label_document)}: #{o.title}"},
  26                  :author => Proc.new {|o| (a = o.attachments.find(:first, :order => "#{Attachment.table_name}.created_on ASC")) ? a.author : nil },
  27                  :url => Proc.new {|o| {:controller => 'documents', :action => 'show', :id => o.id}}
  28    acts_as_activity_provider :find_options => {:include => :project}
  29 
  30    validates_presence_of :project, :title, :category
  31    validates_length_of :title, :maximum => 60
  32 
  33    named_scope :visible, lambda {|*args| { :include => :project,
  34                                            :conditions => Project.allowed_to_condition(args.shift || User.current, :view_documents, *args) } }
  35 
  36    safe_attributes 'category_id', 'title', 'description'
  37 
  38    def visible?(user=User.current)
  39      !user.nil? && user.allowed_to?(:view_documents, project)
  40    end
  41 
  42    def initialize(attributes=nil, *args)
  43      super
  44      if new_record?
  45        self.category ||= DocumentCategory.default
  46      end
  47    end
  48 
  49    def updated_on
  50      unless @updated_on
  51        a = attachments.last
  52        @updated_on = (a && a.created_on) || created_on
  53      end
  54      @updated_on
  55    end
  56  end