wiki.rb
85 lines
| 3.0 KiB
| text/x-ruby
|
RubyLexer
|
r2666 | # Redmine - project management software | ||
# Copyright (C) 2006-2009 Jean-Philippe Lang | ||||
|
r320 | # | ||
# This program is free software; you can redistribute it and/or | ||||
# modify it under the terms of the GNU General Public License | ||||
# as published by the Free Software Foundation; either version 2 | ||||
# of the License, or (at your option) any later version. | ||||
# | ||||
# This program is distributed in the hope that it will be useful, | ||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of | ||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||||
# GNU General Public License for more details. | ||||
# | ||||
# You should have received a copy of the GNU General Public License | ||||
# along with this program; if not, write to the Free Software | ||||
# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. | ||||
class Wiki < ActiveRecord::Base | ||||
belongs_to :project | ||||
|
r1650 | has_many :pages, :class_name => 'WikiPage', :dependent => :destroy, :order => 'title' | ||
|
r709 | has_many :redirects, :class_name => 'WikiRedirect', :dependent => :delete_all | ||
|
r320 | |||
|
r2666 | acts_as_watchable | ||
|
r332 | validates_presence_of :start_page | ||
|
r637 | validates_format_of :start_page, :with => /^[^,\.\/\?\;\|\:]*$/ | ||
|
r320 | |||
|
r3053 | def visible?(user=User.current) | ||
!user.nil? && user.allowed_to?(:view_wiki_pages, project) | ||||
end | ||||
|
r3518 | # Returns the wiki page that acts as the sidebar content | ||
# or nil if no such page exists | ||||
def sidebar | ||||
@sidebar ||= find_page('Sidebar', :with_redirect => false) | ||||
end | ||||
|
r320 | # find the page with the given title | ||
# if page doesn't exist, return a new page | ||||
def find_or_new_page(title) | ||||
|
r715 | title = start_page if title.blank? | ||
|
r709 | find_page(title) || WikiPage.new(:wiki => self, :title => Wiki.titleize(title)) | ||
|
r320 | end | ||
# find the page with the given title | ||||
|
r709 | def find_page(title, options = {}) | ||
|
r538 | title = start_page if title.blank? | ||
|
r4316 | title = Wiki.titleize(title).downcase | ||
page = pages.first(:conditions => ["LOWER(title) LIKE ?", title]) | ||||
|
r709 | if !page && !(options[:with_redirect] == false) | ||
# search for a redirect | ||||
|
r4316 | redirect = redirects.first(:conditions => ["LOWER(title) LIKE ?", title]) | ||
|
r709 | page = find_page(redirect.redirects_to, :with_redirect => false) if redirect | ||
end | ||||
page | ||||
|
r320 | end | ||
|
r2051 | # Finds a page by title | ||
# The given string can be of one of the forms: "title" or "project:title" | ||||
# Examples: | ||||
# Wiki.find_page("bar", project => foo) | ||||
# Wiki.find_page("foo:bar") | ||||
def self.find_page(title, options = {}) | ||||
project = options[:project] | ||||
if title.to_s =~ %r{^([^\:]+)\:(.*)$} | ||||
project_identifier, title = $1, $2 | ||||
project = Project.find_by_identifier(project_identifier) || Project.find_by_name(project_identifier) | ||||
end | ||||
if project && project.wiki | ||||
page = project.wiki.find_page(title) | ||||
if page && page.content | ||||
page | ||||
end | ||||
end | ||||
end | ||||
|
r320 | # turn a string into a valid page title | ||
def self.titleize(title) | ||||
# replace spaces with _ and remove unwanted caracters | ||||
|
r637 | title = title.gsub(/\s+/, '_').delete(',./?;|:') if title | ||
|
r320 | # upcase the first letter | ||
|
r794 | title = (title.slice(0..0).upcase + (title.slice(1..-1) || '')) if title | ||
|
r320 | title | ||
end | ||||
end | ||||