4.2.3. General¶
The artefacts in this tab are of a general nature or do not fit into any other category and can be used around the site.
When you create a page in a group, you do not have the plans block available as you cannot create plans in groups. Additionally, you can choose the following blocks when you edit the group homepage:
4.2.3.1. Annotation¶
Add a block to your page which lets you add an annotation for your page.
Note
This feature is used in conjunction with SmartEvidence.
4.2.3.1.1. Write an annotation¶
Block title: The block title is set automatically based on the standard selected. It takes the form of ‘Annotation: Shortname of the standard’ and cannot be changed.
Annotation: Write your annotation for your portfolio page. The annotation helps connect the evidence on the page to the standard or competency you selected to associate it with in the competency framework.
Note
Once you saved an annotation, you cannot change it any more. You can still add changes as part of the feedback functionality. There is a wishlist item to make it possible to update an annotation as long as it hasn’t received any feedback or the assessment status has changed.
Allow feedback: When you allow feedback on your annotation, others can leave feedback as usual. However, as soon as the first feedback has been added, you will not be able to make changes to your annotation text any more. That is to ensure that the feedback still relates back to the annotation.
Tags: Enter tags to find your annotation more easily at a later stage. Separate your tags with commas. If you already have tags, you can click on the link Show my tags and select the ones that you think will fit for this collection as well. They will be entered into the text field for you.
Standard: When you place the Annotation block on the page, you can select the standard with which the page shall be associated based on the SmartEvidence framework selected for the collection. You can change the standard until somebody leaves feedback or makes an assessment. If you select the page from the SmartEvidence overview page, the standard is pre-selected and cannot be changed.
Note
You can use the Annotation block without SmartEvidence, but then you can’t choose a competency standard.
The description of the selected standard is displayed so you can reference it.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.1.2. Respond to an annotation on the SmartEvidence map¶
When you have access to a collection that contains a SmartEvidence map, you can leave feedback on an annotation. You may be able to assess it if you have staff or institution administrator permissions in the same institution as the portfolio author unless it is a self-assessment framework.
Click the annotation on the SmartEvidence map that you wish to take a closer look at. A modal window opens with the annotation. There are four different icons that indicate the current assessment:
: The author connected this page to this standard.
: This page does not meet this standard.
: This page partially meets this standard.
: This page meets this standard.
Read the annotation.
Place feedback: You can leave feedback on the annotation.
Make public: Decide whether everybody who has access to the page can view your feedback or just the portfolio author.
Click the Place feedback button to add your feedback to the annotation.
If an assessment was already made, you can see it here. This also serves as log of the assessment changes throughout the lifetime of the annotation.
You can view the feedback of others.
Assessment: If you have the permission to assess the standard, you see a drop-down menu here with the possible statuses that you can use. Select one of them.
Note
The assessment statuses are defined in the SmartEvidence framework and can use different terms. The icons are defined in the code.
Click the Save button to keep your selection or click Cancel to abort the assessment.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.1.3. Respond to an annotation on a page¶
You can provide feedback to an annotation, and assess it if you have the appropriate permission, also from the portfolio page on which the annotation is placed.
Click the Place feedback link at the bottom of the Annotation block.
Write your feedback.
Assessment: If you have the permission to assess the standard, you see a drop-down menu with the possible statuses that you can use. Select one of them.
Note
The assessment statuses are defined in the SmartEvidence framework.
Make public: Decide whether everybody who has access to the page can view your feedback or just the portfolio author.
Click the Place feedback button to add your feedback to the annotation or click Cancel to abort the assessment.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.1.4. Delete an annotation¶
When you delete an annotation, all its feedback is deleted as well. You cannot retrieve it again.
4.2.3.2. Checkpoint¶
You can use the ‘Checkpoint’ block on an activity page in the outcomes portfolio.
4.2.3.2.1. Add a ‘Checkpoint’ block to a page¶
The block itself does not have much of a configuration as the configuration for the achievement levels tha can be selected, is done on the page level to avoid having to configure the levels for each block that is added to an activity page.
The title of the checkpoint block is automatically enumerated to ensure consistency in the numbering.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.2.2. View a ‘Checkpoint’ block as group member¶
As group member, i.e. learner, who completes an outcomes portfolio, you can add comments to track your progress. However, only group tutors and group administrators can mark a checkpoint as achieved.
The title of the checkpoint is numbered automatically. If you re-arrange your blocks on the page, the numbering won’t change. Only when you delete a checkpoint will follow-on checkpoint blocks be re-numbered.
Click Add checkpoint comment to add a comment to your checkpoint.
Note
You can still add comments after a checkpoint has been marked as achieved.
The person who left a comment is displayed with their profile picture, name, the time they left the comment, and the comment itself.
Click the Edit button to update your comment. You can do so for 10 minutes or until another comment is left, whichever happens first.
Note
Only group tutors or administratos can delete a checkpoint comment.
When a group tutor or administrator marked the checkpoint as achieved, you see the achievement level that they assigned it. Click the Help icon to find out what the level means.
When the checkpoint has not yet been marked as achieved, you don’t see a level selected.
4.2.3.2.3. View a ‘Checkpoint’ block as group tutor or administrator¶
As group tutor and group administrator, you can add comments to a checkpoint as well to provide your own commentary on the progress that the learner is making.
The title of the checkpoint is numbered automatically. If you re-arrange your blocks on the page, the numbering won’t change. Only when you delete a checkpoint will follow-on checkpoint blocks be re-numbered.
Click Add checkpoint comment to add a comment to your checkpoint.
Note
You can still add comments after a checkpoint has been marked as achieved.
The person who left a comment is displayed with their profile picture, name, the time they left the comment, and the comment itself.
Click the Edit button to update your comment. You can do so for 10 minutes or until another comment is left, whichever happens first.
Click the Delete button on any comment if you want to remove it. A notification is sent to the person who left the comment along with the comment text.
Select the achievement level from the drop-down menu. Click the Help icon for the long descriptions of the levels.
Click the Save button to mark a checkpoint as achieved.
Note
You can still add comments to a completed checkpoint.
Once you marked a checkpoint as achieved, you cannot change it back to mark it as not achieved.
4.2.3.4. Course information¶
The Course information block requires a connection to an LMS to pull relevant information.
4.2.3.5. CPD¶
4.2.3.5.1. Add a CPD block¶
Display a list of your continuing professional development activities.
Block title: Choose a title for your block.
Display activities tagged with: Select one or more tags
From: Pick a date with the help of the calendar to restrict the activities that are to be displayed to a start date on or after the selected date.
To: Pick a date with the help of the calendar to restrict the activities that are to be displayed to an activity start date on or before the selected date.
Sort order: Sort the activities according to the start date either in ascending or descending order.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.5.2. Add and edit CPD activities in ‘Edit mode’¶
You can add and edit your CPD activities directly from your portfolio page, either in ‘Edit mode’ or in ‘Details mode’.
In ‘Edit mode’ you have all editing options available, including moving the block elsewhere on the page.
If you limited the list of your activities by tags and / or dates, the filter criteria are displayed.
Click the Add button to add a new CPD activity. You are taken to the CPD activity creation screen. You are returned automatically to this page when you saved your activity.
The title of your activity, the date of the activity, and the number of hours you spent on the activity are displayed by default.
Click the Edit button to update your activity.
Click the little arrow to show or hide details of the activity.
The details of the activity are the activity description, location, and tags.
Click the Delete button to remove an activity. You are asked to confirm your action.
The total number of hours for all activities with the current filter criteria is displayed.
The number of activities is displayed.
Note
If you had more than 10 activities, a paginator is displayed so you can go through your activities without scrolling much.
4.2.3.5.3. Add and edit CPD activities in ‘Edit mode’¶
You can add and edit your CPD activities directly from your portfolio page, either in ‘Edit mode’ or in ‘Details mode’.
In ‘Details mode’ you have all CPD activity editing options available but cannot move the block.
Click the Details mode button . All blocks that can be edited in this mode and / or can be commented on receive a black bar with the options displayed.
Click the Quick edit option to change the CPD block configuration, including title and filter restrictions.
If you limited the list of your activities by tags and / or dates, the filter criteria are displayed.
Click the Add button to add a new CPD activity. You are taken to the CPD activity creation screen. You are returned automatically to this page when you saved your activity.
The title of your activity, the date of the activity, and the number of hours you spent on the activity are displayed by default.
Click the Edit button to update your activity.
Click the little arrow to show or hide details of the activity.
The details of the activity are the activity description, location, and tags.
Click the Delete button to remove an activity. You are asked to confirm your action.
The total number of hours for all activities with the current filter criteria is displayed.
The number of activities is displayed.
4.2.3.6. Creative Commons license¶
Add a block to your page which lets viewers know under which Creative Commons license your page is published.
Block title: Choose a title for your block.
Allow commercial uses of your work? Decide whether viewers can re-use your work for commercial purposes.
Allow modifications of your work? Decide whether others can remix your work and create something new and if so under which conditions.
License version: Select under which Creative Commons license you wish to publish your work. You can choose between
Creative Commons 3.0
Creative Commons 4.0
See also
Check out what is new in Creative Commons 4.0, and why you may want to choose that license.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.7. Group info¶
This block is a default block on the group homepage. There is no configuration possible.
Note
This block can only be used on a group homepage.
The block contains information about:
Description of the group
Group creation date
Type of group
Group category if any was chosen
Dates between which regular group members can participate in group activities. This information is only visible if any dates were entered in the group settings.
Group statistics
number of group members
number of pages created in the group
number of files uploaded to the group
number of folders created in the group
number of forums created in the group
number of forum topics created in the group
number of posts in forum topics in the group
Group administrators
4.2.3.8. Group members¶
This block is a default block on the group homepage. You can display member profile pictures and their names.
Note
This block can only be used on a group homepage.
Block title: The automatic title for this block is ‘Members’. You can set another one if you wish.
Shown members: Choose how many members (between 1 and 100) are shown on the group homepage. All others are accessible via the Members tab in the group. The default number of members displayed is 12.
Order: Choose the order in which members are displayed. Options are
Latest: Display members according to their group joining date in reverse chronological order.
Random: Let Mahara decide which members to display.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.9. Group portfolios¶
This block is a default block on the group homepage. You can display pages and collections created in and / or shared with the group in this block.
Note
This block can only be used on a group homepage.
Block title: The automatic title for this block is ‘Group portfolios’. You can set another one if you wish.
Display group portfolios: Decide whether to display pages and collections that were created in the group. ‘Yes’ is the default option.
Sort group portfolios by: Choose in which order to display portfolios created in the group. ‘Alphabetical’ is the default option, but you can also display them based on when they were last updated or when they were created.
Display shared pages: Decide whether to display pages that people shared with the group. Pages that are in collections are not displayed. The options are:
None: No shared pages are displayed.
By members of this group: Display only pages that have been shared by members of the group.
Note
This option is particularly well-suited for groups that are used for class purposes. That way, students can share their pages or collections with the group for a long time, but the administrator can choose to display only pages of group members but not those that are not members any more. The pages of non-group members are still accessible via the Shared with me functionality.
By anybody: Display all pages that have been shared with the group.
Display shared collections: Decide whether to display collections that people shared with the group. The options are:
None: No shared collections are displayed.
By members of this group: Display only collections that have been shared by members of the group.
By anybody: Display all collections that have been shared with the group.
Note
Submitted pages are not displayed in the section of ‘Shared pages’ and ‘Shared collections’ to avoid confusion whether they have been shared with the group or not.
Sort shared portfolios by: Choose in which order to display pages and collections shared with the group: * Alphabetical is the default option * Most recently updated * Most recently updated content: Sort by most recent content update * Most recently shared: Sort by sharing date
Display submitted portfolios: Decide whether to display pages and collections that group members submitted to the group. There is no distinction made between pages and collections. ‘Yes’ is the default option.
Note
When you choose this option, you also see which regular members have not yet submitted a portfolio to the group. This is helpful in particular in large groups with lots of portfolio submissions.
Group tutors and group administrators are not displayed though as they are not expected to submit portfolios.
Sort submitted portfolios by: Choose in which order to display pages and collections submitted to the group. ‘Alphabetical’ is the default option, but you can also display them based on when they were last updated.
Entries per page: Choose the maximum number of pages or collections you wish to see on the group homepage for the above before a paginator is displayed. You can display a maximum of 100 items per category.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
Note
A page is considered as modified when the content of at least one block is updated, including the adding of a new Mahara journal entry into the journal block.
4.2.3.10. Inbox¶
The Inbox block displays the latest messages that you have received.
Note
This block can only be used on your dashboard.
Block title: The automatic title for this block is ‘Inbox’. You can set another one if you wish.
Message types to display: Change the switch to ‘Yes’ for each message type that you want to display in this block.
Administration messages: If you are an institution or site administrator, you see this option. All administration messages such as for objectionable content, virus upload, contact, etc. are grouped in ‘Administration messages’.
Maximum number of items to display: Decide how many messages shall be shown on your dashboard. You can choose between 1 and 100.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
If you set your notification preferences to ‘Inbox’ for certain notification types, you can see quickly which messages you have not read in the Inbox block. They are marked in bold.
Note
If you set your notification preferences to ‘Email’ or ‘Email digest’ for certain types, they are set to being read automatically because it is assumed that you have seen them in your emails already and thus don’t need to review them again.
4.2.3.13. Note¶
Add a note to your page. This feature is used when you do not want to keep the text in a journal, but still want to be able to re-use the text on other pages.
4.2.3.13.1. Add a new note¶
Block title: Provide a title for your note.
Block content: Write your text. You can include formatting, external images etc.
Alternatively, you can also use text from another note that you have already written. Click the Use content from another note button to do so.
License: You see this drop-down menu if the site administrator turned on license metadata. Additionally, if you are in an institution, your institution administrator may require you to provide a license. Your default license is displayed. You can set your default license in your account settings. You may choose a different license for each individual artefact.
Advanced licensing: If you can / must enter license information, you can also provide information about the original licensor and a URL where the original can be found.
Allow comments: Switch this setting to ‘No’ if you do not want others to comment on your note. This option is set to ‘Yes’ by default.
Tags: Enter tags to find your note more easily at a later stage. You can choose from your existing tags by starting to type a letter and then selecting the tag you want to use. You can also type a new tag, and it is added to your list of tags.
See also
You can find more information on how to use the tag selector in the ‘Tags’ section.
Attachments: Attach a file to a note as additional evidence for the text you are writing.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.13.2. Add an image into a note¶
Note
Please refer to the section ‘Insert an image into text’ for more information.
4.2.3.13.3. Attach a file to a note¶
Click the Attachments panel if you wish to add one or more files to a note.
Files area: Choose from which files area you would like to select a file:
My files: You see all the folders and files that you have created.
Group files: You see all the folders and files that you are allowed to publish.
Institution files: If you are an institution administrator, you will see institution folders and files.
Site files: If you are a site administrator, you will see all site folders and files. Otherwise, you can only see the ones that are in the folder public in the Site files.
License information: You see these fields if the site administrator turned on license metadata. Additionally, if you are in an institution, your institution administrator may require you to provide a license.
License: Your default license is displayed. You can set your default license in your account settings. You may choose a different license for each individual artefact.
Licensor: If you are uploading a file that somebody else created, you can attribute the work to them here and provide their name for example.
Original URL: If you are uploading somebody else’s file, provide a link to the original Internet address so that others can go there and view the original file.
If the site administrator turned on the image resizing option, you can decide whether you want to have your images resized if they are larger than the specified dimensions. This option is recommended to save space in your portfolio.
File: You do not have to go back to your Files area in Create in order to upload a file. You can do so directly from this screen.
Folder path: The breadcrumbs show in which folder you are currently.
Click the Edit button to change any component of a folder or file, i.e. its name, description and tags. If you have a folder or file included in a page that you submitted for feedback, you will not be able to edit them.
Note
You can also still select files that have been submitted in another portfolio page.
Click into the row that contains the file you wish to display in the block to select it.
Warning
When you place group, institution or site files into a page, beware that these files may not be available at some point any more when the person in charge deletes them.
Click Remove if you want to revert your selection.
Continue editing your note and save it.
4.2.3.13.4. Re-use text from an existing note¶
You can re-use text from other note from one page in another without having to copy the page first.
Warning
If you do not make a copy of the note content in the block configuration and change it, the text is changed in all other instances where this note is used.
Click the button Use content from another note to view all notes to which you have access. These can be:
your own notes
notes from group pages that you can copy
notes from institution or site pages to which you have access
Click Browse or Search to find the note that you want to re-use.
Note
The search is performed in the title, description, and tags.
Click the Manage all note content link to be taken to your personal Notes if you can’t find what you are looking for.
All notes are listed with their title and the first line. If a note does not belong to you but for example to a group, you see the author next to the note’s title.
Use the paginator to move between your notes if more than 5 are displayed.
You see the number of notes that you have access to.
Click the radio button in front of a note that you want to use in this page.
The content of the note that you have selected is displayed in the Block content area. You cannot make any changes at this stage unless you…
change the switch Edit all copies of this note to ‘Yes’. Only then do you see the note content as editable text. This step is necessary so you make a conscious decision about changing the text in all instances where the block is displayed.
If you wish to make changes to the note, but do not want to change it everywhere else, click the Make a copy link above the Block content. The text is then retained, but it is treated like a new note, and the original note is not changed.
Block title: Review the block title and make changes if necessary. Once you copied a note, the original block title is entered here.
Note
You can change the block title no matter whether you change the content of the note or not.
All other functionality that you see on the screen is the same as for adding a new note.
When you open a note that is used on a page that is currently submitted, you cannot make changes to it but must copy it if you want to change the text.
4.2.3.14. Peer assessment¶
Allow peer reviewers to give feedback. There are two options:
Blind feedback: The peer reviewer can see block headings, but not the content in the blocks themselves. If the portfolio consists of multiple pages, and one of them does not contain a peer block, the peer reviewer does not see the page content at all.
Note
If the page is in a collection that contains pages that don’t have the peer assessment block, the peer assessor doesn’t see any content on those pages but the notice ‘You cannot see the content on this page because it does not require a peer assessment.’
Open feedback: The peer assessor can see the entire content of the portfolio.
The type of feedback depends on the institution setting ‘Allow peers to see portfolio content’.
4.2.3.14.1. Add the peer assessment block to a page¶
You can place this block onto a page multiple times so that a peer can give feedback for different sections.
Note
You must give a person the ‘Peer’ role when sharing the portfolio page for them to be able to add their assessment.
Block title: The title that you want to give this particular block.
Instructions: Provide instructions for the peer reviewer to help them with their assessment.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.14.2. Set up a peer assessor¶
You can give someone the peer assessment permissions on the Edit access screen of your portfolio page.
In the Share with drop-down menu, select ‘Person’ under ‘Search for…’.
In the second drop-down menu that becomes available, type the name of the person who shall be the peer assessor and select them.
In the third drop-down menu, select the ‘Peer’ option. You can also select the ‘Peer and manager’ option if the peer is also the manager and can verify the page in the end.
Note
If a peer is also a manager, they can always see the content of a portfolio, no matter whether someone with only the ‘Peer’ role cannot as they need to see the content as a manager.
Click the Save button to keep your selection or click the Cancel link to abort your changes.
4.2.3.14.3. Add a peer assessment¶
When you are the peer assessor on someone’s portfolio, and a page contains a peer assessment block, you can add your assessment by clicking the Add peer assessment link.
Note
An alert is displayed when the page was already signed off. In that case, peers cannot add a peer assessment any more and need to contact the portfolio author to have the sign-off revoked.
Click the Instructions link to view the instructions for the peer assessment.
Write your peer assessment.
Click the Save draft button if you are not yet ready for the portfolio author to view your assessment, and you want to save a draft status.
Click the Publish button when you finished your assessment, and the portfolio author can view it. A notification is also sent to the portfolio author.
Note
If the peer assessment block is used in conjunction with the sign-off functionality, the portfolio author must sign off the page before anybody other than themselves and the peer assessor can see published peer assessments.
Click Cancel if you do not want to save any of your changes.
4.2.3.14.4. View a peer assessment¶
If a peer assessment is in draft mode, only the peer assessor can see it. Once it’s published, others can view it as well.
Click the Add peer assessment link if you want to add (another) peer assessment when you cannot edit an earlier one in the same block any more.
The profile picture and name of the peer assessor are displayed along with the date and time when the peer assessment was made.
The peer assessment is displayed.
The Edit button is only displayed to the peer assessor for 10 minutes after publishing the assessment in case there are last minute changes they want to make.
The Delete button is only shown to the peer assessor, and they can delete their assessment at any point. If they do, the portfolio author receives an email about that with the text of the assessment included.
4.2.3.15. Plans¶
Display your plans in a block.
Note
You must create at least one plan in order to use this block.
Block title: The title of the plan is chosen automatically unless you provide a different one.
Plans to show: Choose the plan or plans which you want to display in your page.
Tasks to display: Decide how many tasks you want to display for each plan before a paginator is displayed.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.16. Portfolio review¶
This block type is only available when an institution allowed the use of the portfolio completion page as it is the only page where this block can appear. It allows a reviewer to make an overall statement or statements for the entire portfolio.
4.2.3.16.1. Configure the portfolio review block¶
The block is highly configurable and can be used with reviewers whom portfolio authors shall know and also those where the portfolio author shall not know who confirmed a statement or left a comment, e.g. in the cause of portfolio moderation or an audit. You can place multiple instances of the block onto a portfolio completion page and assign them to different roles to allow different people to confirm statements.
If the block is on a template that is copied to the portfolio author, the portfolio author will not see the content of a portfolio review block until its content has been confirmed by a reviewer. This allows for audit blocks to be placed on a page but not seen by the majority of portfolio authors when only a small number of portfolios is audited.
You can confirm a statement in three different ways:
Tick a box in a pre-set statement.
Add your own comment.
Confirm a pre-set statement and add your own comment.
The template creator decides which is available.
Block title: Add a title for your block.
Primary statement: Decide whether this block shall be a primary statement. It will be set apart from other review blocks by a different colour. Only one review block on a portfolio completion page can be a primary statement.
Statement text: Add the text that a reviewer has to confirm as part of their review. The reviewer cannot change that text. They can confirm it by checking a box next to the statement.
Add review comment: Allow the reviewer to write their own comment as part of the review. This can stand alone, e.g. as moderation or audit comment, or used in conjunction with the ‘Statement text’. If it is used with a pre-set statement, the statement does not have a checkbox, but adding the comment will approve it.
Display name of reviewer: When a statement is made, it is time stamped. It can also contain the name of the reviewer if that shall be known. Alternatively, you can keep it anonymous.
Available to: Decide which role(s) can confirm the statement. If you do not select at least one role, anybody who has access to the portfolio can confirm the statement.
Note
The role Reviewer was created for this functionality. It is tied to the reports in the administration area for the primary statement. However, you can assign other roles to narrow down who can confirm a statement or write a comment.
Availability date: Select a date after which a reviewer can confirm a statement. Before then, they can view the portfolio and comment on individual pages and artefacts, but they won’t be able to confirm a statement or leave a review comment.
Lock portfolio: Decide whether the portfolio shall be locked from editing once a particular statement was confirmed. The portfolio will stay locked for six months.
Note
When a reviewer asks to have their statement reset, and it is the last statement that locks the portfolio, the portfolio will be unlocked, and the portfolio author can continue editing it.
Notification to author: The portfolio author can be notified when a statement has been confirmed. The notification contains the statement itself.
Reset statement: Decide which role(s) can reset a statement when the reviewer requests this. The person who can reset a statement receives temporary access to the portfolio to reset the status of the statement and then loses it automatically once they performed that action. The portfolio author and the reviewer both receive a notification when a statement was reset.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.16.2. Confirm a statement¶
You can confirm a standard or a primary statement if the template allows you to do so.
If you are allowed to confirm a statement, you will see a checkbox and can click it. This action may lock the portfolio from editing. Read the information in the modal that is displayed carefully, especially when you think the portfolio author still needs to make changes.
4.2.3.16.3. Add a review comment¶
You can add your own comment if the template allows you to do so.
Write your comment in to the text box. You can use formatting options.
Click the Save draft button to save your comment as draft if you haven’t finished it yet and want to look it over or complete later on. The portfolio author cannot see that comment.
Click the Publish button to make your comment visible to others once you are finished. The portfolio author and others who have access to the portfolio can see it.
Click the Cancel link if you want to abort your changes.
4.2.3.16.4. Confirm a statement and add a review comment¶
You may see a pre-set statement and also have the ability to add your own comment. If that is the case, you cannot tick the box next to the pre-set statement. Your comment is the confirmation of that statement.
The pre-set statement is visible to you.
Write your comment in to the text box. You can use formatting options.
Click the Save draft button to save your comment as draft if you haven’t finished it yet and want to look it over or complete later on. The portfolio author cannot see that comment.
Click the Publish button to make your comment visible to others once you are finished. The portfolio author and others who have access to the portfolio can see it.
Click the Cancel link if you want to abort your changes.
4.2.3.16.5. Reset a statement¶
If you need to make a change to a comment that you published or the portfolio author still needs to add some content, you can ask to have your statement reset if the template creator allowed for that.
As reviewer, click the More options button on the portfolio completion page.
Follow the link Reset statement.
A modal is displayed in which you can request to have one or more statements reset.
My statements: Select the statement you want to have reset. You only see statements to which you have access. If you want to reset more than one statement, fill in the form for each statement.
Reason for resetting the statement: Provide a reason for the person whom you ask to reset your statement. They receive that in a notification.
Click the Request reset button to send the notification.
4.2.3.17. Recent forum posts¶
Display a specified number of recent forum posts from one group on a page.
Note
You must be a member of at least one group in order to use this block.
Block title: The title of the block is generated automatically unless you provide a different one. The default title is ‘Recent forum posts’.
Group: Choose the group whose forum posts you wish to display.
Maximum number of posts to show: Decide how many of the latest forum posts you wish to show. The default value is 5. You can show up to 100 posts.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.18. Sign-off¶
See also
The sign-off and verification functionality was moved to the page settings. This ensures that the sign-off and verification icons are always placed at the top right of a page and can’t be moved accidentally.
4.2.3.19. Text¶
4.2.3.19.1. Add a ‘Text’ block¶
Add text to your page. This feature is used when you want to put a snippet of text onto a page that does not have to be re-used.
Block title: Provide a title for your text.
Instructions: Click the link to view the text box for the instructions that you can add to this block.
Note
The Text and Peer assessment blocks are the only ones that can have instructions built into the block at the moment.
You can use full formatting, images, etc. in your instructions.
Block content: Write your text. You can include full formatting.
Tags: Enter tags for this block to find this content more easily. The tags are displayed as part of the page tags.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading only automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click Cancel to leave the block’s content as it is. Remove is shown only when you place the block into the page for the first time.
You can also click the Close button in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
See also
Please refer to the section ‘Insert an image into text’ for more information on adding an image to the text block.
4.2.3.19.2. View the ‘Text’ block¶
Click Instructions to expand or collapse the instructions for this block.
The instructions are displayed in a grey box to differentiate them from the regular text.
View the content of the block.
4.2.3.19.3. Quick edit a ‘Text’ block¶
The Quick edit functionality allows you to update an existing Text block directly from the page without needing to enter the Edit mode of the page. This helps prevent accidental size changes or deletions of that block and allows you to focus on updating the text.
Click the Details button .
The Quick edit bar
Click the Quick edit bar to display the block configuration screen. You can make any changes that you wish to make.
4.2.3.20. Watched pages¶
The Watched pages block displays the pages that are either on your watchlist or belong to your friends and you have access to them.
Note
You can only use this block on your dashboard.
4.2.3.20.1. Pages on my watchlist¶
If you want pages to be displayed, you need to add them to it first by clicking the More options button on a page and then add the page to your watchlist.
Block title: The automatic title for this block is ‘Watched pages’. You can set another one if you wish.
Select to display Pages on my watchlist.
Items to show: Decide how many pages shall be shown on your dashboard. You can choose between 1 and 100.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading without the block content automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click the Cancel button to leave the block’s content as it is. The Remove button is shown only when you place the block into the page for the first time.
You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
View your watchlist on your dashboard.
Title of the block.
Note
If you chose a retractable option, you can click on the title or anywhere in the title space to change the block’s behaviour.
Title of the watched page. You can click the link to be taken to her.
View the page owner and the date when the page was last updated. This is in particular important information when all your watched pages have the same or a similar title.
4.2.3.20.2. Activities of my friends¶
If you have friends on Mahara, then you can use this block to display their portfolios when they have shared them with you:
personally
as a member of a group
as an institution member
as a registered person
publicly
Block title: The automatic title for this block is ‘Watched pages’. You can set another one if you wish.
Select to display Activities of my friends.
Click Additional filters and settings to make additional changes.
Filter by time: You can select the time period over which you want to see changes. Your options are:
Last week
Last month
Last 2 months
Last 3 months
Last 6 months
Last year
Since last login
Order by: Decide how the portfolios are to be ordered. Your choices are:
Reverse chronological order: Display the latest changes first
Page owner: Display all pages by their owner with the one having made changes last first.
Items to show: Decide how many pages shall be shown on your dashboard. You can choose between 1 and 100.
Retractable: Choose whether you want to allow viewers to reduce the block to its heading on a page or see just the heading without the block content automatically. The options are:
No: The block and its content is displayed at all times.
Yes: Allow viewers to reduce the block to just the heading by clicking the Retractable icon .
Automatically retract: Only the heading of the block is visible, and the viewer can click the Retracted icon to view its content.
Click the Save button to accept your changes, or click the Cancel button to leave the block’s content as it is. The Remove button is shown only when you place the block into the page for the first time.
You can also click the Close button in the top right-hand corner to either remove a newly created block before it is being saved or to cancel any changes and leave the block’s content as it is.
4.2.3.3. Comments¶
You can move the comments section from the bottom of a page elsewhere onto your page to integrate it better with your page content. Please note the following:
There is no configuration possible for this block.
You only see comments when you display a page, but not in edit mode.
You can only place 1 comment block onto a page.
Comments for individual artefacts is still placed at the bottom of the artefact details pages because you cannot put a block onto these pages.
You can move the block like any other block on your page. If you delete the block, the comments are displayed at the bottom of the page again.
You can choose the block title.
When you click the Add comment link, a modal window is displayed in which you can enter your comments with all the usual functionality.