Class: WikiController

Inherits:
ApplicationController show all
Includes:
AttachmentsHelper, Redmine::Export::PDF
Defined in:
app/controllers/wiki_controller.rb

Overview

The WikiController follows the Rails REST controller pattern but with a few differences

  • index - shows a list of WikiPages grouped by page or date

  • new - not used

  • create - not used

  • show - will also show the form for creating a new wiki page

  • edit - used to edit an existing or new page

  • update - used to save a wiki page update to the database, including new pages

  • destroy - normal

Other member and collection methods are also used

TODO: still being worked on

Since:

  • 0.5.0

Instance Method Summary collapse

Methods included from AttachmentsHelper

#container_attachments_edit_path, #container_attachments_path, #link_to_attachments, #render_api_attachment, #render_api_attachment_attributes, #render_pagination

Methods inherited from ApplicationController

#_include_layout?, accept_api_auth, #accept_api_auth?, accept_rss_auth, #accept_rss_auth?, #api_key_from_request, #api_offset_and_limit, #api_request?, #api_switch_user_from_request, #authorize, #authorize_global, #autologin_cookie_name, #back_url, #check_if_login_required, #check_password_change, #check_project_privacy, #deny_access, #filename_for_content_disposition, #find_attachments, #find_current_user, #find_issue, #find_issues, #find_model_object, #find_optional_project, #find_optional_project_by_id, #find_project, #find_project_by_project_id, #find_project_from_association, #handle_unverified_request, #logged_user=, #logout_user, #missing_template, model_object, #parse_params_for_bulk_update, #parse_qvalues, #per_page_option, #query_statement_invalid, #redirect_back_or_default, #redirect_to_referer_or, #render_403, #render_404, #render_api_errors, #render_api_head, #render_api_ok, #render_attachment_warning_if_needed, #render_error, #render_feed, #render_validation_errors, #require_admin, #require_admin_or_api_request, #require_login, #session_expiration, #session_expired?, #set_localization, #start_user_session, #try_to_autologin, #use_layout, #user_setup, #verify_authenticity_token

Methods included from Redmine::SudoMode::Controller

#process_sudo_form, #render_sudo_form, #require_sudo_mode, #sudo_mode, #sudo_timestamp_valid?, #update_sudo_timestamp!

Methods included from Redmine::MenuManager::MenuController

#current_menu, #current_menu_item, #menu_items, #redirect_to_menu_item, #redirect_to_project_menu_item

Methods included from Redmine::Search::Controller

#default_search_scope, #default_search_scopes

Methods included from RoutesHelper

#_new_project_issue_path, #_new_time_entry_path, #_project_calendar_path, #_project_gantt_path, #_project_issues_path, #_project_news_path, #_report_time_entries_path, #_time_entries_path, #board_path

Methods included from Redmine::Hook::Helper

#call_hook

Methods included from Redmine::Pagination

#paginate, #paginator

Methods included from Redmine::I18n

#current_language, #day_letter, #day_name, #find_language, #format_date, #format_hours, #format_time, #l, #l_hours, #l_hours_short, #l_or_humanize, #languages_options, #ll, #lu, #month_name, #set_language_if_valid, #valid_languages

Instance Method Details

#add_attachmentObject

Since:

  • 0.5.1



328
329
330
331
332
333
# File 'app/controllers/wiki_controller.rb', line 328

def add_attachment
  return render_403 unless editable?
  attachments = Attachment.attach_files(@page, params[:attachments])
  render_attachment_warning_if_needed(@page)
  redirect_to :action => 'show', :id => @page.title, :project_id => @project
end

#annotateObject

Since:

  • 0.7.0



250
251
252
253
# File 'app/controllers/wiki_controller.rb', line 250

def annotate
  @annotate = @page.annotate(params[:version])
  render_404 unless @annotate
end

#date_indexObject

List of page, by last update

Since:

  • 1.1.0



58
59
60
61
# File 'app/controllers/wiki_controller.rb', line 58

def date_index
  load_pages_for_index
  @pages_by_date = @pages.group_by {|p| p.updated_on.to_date}
end

#destroyObject

Removes a wiki page and its history Children can be either set as root pages, removed or reassigned to another parent page

Since:

  • 0.5.1



257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
# File 'app/controllers/wiki_controller.rb', line 257

def destroy
  return render_403 unless editable?

  @descendants_count = @page.descendants.size
  if @descendants_count > 0
    case params[:todo]
    when 'nullify'
      # Nothing to do
    when 'destroy'
      # Removes all its descendants
      @page.descendants.each(&:destroy)
    when 'reassign'
      # Reassign children to another parent page
      reassign_to = @wiki.pages.find_by_id(params[:reassign_to_id].to_i)
      return unless reassign_to
      @page.children.each do |child|
        child.update_attribute(:parent, reassign_to)
      end
    else
      @reassignable_to = @wiki.pages - @page.self_and_descendants
      # display the destroy form if it's a user request
      return unless api_request?
    end
  end
  @page.destroy
  respond_to do |format|
    format.html { redirect_to project_wiki_index_path(@project) }
    format.api { render_api_ok }
  end
end

#destroy_versionObject

Since:

  • 2.2.0



288
289
290
291
292
293
294
295
296
297
# File 'app/controllers/wiki_controller.rb', line 288

def destroy_version
  return render_403 unless editable?

  if content = @page.content.versions.find_by_version(params[:version])
    content.destroy
    redirect_to_referer_or history_project_wiki_page_path(@project, @page.title)
  else
    render_404
  end
end

#diffObject

Since:

  • 0.5.1



245
246
247
248
# File 'app/controllers/wiki_controller.rb', line 245

def diff
  @diff = @page.diff(params[:version], params[:version_from])
  render_404 unless @diff
end

#editObject

edit an existing page or a new one



126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
# File 'app/controllers/wiki_controller.rb', line 126

def edit
  return render_403 unless editable?
  if @page.new_record?
    if params[:parent].present?
      @page.parent = @page.wiki.find_page(params[:parent].to_s)
    end
  end

  @content = @page.content_for_version(params[:version])
  @content ||= WikiContent.new(:page => @page)
  @content.text = initial_page_content(@page) if @content.text.blank?
  # don't keep previous comment
  @content.comments = nil

  # To prevent StaleObjectError exception when reverting to a previous version
  @content.version = @page.content.version if @page.content

  @text = @content.text
  if params[:section].present? && Redmine::WikiFormatting.supports_section_edit?
    @section = params[:section].to_i
    @text, @section_hash = Redmine::WikiFormatting.formatter.new(@text).get_section(@section)
    render_404 if @text.blank?
  end
end

#exportObject

Export wiki to a single pdf or html file

Since:

  • 1.1.0



300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
# File 'app/controllers/wiki_controller.rb', line 300

def export
  @pages = @wiki.pages.
                    order('title').
                    includes([:content, {:attachments => :author}]).
                    to_a
  respond_to do |format|
    format.html {
      export = render_to_string :action => 'export_multiple', :layout => false
      send_data(export, :type => 'text/html', :filename => "wiki.html")
    }
    format.pdf {
      send_file_headers! :type => 'application/pdf', :filename => "#{@project.identifier}.pdf"
    }
  end
end

#historyObject

show page history



231
232
233
234
235
236
237
238
239
240
241
242
243
# File 'app/controllers/wiki_controller.rb', line 231

def history
  @version_count = @page.content.versions.count
  @version_pages = Paginator.new @version_count, per_page_option, params['page']
  # don't load text
  @versions = @page.content.versions.
    select("id, author_id, comments, updated_on, version").
    reorder('version DESC').
    limit(@version_pages.per_page + 1).
    offset(@version_pages.offset).
    to_a

  render :layout => false if request.xhr?
end

#indexObject

List of pages, sorted alphabetically and by parent (hierarchy)



46
47
48
49
50
51
52
53
54
55
# File 'app/controllers/wiki_controller.rb', line 46

def index
  load_pages_for_index

  respond_to do |format|
    format.html {
      @pages_by_parent_id = @pages.group_by(&:parent_id)
    }
    format.api
  end
end

#newObject

Since:

  • 3.3.0



63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# File 'app/controllers/wiki_controller.rb', line 63

def new
  @page = WikiPage.new(:wiki => @wiki, :title => params[:title])
  unless User.current.allowed_to?(:edit_wiki_pages, @project)
    render_403
    return
  end
  if request.post?
    @page.title = '' unless editable?
    @page.validate
    if @page.errors[:title].blank?
      path = project_wiki_page_path(@project, @page.title, :parent => params[:parent])
      respond_to do |format|
        format.html { redirect_to path }
        format.js   { render :js => "window.location = #{path.to_json}" }
      end
    end
  end
end

#previewObject



316
317
318
319
320
321
322
323
324
325
326
# File 'app/controllers/wiki_controller.rb', line 316

def preview
  page = @wiki.find_page(params[:id])
  # page is nil when previewing a new page
  return render_403 unless page.nil? || editable?(page)
  if page
    @attachments += page.attachments
    @previewed = page.content
  end
  @text = params[:content].present? ? params[:content][:text] : params[:text]
  render :partial => 'common/preview'
end

#protectObject

Since:

  • 0.8.0



225
226
227
228
# File 'app/controllers/wiki_controller.rb', line 225

def protect
  @page.update_attribute :protected, params[:protected]
  redirect_to project_wiki_page_path(@project, @page.title)
end

#renameObject

rename a page

Since:

  • 0.6.0



213
214
215
216
217
218
219
220
221
222
223
# File 'app/controllers/wiki_controller.rb', line 213

def rename
  return render_403 unless editable?
  @page.redirect_existing_links = true
  # used to display the *original* title if some AR validation errors occur
  @original_title = @page.pretty_title
  @page.safe_attributes = params[:wiki_page]
  if request.post? && @page.save
    flash[:notice] = l(:notice_successful_update)
    redirect_to project_wiki_page_path(@page.project, @page.title)
  end
end

#showObject

display a page (in editing mode if it doesn't exist)

Since:

  • 1.1.0



83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
# File 'app/controllers/wiki_controller.rb', line 83

def show
  if params[:version] && !User.current.allowed_to?(:view_wiki_edits, @project)
    deny_access
    return
  end
  @content = @page.content_for_version(params[:version])
  if @content.nil?
    if User.current.allowed_to?(:edit_wiki_pages, @project) && editable? && !api_request?
      edit
      render :action => 'edit'
    else
      render_404
    end
    return
  end

  call_hook :controller_wiki_show_before_render, content: @content, format: params[:format]

  if User.current.allowed_to?(:export_wiki_pages, @project)
    if params[:format] == 'pdf'
      send_file_headers! :type => 'application/pdf', :filename => filename_for_content_disposition("#{@page.title}.pdf")
      return
    elsif params[:format] == 'html'
      export = render_to_string :action => 'export', :layout => false
      send_data(export, :type => 'text/html', :filename => filename_for_content_disposition("#{@page.title}.html"))
      return
    elsif params[:format] == 'txt'
      send_data(@content.text, :type => 'text/plain', :filename => filename_for_content_disposition("#{@page.title}.txt"))
      return
    end
  end
  @editable = editable?
  @sections_editable = @editable && User.current.allowed_to?(:edit_wiki_pages, @page.project) &&
    @content.current_version? &&
    Redmine::WikiFormatting.supports_section_edit?

  respond_to do |format|
    format.html
    format.api
  end
end

#updateObject

Creates a new page or updates an existing one

Since:

  • 1.1.0



152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
# File 'app/controllers/wiki_controller.rb', line 152

def update
  return render_403 unless editable?
  was_new_page = @page.new_record?
  @page.safe_attributes = params[:wiki_page]

  @content = @page.content || WikiContent.new(:page => @page)
  content_params = params[:content]
  if content_params.nil? && params[:wiki_page].present?
    content_params = params[:wiki_page].slice(:text, :comments, :version)
  end
  content_params ||= {}

  @content.comments = content_params[:comments]
  @text = content_params[:text]
  if params[:section].present? && Redmine::WikiFormatting.supports_section_edit?
    @section = params[:section].to_i
    @section_hash = params[:section_hash]
    @content.text = Redmine::WikiFormatting.formatter.new(@content.text).update_section(@section, @text, @section_hash)
  else
    @content.version = content_params[:version] if content_params[:version]
    @content.text = @text
  end
  @content.author = User.current

  if @page.save_with_content(@content)
    attachments = Attachment.attach_files(@page, params[:attachments] || (params[:wiki_page] && params[:wiki_page][:uploads]))
    render_attachment_warning_if_needed(@page)
    call_hook(:controller_wiki_edit_after_save, { :params => params, :page => @page})

    respond_to do |format|
      format.html {
        anchor = @section ? "section-#{@section}" : nil
        redirect_to project_wiki_page_path(@project, @page.title, :anchor => anchor)
      }
      format.api {
        if was_new_page
          render :action => 'show', :status => :created, :location => project_wiki_page_path(@project, @page.title)
        else
          render_api_ok
        end
      }
    end
  else
    respond_to do |format|
      format.html { render :action => 'edit' }
      format.api { render_validation_errors(@content) }
    end
  end

rescue ActiveRecord::StaleObjectError, Redmine::WikiFormatting::StaleSectionError
  # Optimistic locking exception
  respond_to do |format|
    format.html {
      flash.now[:error] = l(:notice_locking_conflict)
      render :action => 'edit'
    }
    format.api { render_api_head :conflict }
  end
end