Skip to end of metadata
Go to start of metadata

With a wiki (Hawaiian for quick), much like an online encyclopaedia, you can easily create articles and content and edit them together with other users.

Users like to use the wiki, for example, for the following application scenarios:

  • as a glossary or index of a course
  • as an aid to certain course topics
  • as a discussion forum with advanced features
  • as a publicly accessible repository for all kinds of texts and articles (e.g. to submit tasks)

Within a wiki, each user can create new articles, edit existing articles, link articles with each other, and discuss articles with other users. The articles can be formatted using the wiki syntax (typography, headings, lists, links). It is also possible to insert images, audio files, as well as mathematical formulas in LaTeX format.

Content


Usage: Learners' View

Overview

In the upper area of the wiki, you will find the functions to subscribe to a wiki and to create articles as well as the File management.

The left navigation area shows the wiki menu. The tutor can alter the menu and provide selected articles as quick access. Besides, you have access to all categories in the wiki and the history of your recently viewed articles.

In the middle section, you can see the wiki content. Using the tabs above the page, you can edit the current article, engage in discussions on this article, and view the history.

The tutor can assign various rights for the wiki. The displayed functions and areas depend on these settings.

Wiki areas

Functions for users

As a user, you can use the following functions in a Wiki course element:

You can be assigned extended rights by a course supervisor. These rights will make additional functions, such as creating and editing posts, available to you.

Upper page area

Subscribe

You can subscribe to course elements to get automatically informed about changes.

To subscribe to a course element, proceed as follows:

  1. Open the relevant course and go to the desired course element.
  2. Click the Subscribe button in the upper right corner of the course element view.

Example: Subscribing to a course element File discussion

Subscribe to course element



3. If you have already subscribed to this course element, you will see the button Unsubscribe. Click this button if you want to cancel the subscription.
Unsubscribe button

For further information about the general configuration options for receiving notifications, refer to the page Subscriptions and notifications.

Create article

To create a new wiki article, proceed as follows:
  1. Open the course element Wiki or the relevant wiki resource.
  2. Enter the title of the wiki page to be created in the text field in front of the button Create article.

    Be aware that titles cannot be used twice. In the event of two identical titles, the author will receive a warning from the system.

  3. Click on Create article.

Create wiki article

4. You will automatically be taken to the editing mode of the new wiki page. Now enter the content of the article in the text field.

.

Editing mode of a wiki article

5. To finish off your content, you have several options:

  • Save: Select this button to save your article. You will remain in the editing mode.
  • Save and display: Select this button to save the content of your article and to display it in the user view. You will automatically exit the editing environment.
  • Show preview: Select this button to preview the article from the user's perspective. The current processing status of the article will be displayed below the edit window.
Save your wiki article

File management

The file management allows you to provide images and other files for the entire wiki. The added files can also be accessed by other users and integrated into articles.
Open file management

To open the file management area, click on the File management button in the upper part of the wiki.

Please note that this button will only be visible to you if you have the right to create and edit wiki pages.

The file management area comprises the following functions:

Create and upload files

To create and upload files, proceed as follows:

1

Open the course element Wiki.

 

Open file management
2Click the File management button in the upper right corner.
3

An overview of all included files opens.

 

 

Create file and upload file icon
4Select the create file or upload icon.
5Upload the desired files.
6

The uploaded files are now listed in the file overview.

Uploaded file in the file management
Download files

To download files, proceed as follows:

1

Open the course element Wiki.

Open file management
2Click the File management button in the upper right corner.
3

An overview of all included files opens.

Select files
4Select the files you wish to download by ticking the checkboxes next to them.
5Click on the download icon.Download files
Delete files

To delete files, proceed as follows:

1

Open the course element Wiki.

Open file management
2Click the File management button in the upper right corner.
3

An overview of all included files opens.

 

Select files
4Select the files you wish to delete by ticking the checkboxes next to them.
5

Click on the delete icon.

Delete icon


Navigation pane (on the left):

Index

Displays all linked wiki articles.

From A to Z

Displays all wiki articles in alphabetical order.

Categories

Displays all categories of the opened wiki resource in alphabetical order. Click on a category entry to open a list of all wiki pages that have been assigned to this category.

To open an existing category, proceed as follows:

  1. Open the course element Wiki.
  2. Click on Categories in the navigation on the left.
3. An overview of all categories is displayed. The entries are listed in alphabetical order.Opened categories section
4. Click on a category to view all articles associated with it. The articles are also arranged in alphabetical order.Wiki articles referenced in a category

Last change

Displays a list of your last changed wiki articles. Use the link in the entries to open the respective wiki pages.

Recently viewed

Displays a list of your recently viewed wiki articles. A maximum of five entries will be displayed.


Middle area

Article

This tab displays the content of an article. If you are the author of the article, you will see the button Add artefact on the right. This button allows you to add the article as an artefact to your ePortfolio.

Edit article

This tab opens the editor view of the selected article.

It will only be visible if you have editing rights within the wiki. You can then create new articles in the wiki and edit existing ones.

All edit options are explained on the help page Edit wiki article.

Discussion on a wiki article

A wiki text is usually created by several authors. In the Discussion section, there is a forum for each article, which can be used to exchange comments on the article with other authors.

To start a discussion on an article, proceed as follows:

  1. Open the course element Wiki.
  2. Navigate to the desired article.
  3. Switch to the tab Discussion.
Tab Discussion
4. Now you can add new discussion topics, reply to existing topics, and edit or delete them.Add new discussion topic

 

History

Here you can track the status of the wiki article, compare different versions, and restore a version if necessary.

Open history

To open a history, proceed as follows:

  1. Open the corresponding wiki article.
  2. Switch to the tab History.
Open history
3. A tabular overview pops up listing all existing histories of opened articles.Overview of existing histories

Compare versions

 

To compare two page versions, proceed as follows:

  1. Open the history.
  2. Select the versions to be compared and click on the numbers in the column Comparison. The numbers are representative of the different page versions.

    Example: 2 to 3 provides a comparison between version 2 and 3.

    Below the table, an overview of all differences between the two versions is displayed.

Compare page versions
Restore version

To restore an older page version, proceed as follows:

  1. Open the history.
  2. In the column Version, click on the version of your article you want to restore.
  3. Then confirm the recovery with Restore version.
Restore version

Configuration: Authors' View

Functions in the course editor

The following functions are available to you in the course editor:

Add a course element wiki

To integrate a course element into your course, proceed as follows:
1

Open the course you want to edit.

Use the pencil icon at the top of the page to open the editing mode.

Switch from the course view to the editing mode

2

Select a course element from the menu on the right.

Select course element

3

In the new window, you can define the position of the new course element within your course structure (left navigation pane). The available positions are marked with an insert icon.

To insert the new course element into an existing substructure, you need to open the substructure by clicking on the small triangle symbol next to its title. The area will open and you will again see insert icons at the positions which are available.

Click on the insert icon at the desired position within the structure. The selected area will be highlighted.

Confirm your choice with Insert course element.

Insert course element into the course tree

4

The element will be inserted into the course structure at the selected position.

Depending on the course element, you have to make additional configurations or add content in order to complete the configuration.

For these changes to take effect, you must publish the course. The course element will then also become available in the course view.

Configure and publish course element



General configuration settings

In the course editor, you will find the following configuration tabs:

Title and description

Course editor settings in the tab title and description
ElementsDescription
Title

You need to enter a title for the course element. The title can comprise a maximum of 100 characters. All special characters and numbers are permitted. The title will appear in the navigation menu of the course and also as a heading in the content area.

(warning)  If you change the title of the first course element, the new content will only be applied to the main course node and then displayed in the opened course. If you wish to edit the course title or description, you can do so using the more settings menu of the course.

SubtitleYou can enter a subtitle for the course element with a maximum of 255 characters. All special characters and numbers are permitted. The title will appear as a tooltip in the navigation menu and - if selected and configured accordingly - as a subtitle in the content area.
Description

Here you can describe the course element. The description will appear in the content area below the title.

Depending on the settings configured in the element Display, this additional text is displayed to the user when opening the course element. The user can expand or collapse the view of the text.


Display

Define which information about the course element should be displayed in the course view. In addition to the content, you can optionally display the title and description. All course elements are provided with a reasonable presetting, which mostly includes the setting Title, description and content. You can adjust this setting in accordance with the options available for each course element. For an example of the different setting options, refer to the help page Displaying information about the course element.

Set link for this course element

Each course element can be accessed via fixed link addresses. Therefore, an internal and an external URL is assigned to each course element. These direct links to concrete elements can be used within courses or provided to learners. The URLs are located below the title and description of the element and will appear upon selecting Set link for this course element.  

  • External link: To refer to this course element from outside of the course or learning platform, you can use the external link and insert it, for example as a href attribute, into the desired HTML page.
  • Internal link: To set a link to another course element within the same course, you can insert the internal link as a href attribute into the desired HTML page.
IDYou will need the ID number of the course element (on the bottom right), for example, if you wish to use the expert mode in the visibility or access tab.


Visibility

In the areas Visibility and Access, authors and course owners can individually determine the presentation of course elements. If no input is made in the access area, the content of a course element will by default be visible to all course participants after publishing the element. Apart from the general options listed below, additional configuration options are available depending on the course element.

The following general options are available for the configuration of visibility and access:

Course editor - Tab visibility and access


General configuration optionsDescription
Blocked for learners

If you select this checkbox, all other configuration options will disappear. The course element content is now exclusively accessible for tutors and administrators of the course.

Block access or visibility for learners
Depending on dateMark this checkbox to specify a particular access time. You can set individual dates or date ranges by filling in only one or both input fields respectively. You can also create or delete dates via the + and - buttons.

Set access or visibility rights depending on dates

Depending on group

Select this checkbox to restrict the accessibility of the course element to learning groups or learning areas. You can then select existing groups and areas or create new ones.

If you set restrictions with the configuration option "depending on group", the corresponding course element will be restricted for all non-members of the group. This includes, for example, users who have not yet confirmed the group invitation or who are on the waiting list for a group. Such users cannot yet see or access the restricted course element.


Set access or visibility rights depending on groups

Depending on assessmentHere, you will find all assessable course elements. These include, for example, the elements test, assessment, task, or structure. 

If you select the option Check for "passed", you will be able to choose a course element from the input field Course element, which the user must have passed as a prerequisite to accessing this course element. 

If you select the option Check score, you can indicate a number of points in the input field "Passing score", which have to be achieved in order to be able to access the course element.

Set access or visibility rights depending on assessments

Depending on attribute

The visibility of this option is system-dependent.

Via this option, you can set visibility or access rights according to user attributes. Only users who meet the predefined attributes will be able to see the course element or have access to its content. Multiple attributes need to be linked with an operator (AND/OR).

Different kinds of relational operators might be available depending on the selected attribute. For example:

  • "contains the value"
  • "does not contain value"
  • "has exactly the value"
  • "does not have value"
  • "starts with value"
  • "ends with value"
  • "greater than" (>)
  • "less than" (<)
  • "greater than/equals" (<=)
  • "less than/equals" (>=)

A list of all available attributes of several selected institutions can be found on the page Overview of the OPAL-Shibboleth attributes.

Set access or visibility rights depending on attributes

Apply rules also for author, owner and tutorThis option does not become visible until one of the other options has been selected. If you activate the checkbox, the same access rules which apply to users will also be valid for tutors and course administrators.

Apply rules also for author, owner and tutor

PasswordThis option is only available in the area Access and can either be applied to the whole course or a structural element of the course. Enter the desired password, which users will need to use in order to gain access to the course content, in the text field.

Set access or visibility rights depending on passwords

Display expert modeClick on the button Display expert mode to open an input field, which allows you to perform a more complex configuration according to your needs. For more detailed information about the expert mode, see the help page Publishing within courses (expert mode).
Set access or visibility rights in the expert mode
Advanced configuration optionsIn the case of individual course element types, there are further attributes to configure access to editing rights for course participants.

If various restrictive single options are set, they will be linked with AND, i.e. all conditions of the single options must be met for the user to see and have access to the course element. The only exceptions are the single options Attributes. In this case, various restrictive single options can also be linked with OR. The OR linking only requires the fulfilment of one condition in order to enable visibility or access, unless other restrictive single options prevent this.

All restrictions are also automatically valid for all subordinate course elements.

Note about hiding access restrictions

If a course element is visible, but there are

  • current or future access restrictions or
  • restricted rights for the course element,

the user will be informed accordingly when accessing the course element. This information helps the user to learn more about the functions available, e.g. which functions will be available at what time and under what conditions.

If required, however, you can hide this information text (from the user) for each course element individually.

Notification message about existing access and authorisation restrictions in the course view:

Course element with notification message about authorisation restrictions

1

To hide this message, open the course editor and switch to the Visibility tab of the respective course element.

In the section Information if course node is visible but not accessible (max. 248 characters), remove the check mark in front of the entry Show access restrictions below the text field.

Publish your changes.

Course editor setting to hide notification message

2

The note will no longer be visible in the course view.

Course element without notification message about authorisation restrictions


For individual course element types, there are further attributes which can be used to regulate access to editing rights for course participants.

The following editing rights can be restricted or extended using the general configuration attributes (depending on date, group, etc.):

Task
  • Assignment
  • Edit task folder  
  • Drop box - Delete own solutions
  • Drop box  
  • Return box
  • Assessment
  • Sample solution
Blog
  • Read  
  • Read and write
  • Moderate
File Dialogue
  • Only file download / read in the forum  
  • File up- and download/ read and write in the forum
  • Edit or delete files / Moderate in the forum
Forum
  • Read  
  • Read and write
  • Moderate
Calendar
  • Read  
  • Add and edit dates
Link List
  • Display  
  • Display and add
  • Display, edit, and delete
Bibliography
  • Display  
  • Display and edit
Messages
  • Read
  • Write
  • Manage
Folder
  • Download
  • Upload
  • Delete
Podcast
  • Read  
  • Read and write
  • Moderate
Page
  • Display  
  • Display and edit
Profile
  • Display
  • Add
Test

Configurable in the tab Visibility :

  • Conduct test
  • View assessment
  • View results
Wiki
  • Read  
  • Add and edit articles

Access
Wiki learning contentIn this tab, you can select, create, and import wiki resources. Detailed instructions are given in the following section.
MultilingualismIn this tab, different translations can be added to individual course element areas.

Special configuration settings

In the tab Wiki learning content, you can assign a wiki resource to your course element. Choose one of the three options:

  • use an existing Wiki learning resource (option 1),
  • create and use a new Wiki learning resource (option 2), or
  • import a new Wiki learning resource (option 3).


1.

Switch to the Wiki learning content tab and click on Choose, create or import Wiki.

Choose, create or import Wiki button
2.

A page with functions to create and import new wiki resources and a list of your existing wiki resources will open.

Decide on one of the following options:

Three options
3a

(Option 1:)

To use an existing Wiki learning resource, click on the plus icon next to the desired resource in the Actions column.

Select wiki
3b

(Option 2:)

To create and use a new Wiki learning resource, click on Create. A page for creating a new learning resource will open.

  • Enter a title for the new resource and add a description if necessary.
  • Click on Save.
  • As a next step, you can add an image to the resource using Upload.
  • Click on Finish to complete the creation process.

The newly created resource will now automatically be used as a resource for the wiki course element and displayed under Selected Wiki.

Create wiki
3c

(Option 3:)

To import a new Wiki learning resource, click on Import. The system's default upload page will open.

Select a location for the file you wish to import and upload the file.

  • The page for creating a new learning resource will open.
  • Enter a title for the imported resource and add a description if necessary.
  • Click on Save.
  • As a next step, you can add an image to the resource using Upload.
  • Click on Finish to complete the creation process.


Import wiki

4.

5.

The newly imported resource will now automatically be used as a resource for the wiki course element and displayed under Selected Wiki.  

Publish your course to complete the configuration and to make the resource available to participants.

Selected wiki

Functions after adding a wiki resource

To detailed view

Use this button to switch to the detailed view of the added wiki resource. Among other things, you will find information on the supervisors and access rights in this area.

Functions after adding a wiki resource
Replace wiki

Click the button to replace the added wiki resource with another wiki resource. The same window will open as in the upper section Special configuration settings. Now you have the same three options as described above to add a new wiki resource.

Edit

Click this button to get an overview of all existing wiki entries. You can then create new entries, edit existing entries, and delete entries.

Using this button will still open the edit view of the old interface. All of these functions can also be used in the course view of the course element or in the individual resource view of the wiki resource.

In the course view

Information on the functions in the course view can be found here: Functions for users

As a course supervisor, you can assign extended rights for a course element's additional editing functions to individual or even all course users. These rights can be configured in the tab Access. Further information can be found in the section General configuration settings on this page.