Chris@0: # Redmine - project management software
Chris@245: # Copyright (C) 2006-2011  Jean-Philippe Lang
Chris@0: #
Chris@0: # This program is free software; you can redistribute it and/or
Chris@0: # modify it under the terms of the GNU General Public License
Chris@0: # as published by the Free Software Foundation; either version 2
Chris@0: # of the License, or (at your option) any later version.
Chris@909: #
Chris@0: # This program is distributed in the hope that it will be useful,
Chris@0: # but WITHOUT ANY WARRANTY; without even the implied warranty of
Chris@0: # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Chris@0: # GNU General Public License for more details.
Chris@909: #
Chris@0: # You should have received a copy of the GNU General Public License
Chris@0: # along with this program; if not, write to the Free Software
Chris@0: # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
Chris@0: 
Chris@0: require 'diff'
Chris@0: require 'enumerator'
Chris@0: 
Chris@0: class WikiPage < ActiveRecord::Base
Chris@0:   belongs_to :wiki
Chris@0:   has_one :content, :class_name => 'WikiContent', :foreign_key => 'page_id', :dependent => :destroy
Chris@0:   acts_as_attachable :delete_permission => :delete_wiki_pages_attachments
Chris@0:   acts_as_tree :dependent => :nullify, :order => 'title'
Chris@0: 
Chris@0:   acts_as_watchable
Chris@0:   acts_as_event :title => Proc.new {|o| "#{l(:label_wiki)}: #{o.title}"},
Chris@0:                 :description => :text,
Chris@0:                 :datetime => :created_on,
chris@37:                 :url => Proc.new {|o| {:controller => 'wiki', :action => 'show', :project_id => o.wiki.project, :id => o.title}}
Chris@0: 
Chris@909:   acts_as_searchable :columns => ['title', "#{WikiContent.table_name}.text"],
Chris@0:                      :include => [{:wiki => :project}, :content],
Chris@441:                      :permission => :view_wiki_pages,
Chris@0:                      :project_key => "#{Wiki.table_name}.project_id"
Chris@0: 
Chris@0:   attr_accessor :redirect_existing_links
Chris@909: 
Chris@0:   validates_presence_of :title
Chris@0:   validates_format_of :title, :with => /^[^,\.\/\?\;\|\s]*$/
Chris@0:   validates_uniqueness_of :title, :scope => :wiki_id, :case_sensitive => false
Chris@0:   validates_associated :content
Chris@909: 
Chris@909:   validate :validate_parent_title
Chris@909:   before_destroy :remove_redirects
Chris@909:   before_save    :handle_redirects
Chris@909: 
Chris@441:   # eager load information about last updates, without loading text
Chris@441:   named_scope :with_updated_on, {
Chris@441:     :select => "#{WikiPage.table_name}.*, #{WikiContent.table_name}.updated_on",
Chris@441:     :joins => "LEFT JOIN #{WikiContent.table_name} ON #{WikiContent.table_name}.page_id = #{WikiPage.table_name}.id"
Chris@441:   }
Chris@909: 
Chris@0:   # Wiki pages that are protected by default
Chris@0:   DEFAULT_PROTECTED_PAGES = %w(sidebar)
Chris@909: 
Chris@0:   def after_initialize
Chris@0:     if new_record? && DEFAULT_PROTECTED_PAGES.include?(title.to_s.downcase)
Chris@0:       self.protected = true
Chris@0:     end
Chris@0:   end
Chris@909: 
Chris@0:   def visible?(user=User.current)
Chris@0:     !user.nil? && user.allowed_to?(:view_wiki_pages, project)
Chris@0:   end
Chris@0: 
Chris@0:   def title=(value)
Chris@0:     value = Wiki.titleize(value)
Chris@0:     @previous_title = read_attribute(:title) if @previous_title.blank?
Chris@0:     write_attribute(:title, value)
Chris@0:   end
Chris@0: 
Chris@909:   def handle_redirects
Chris@909:     self.title = Wiki.titleize(title)
Chris@0:     # Manage redirects if the title has changed
Chris@0:     if !@previous_title.blank? && (@previous_title != title) && !new_record?
Chris@0:       # Update redirects that point to the old title
Chris@0:       wiki.redirects.find_all_by_redirects_to(@previous_title).each do |r|
Chris@0:         r.redirects_to = title
Chris@0:         r.title == r.redirects_to ? r.destroy : r.save
Chris@0:       end
Chris@0:       # Remove redirects for the new title
Chris@0:       wiki.redirects.find_all_by_title(title).each(&:destroy)
Chris@0:       # Create a redirect to the new title
Chris@0:       wiki.redirects << WikiRedirect.new(:title => @previous_title, :redirects_to => title) unless redirect_existing_links == "0"
Chris@0:       @previous_title = nil
Chris@0:     end
Chris@0:   end
Chris@909: 
Chris@909:   def remove_redirects
Chris@0:     # Remove redirects to this page
Chris@0:     wiki.redirects.find_all_by_redirects_to(title).each(&:destroy)
Chris@0:   end
Chris@909: 
Chris@0:   def pretty_title
Chris@0:     WikiPage.pretty_title(title)
Chris@0:   end
Chris@909: 
Chris@0:   def content_for_version(version=nil)
Chris@0:     result = content.versions.find_by_version(version.to_i) if version
Chris@0:     result ||= content
Chris@0:     result
Chris@0:   end
Chris@909: 
Chris@0:   def diff(version_to=nil, version_from=nil)
Chris@0:     version_to = version_to ? version_to.to_i : self.content.version
Chris@0:     version_from = version_from ? version_from.to_i : version_to - 1
Chris@0:     version_to, version_from = version_from, version_to unless version_from < version_to
Chris@909: 
Chris@0:     content_to = content.versions.find_by_version(version_to)
Chris@0:     content_from = content.versions.find_by_version(version_from)
Chris@909: 
Chris@0:     (content_to && content_from) ? WikiDiff.new(content_to, content_from) : nil
Chris@0:   end
Chris@909: 
Chris@0:   def annotate(version=nil)
Chris@0:     version = version ? version.to_i : self.content.version
Chris@0:     c = content.versions.find_by_version(version)
Chris@0:     c ? WikiAnnotate.new(c) : nil
Chris@0:   end
Chris@909: 
Chris@0:   def self.pretty_title(str)
Chris@0:     (str && str.is_a?(String)) ? str.tr('_', ' ') : str
Chris@0:   end
Chris@909: 
Chris@0:   def project
Chris@0:     wiki.project
Chris@0:   end
Chris@909: 
Chris@0:   def text
Chris@0:     content.text if content
Chris@0:   end
Chris@909: 
Chris@441:   def updated_on
Chris@441:     unless @updated_on
Chris@441:       if time = read_attribute(:updated_on)
Chris@441:         # content updated_on was eager loaded with the page
Chris@441:         @updated_on = Time.parse(time) rescue nil
Chris@441:       else
Chris@441:         @updated_on = content && content.updated_on
Chris@441:       end
Chris@441:     end
Chris@441:     @updated_on
Chris@441:   end
Chris@909: 
Chris@0:   # Returns true if usr is allowed to edit the page, otherwise false
Chris@0:   def editable_by?(usr)
Chris@0:     !protected? || usr.allowed_to?(:protect_wiki_pages, wiki.project)
Chris@0:   end
Chris@909: 
Chris@0:   def attachments_deletable?(usr=User.current)
Chris@0:     editable_by?(usr) && super(usr)
Chris@0:   end
Chris@909: 
Chris@0:   def parent_title
Chris@0:     @parent_title || (self.parent && self.parent.pretty_title)
Chris@0:   end
Chris@909: 
Chris@0:   def parent_title=(t)
Chris@0:     @parent_title = t
Chris@0:     parent_page = t.blank? ? nil : self.wiki.find_page(t)
Chris@0:     self.parent = parent_page
Chris@0:   end
chris@37: 
Chris@0:   protected
Chris@909: 
Chris@909:   def validate_parent_title
Chris@0:     errors.add(:parent_title, :invalid) if !@parent_title.blank? && parent.nil?
Chris@0:     errors.add(:parent_title, :circular_dependency) if parent && (parent == self || parent.ancestors.include?(self))
Chris@0:     errors.add(:parent_title, :not_same_project) if parent && (parent.wiki_id != wiki_id)
Chris@0:   end
Chris@0: end
Chris@0: 
Chris@245: class WikiDiff < Redmine::Helpers::Diff
Chris@245:   attr_reader :content_to, :content_from
Chris@909: 
Chris@0:   def initialize(content_to, content_from)
Chris@0:     @content_to = content_to
Chris@0:     @content_from = content_from
Chris@245:     super(content_to.text, content_from.text)
Chris@0:   end
Chris@0: end
Chris@0: 
Chris@0: class WikiAnnotate
Chris@0:   attr_reader :lines, :content
Chris@909: 
Chris@0:   def initialize(content)
Chris@0:     @content = content
Chris@0:     current = content
Chris@0:     current_lines = current.text.split(/\r?\n/)
Chris@0:     @lines = current_lines.collect {|t| [nil, nil, t]}
Chris@0:     positions = []
Chris@0:     current_lines.size.times {|i| positions << i}
Chris@0:     while (current.previous)
Chris@0:       d = current.previous.text.split(/\r?\n/).diff(current.text.split(/\r?\n/)).diffs.flatten
Chris@0:       d.each_slice(3) do |s|
Chris@0:         sign, line = s[0], s[1]
Chris@0:         if sign == '+' && positions[line] && positions[line] != -1
Chris@0:           if @lines[positions[line]][0].nil?
Chris@0:             @lines[positions[line]][0] = current.version
Chris@0:             @lines[positions[line]][1] = current.author
Chris@0:           end
Chris@0:         end
Chris@0:       end
Chris@0:       d.each_slice(3) do |s|
Chris@0:         sign, line = s[0], s[1]
Chris@0:         if sign == '-'
Chris@0:           positions.insert(line, -1)
Chris@0:         else
Chris@0:           positions[line] = nil
Chris@0:         end
Chris@0:       end
Chris@0:       positions.compact!
Chris@0:       # Stop if every line is annotated
Chris@0:       break unless @lines.detect { |line| line[0].nil? }
Chris@0:       current = current.previous
Chris@0:     end
Chris@909:     @lines.each { |line|
Chris@507:       line[0] ||= current.version
Chris@507:       # if the last known version is > 1 (eg. history was cleared), we don't know the author
Chris@507:       line[1] ||= current.author if current.version == 1
Chris@507:     }
Chris@0:   end
Chris@0: end