Will "the Mighty" Strohl

An Introduction to the DNN Wiki Module

I was recently asked to show someone how to use the DotNetNuke® Wiki Module.  While I can usually whip up a demo in seconds and wing it, I was not able to this time.  It had been too long since I had last used it, and was having a brain lapse.  So, I decided to put that demo here, so to speak.  Before I get into it though, I do want to mention that there are some features that are missing and planned to be in future releases.  Chris Hammond is the project lead, and he admittedly is looking for time and contributors to help in continuing the development effort.  Use the Wiki project forum if you’re interested in helping (or need support).

First of all, you need to install the module, as it is not installed by default.  Then, you need to insert an instance of the module on a page.  I am going to assume that you already know how to and have done those two steps.

When you first look at the newly created Wiki module, it will be empty and have some options for you to choose from.

  • Home – returns you to the “home page” of the wiki itself
  • Search – allows you to search the wiki
  • Recent Changes – allows you to review the recent changes to the wiki
  • Index (Show) – allows you to view a listing of all of the wiki pages created
  • Add – allows you to create a new wiki page
  • Edit – allows you to edit the current wiki page
  • View Topic History – allows you to view the history of changes for the current wiki only

DNN Wiki Module - Default View

Adding Pages to the Wiki (Same as Linking)

You can add pages to the wiki two ways.  First, you can click the “Add” link as highlighted above.  The other non-standard way is to simply “link” to the page in your wiki text.  I say “link”, because you don’t actually link to a page like you may be used to.  You instead use a bracketed keyword to link to a page.  For example, if I create or want to create a page named “My Second Page”, I would use the following text in the wiki:  [[My Second Page]].  Notice that all we did was wrap the page name in double-brackets. 

Editing Wiki Text

When we save our wiki text, the bracketed text will appear to be a link.  If we do not already have the page created, the module creates a temporary page with the title until you save text to it.

DNN Wiki Module - Edited (Saved) Page

Enabling Page Comments & Page Ratings

You can allow visitors to leave comments for a wiki page, and also rate the wiki page.  This feature is disabled by default.  You must go into the Module Settings to enable it.  Unlike most modules, this module manages its settings in another view, versus the actual Module Settings.  To get there, you would simply mouse over the actions menu, and click “Administration.”

DNN Wiki Module - Action Menu (Administration)

The Administration page has 3 settings:

  • Use DotNetNuke Security for edit content permissions – when checked, this module functions as you would expect it to. Otherwise, you can manage the content management permissions here.
  • Allow Pages Comments – When checked, this allows visitors to leave comments on the wiki pages (can be overridden on each page).
  • Allow Pages Ratings – When checked, this allows the visitor to rate or rank the page (can be overridden on each page).

DNN Wiki Module - Administration (Settings)

That’s it for your introduction to the module. I hope that this gets you started and builds your confidence to use the DNN Wiki Module.  If you need more help, you can always use the Wiki project forum, or look at the online help for the wiki module.



blog comments powered by Disqus