A wiki is a collaborative space where you can create and edit content along with other users. Wikis are often used to build knowledge bases but can be used for a range of collaborative activities.
Unlike other activities there are no plugin settings to configure for the wiki activity under Plugins > Activity modules, although you can choose to enable or disable the plugin here.
(The video above is taken from the Glossary and wiki course in the Totara Academy).
Creating a wiki
To create a new wiki follow the steps below on any course you have editing access to.
- Click Turn editing on.
- Select Wiki from the Add an activity menu.
- Customise the available settings as required.
- Click Save and display (or Save and return to course).
- You will then need to choose the format for your first page and click Create page.
You can now start editing the first page.
Creating a page
The first page of your wiki is automatically created during the creation of the wiki (as detailed in the steps above).
To create subsequent pages you will need to follow the advise for adding and linking pages. There is no button to create new pages, instead these are created from within an existing page.
|Wiki name||The name you give to your wiki here will appear as the link on the course page for your Learners to click.||-|
|Wiki description||Explain the purpose of your wiki here.||This description may or may not be compulsory depending on your admin's settings).|
Display description on course page
|If this box is checked, then the description you added above will appear with the wiki link on the course page.||-|
|First page name||The name you add here will form the first page of your new wiki.|
This is a mandatory field, and once you have entered a name it cannot be changed.
|The individual wiki is shared between the user and their Trainer(s)/Editing Trainer(s). It can be used as a journal or note taking area, as it's not visible to other Learners.|
Set the default type of editing your wiki will use. Choose from:
|The most commonly used format is HTML.|
|Force format||If you check this box then Learners cannot choose their own method of editing the wiki.||-|
Common module settings
See Common module settings to learn more.
See Activity Completion to learn more.
See Restrict access to learn more.
See Tags to learn more.
Using a wiki
Once you have created your wiki you can then view, edit, and manage the content within it. When you open a wiki you will notice a number of tabs:
- View: To view the current page
- Edit: To edit the current page
- Comments: To leave comments on the current page
- History: To see changes and compare versions of the current page
- Map: To navigate between pages
- Files: To manage files in the wiki
- Administration: To manage pages
To start editing simply open the wiki and then click the Edit tab and start adding content in the editor. You can add text, images, and multimedia content.
Viewing the wiki
You can only view the wiki one page at a time, so whichever page is selected will be the one that is displayed under the View, Edit, Comment, History, Map, and Administration tabs. You can navigate between pages using either the Map or Administration tabs.
The Map tab shows lists of pages based off various criteria including (but not limited to):
- Contributions: Pages you have edited
- Links: To and from the current page
- Page list: An alphabetical list of all pages
The Administration tab allows you to delete () and edit ( ) pages. By default the current page will be displayed but by clicking List all you can display all pages to make changes to them or navigate to them by clicking on them. You can also delete page versions to revert to an older version of the page.
If you wish to compare versions of a page then this can be done via the History tab.
Adding and linking pages
Once you have created the initial page you can add additional pages by creating links from it.
- Go to an existing page and enter the new page name inside double square brackets e.g. [[new page]].
- Click Save.
- View the original page and click the red link for the new page.
- Confirm the page format and click Create page.
You can now enter content to the new page, remember to click Save when you are done.
You can create a link from any existing page to any other existing page(s) by entering the name of the page(s) you wish to link to in double square brackets e.g. [[existing page]].
If you are linking to multiple pages then they will all need to be added in their own double square brackets e.g. [[existing page 1]] [[existing page 2]]. You do not need to separate multiple pages with commas but you may wish to do this for formatting.
If you enter the name of a page that does not yet exist during this process then you can create it as described above.
To edit a page you will need to navigate to the navigate to a page via the Map tab.
- View the page list on the Map tab.
- Select the page you wish to edit from the list.
- Click the Edit tab to edit that page.
- Click a file to edit, delete or download that particular file.
The Comments tab is used to make comments on the current page. This can be a useful place to discuss any required actions, allocate work, and leave feedback.
- Go to the Comments tab.
- Click Add comment.
- Type your comment.
- Click Save changes.
Once you have added a new comment you can also edit () or delete it ( ) under the Comments tab.
The Files tab allows you to upload, edit, and delete files associated with the wiki. Files can be uploaded directly here or within a page but they are all managed here.
- Within the Files tab click Edit wiki files.
- Here you can do one or more of the following:
- Click the add file button ( ) to add a new file.
- Click the download button ( ) to download all files.
- Click on a file to edit, download, or delete it.
- Once you are done click Save changes.
The Totara Academy has a whole course dedicated to using using the Glossary and wiki in Totara Learn. Here you can learn more on how to use these tools, see best practice, and give it a go yourself.