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

Configure the Annotation block

Configure the Annotation block

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. The description of the selected standard is displayed so you can reference it.

  7. 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.

  8. 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.

  9. 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.

Respond to an annotation

Respond to an annotation

  1. 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.

  2. Read the annotation.

  3. Place feedback: You can leave feedback on the annotation.

  4. Make public: Decide whether everybody who has access to the page can view your feedback or just the portfolio author.

  5. Click the Place feedback button to add your feedback to the annotation.

  6. 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.

  7. You can view the feedback of others.

  8. 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.

  9. Click the Save button to keep your selection or click Cancel to abort the assessment.

  10. 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.

Respond to an annotation on a page

Respond to an annotation on a page

  1. Click the Place feedback link at the bottom of the Annotation block.

  2. Write your feedback.

  3. 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.

  4. Make public: Decide whether everybody who has access to the page can view your feedback or just the portfolio author.

  5. Click the Place feedback button to add your feedback to the annotation or click Cancel to abort the assessment.

  6. 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. 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.

What the feedback block looks like on a page

What the feedback block looks like on a page

  1. You can choose the block title.

  2. When you click the Add comment link, a modal window is displayed in which you can enter your comments with all the usual functionality.

4.2.3.3. Course information

The Course information block requires a connection to an LMS to pull relevant information.

4.2.3.4. Creative Commons license

Add a block to your page which lets viewers know under which Creative Commons license your page is published.

Configure the Creative Commons license block

Configure the Creative Commons license block

  1. Block title: Choose a title for your block.

  2. Allow commercial uses of your work? Decide whether viewers can re-use your work for commercial purposes.

  3. Allow modifications of your work? Decide whether others can remix your work and create something new and if so under which conditions.

  4. 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.

  5. 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.

  6. 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.

  7. 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. 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.

Items in the group info block

Items in the group info block

The block contains information about:

  1. Description of the group

  2. Group creation date

  3. Type of group

  4. Group category if any was chosen

  5. 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.

  6. 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

  7. Group administrators

4.2.3.6. 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.

Configure the group pages block

Configure the Group members block

  1. Block title: The automatic title for this block is ‘Members’. You can set another one if you wish.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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 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.

Configure the group portfolios block

Configure the Group portfolios block

  1. Block title: The automatic title for this block is ‘Group portfolios’. You can set another one if you wish.

  2. Display group pages and collections: Decide whether to display pages and collections that were created in the group. ‘Yes’ is the default option.

  3. Sort group pages and collections 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.

  4. 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.

  5. 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.

  6. Sort shared pages and collections by: Choose in which order to display pages and collections shared with the group. ‘Alphabetical’ is the default option, but you can also display them based on when they were last updated.

  7. Display submitted pages and collections: 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.

  8. Sort submitted pages and collections 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.

  9. 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.

  10. 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.

  11. 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.

  12. 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.8. Inbox

The Inbox block displays the latest messages that you have received.

Note

This block can only be used on your dashboard.

Configure the inbox block

Configure the Inbox block

  1. Block title: The automatic title for this block is ‘Inbox’. You can set another one if you wish.

  2. Message types to display: Change the switch to ‘Yes’ for each message type that you want to display in this block.

  3. 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’.

  4. Maximum number of items to display: Decide how many messages shall be shown on your dashboard. You can choose between 1 and 100.

  5. 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.

  6. 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.

  7. 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.

Unread messages are displayed in bold

Unread messages are displayed 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.9. Portfolios shared with me

The Portfolios shared with me block displays the latest portfolios to which you have access across Mahara. This includes pages and collections.

Note

This block can only be used on your dashboard.

This block used to be called ‘Latest changes I can view’. It was renamed to ‘Portfolios shared with me’ to indicate more clearly that this block displays portfolios from others and not your own.

You decide which portfolios you want to see in this block based on how the portfolios were shared with you.

The site administrator sets the default in the ‘Dashboard’ template for new account holders, but you can make changes on your own dashboard independently.

Note

When a site on Mahara 20.10 or earlier is upgraded, the block is set to only show results for ‘Me’, ‘Friends’, and ‘Groups’. That selection was made because feedback from several institutions mentioned that portfolio authors were confused when they could suddenly see other people’s portfolios on their dashboard whom they didn’t know.

Configure the block 'Portfolios shared with me'

Configure the Portfolios shared with me block

  1. Block title: The automatic title for this block is ‘Portfolios shared with me’. You can set another one if you wish.

  2. Maximum number of results to show: Decide how many pages and collections shall be shown on your dashboard. You can choose between 1 and 100.

  3. Shared with: Decide which portfolios from other people you want to see on your dashboard. Per default, you see portfolios shared with you personally, with you as a friend, and with you as a group member.

  4. 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 on the heading of a block where the Retractable icon is shown.

    • Automatically retract: Only the heading of the block is visible, and the viewer can click on the heading of a block where the Retracted icon is shown to view its content.

  5. 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.

  6. You can also click the Close icon in the top left-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.

The block on your dashboard page looks like the following.

Example of the block 'Portfolios shared with me'

Example of the Portfolios shared with me block

  1. Title of the block.

  2. If you chose a retractable option, you can click on the title or anywhere in the title space to change the block’s behaviour.

  3. Title of the page or collection to which you have access.

  4. If it is a collection, you see the number of pages contained within.

  5. Name of the portfolio author, and when the portfolio was last updated.

  6. Page or collection description.

4.2.3.11. 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.11.1. Add a new note

Configure the note block

Configure the Note block

  1. Block title: Provide a title for your note.

  2. Block content: Write your text. You can include formatting, external images etc.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. Attachments: Attach a file to a note as additional evidence for the text you are writing.

  9. 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.

  10. 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.

  11. 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.11.2. Add an image into a note

Note

Please refer to the section ‘Insert an image into text’ for more information.

4.2.3.11.3. Attach a file to a note

Attach a file to a note block

Attach a file to a Note block

  1. Click the Attachments panel if you wish to add one or more files to a note.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. Folder path: The breadcrumbs show in which folder you are currently.

  7. 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.

  8. 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.

  9. Click Remove if you want to revert your selection.

  10. Continue editing your note and save it.

4.2.3.11.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.

Configure the 'Note' block by copying text

Configure the Note block by copying text

  1. 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

  2. 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.

  3. Click the Manage all note content link to be taken to your personal Notes if you can’t find what you are looking for.

  4. 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.

  5. Use the paginator to move between your notes if more than 5 are displayed.

  6. You see the number of notes that you have access to.

  7. Click the radio button in front of a note that you want to use in this page.

  8. 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…

  9. 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.

  10. 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.

  11. 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.

  12. 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.

Open a note that is submitted for assessment in another portfolio

Open a note that is submitted for assessment in another portfolio

4.2.3.12. Peer assessment

Allow peer reviewers to give feedback. There are two options:

  1. 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.’

  2. 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.12.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.

Configure the 'Peer assessment' block

Configure the Peer assessment block

  1. Block title: The title that you want to give this particular block.

  2. Instructions: Provide instructions for the peer reviewer to help them with their assessment.

  3. 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.

  1. 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.

  2. 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.12.2. Set up a peer assessor

You can give someone the peer assessment permissions on the Edit access screen of your portfolio page.

Give someone peer assessment permissions

Give someone peer assessment permissions

  1. In the Share with drop-down menu, select ‘Person’ under ‘Search for…’.

  2. In the second drop-down menu that becomes available, type the name of the person who shall be the peer assessor and select them.

  3. 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.

  4. Click the Save button to keep your selection or click the Cancel link to abort your changes.

4.2.3.12.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.

Add a peer assessment

Add a peer assessment

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.

peer assessment alert

Write a peer assessment

Write a peer assessment

  1. Click the Instructions link to view the instructions for the peer assessment.

  2. Write your peer assessment.

  3. 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.

  4. 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 block, the portfolio author must sign off the page before anybody other than themselves and the peer assessor can see published peer assessments.

  5. Click Cancel if you do not want to save any of your changes.

4.2.3.12.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.

View a peer assessment

View a peer assessment

  1. 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.

  2. The profile picture and name of the peer assessor are displayed along with the date and time when the peer assessment was made.

  3. The peer assessment is displayed.

  4. 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.

  5. 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.13. Plans

Display your plans in a block.

Note

You must create at least one plan in order to use this block.

Configure the plans block

Configure the Plans block

  1. Block title: The title of the plan is chosen automatically unless you provide a different one.

  2. Plans to show: Choose the plan or plans which you want to display in your page.

  3. Tasks to display: Decide how many tasks you want to display for each plan before a paginator is displayed.

  4. 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.

  5. 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.

  6. 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.

Embedded plan

Result of an embedded plan in a portfolio page. By clicking on the linked titles, you can show the descriptions of the individual tasks.

4.2.3.14. 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.14.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:

  1. Tick a box in a pre-set statement.

  2. Add your own comment.

  3. Confirm a pre-set statement and add your own comment.

The template creator decides which is available.

Configure the 'Portfolio review' block

Configure the Portfolio review block

  1. Block title: Add a title for your block.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. Notification to author: The portfolio author can be notified when a statement has been confirmed. The notification contains the statement itself.

  10. 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.

  11. 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.

  12. 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.

  13. 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. Confirm a statement

You can confirm a standard or a primary statement if the template allows you to do so.

Confirm a pre-set portfolio review statement

Confirm a pre-set portfolio review statement

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.14.3. Add a review comment

You can add your own comment if the template allows you to do so.

Add a review comment to the portfolio completion page

Add a review comment to the portfolio completion page

  1. Write your comment in to the text box. You can use formatting options.

  2. 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.

  3. 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.

  4. Click the Cancel link if you want to abort your changes.

4.2.3.14.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.

Confirm a statement and add a review comment to the portfolio completion page

Confirm a statement and add a review comment to the portfolio completion page

  1. The pre-set statement is visible to you.

  2. Write your comment in to the text box. You can use formatting options.

  3. 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.

  4. 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.

  5. Click the Cancel link if you want to abort your changes.

4.2.3.14.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.

Request to have a statement reset

Request to have a statement reset

  1. As reviewer, click the More options button on the portfolio completion page.

  2. Follow the link Reset statement.

  3. A modal is displayed in which you can request to have one or more statements reset.

  4. 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.

  5. Reason for resetting the statement: Provide a reason for the person whom you ask to reset your statement. They receive that in a notification.

  6. Click the Request reset button to send the notification.

4.2.3.15. 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.

Configure the recent forum posts block

Configure the Recent forum posts block

  1. Block title: The title of the block is generated automatically unless you provide a different one. The default title is ‘Recent forum posts’.

  2. Group: Choose the group whose forum posts you wish to display.

  3. 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.

  4. 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.

  5. 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.

  6. 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. Sign-off

Portfolio authors can sign off a page, and a manager can verify it.

The sign-off and verification process allows for a visual indicator on a portfolio page showing whether the page has been finished and whether a manager has verified it before it can go for the final assessment. The verification by a manager is optional.

Note

new in Mahara 22.04 When the sign-off block is used in a portfolio that is marked as template, its settings cannot be changed by the portfolio author, and it cannot be removed from the page. This prevents accidental changes to the settings or removal of this functionality altogether for portfolios that require it.

4.2.3.16.1. Set up a page for sign-off and verification

Configure the 'Sign-off' block

Configure the Sign-off block

  1. Sign off: A sign-off by the portfolio author is always required.

  2. Verify: Give a person with the ‘Manager’ permission the opportunity to verify a page and state that fact to carry it one step further in the assessment. Page content will not be locked when the verification has been made.

    Note

    The manager cannot revoke the verification. This can only be done by the portfolio author in form of revoking the sign-off for the page.

You cannot set a block title because the block is always put into the top right-hand corner of a page right below the page title without a block title.

4.2.3.16.2. Set up a manager for verification

You can give someone the manager permissions on the Edit access screen of your portfolio page to allow them to verify your portfolio.

Give someone manager permissions

Give someone manager permissions

  1. In the Share with drop-down menu, select ‘Person’ under ‘Search for…’.

  2. In the second drop-down menu that becomes available, type the name of the person who shall be the manager and select them.

  3. In the third drop-down menu, select the ‘Manager’ option. You can also select the ‘Peer and manager’ option if the manager is also the peer and can write a peer assessment.

  4. Click the Save button to keep your selection or click the Cancel link to abort your changes.

4.2.3.16.3. Sign off a page

When you have a sign-off block on your page and you view it, you can see the sign-off and verification options below the page heading to the right.

View the sign-off as portfolio author

View the sign-off as portfolio author

When you are ready to sign off your page, you can click the red dot icon , and it will turn into a green tick icon to indicate that the page has been signed off. In addition, the Info icon is displayed where additional information about the sign-off and verification can be viewed.

If the page also needs a verification, your manager can now perform it.

4.2.3.16.4. Verify a page

As manager, you can see the sign-off and verification options below the page heading to the right. You can only tick the verification option.

Verify a page as manager

Verify a page as manager

  1. You see the green tick icon when a page has been signed off.

  2. When you are ready to verify a page that allows for verification, you can click the red dot icon , and it will turn into a green tick icon to indicate that the page has been verified.

Note

As manager, you cannot revoke the verification. Only the portfolio author can do so by revoking the sign-off.

  1. You can click the Info icon to find out when the portfolio author has signed off the page and when the verification had taken place.

4.2.3.16.5. Portfolio completion progress page

The Portfolio completion progress page shows in a quick overview how many sign-offs and verifications have already been done in the portfolio, and what still needs to be completed.

This page is only beneficial when you have the sign-off block on at least two of your portfolio pages.

Note

An institution or site administrator needs to activate this setting for your institution before you can use it.

The portfolio completion progress page

The portfolio completion progress page

  1. Activate the portfolio completion progress page when you create or edit your collection. It will place the page ‘Portfolio completion’ as first page in your collection.

    Note

    If you also add SmartEvidence to your collection, the SmartEvidence page becomes the second page in it.

  2. Overall completion of sign-off and verification: The progress bar indicates how many percent of sign-offs and verifications combined have already been completed. If none of the pages require verification, only sign-offs are counted.

  3. Page: Each page that is in the collection is listed and can be clicked.

  4. Sign-off: When a page has been signed off, the icon is changed upon the next page load. As portfolio author, you can also click the sign-off icon here to change its status. It is changed on the page itself as well. There are two statuses:

    • Green tick icon : The page has been signed off.

    • Red dot icon : The page is awaiting sign-off.

  5. Verification: Once a page has been signed off and still requires verification, a person who has the ‘Manager’ or ‘Peer and manager’ role can verify the page, either by clicking the icon on the portfolio completion progress page or on the portfolio page itself. The following statuses are available in the ‘Verification’ column:

    • Green tick icon : The page has been verified.

    • Red dot icon : The page is awaiting verification.

    • Grey line icon : Verification is not yet possible because the page hasn’t been signed off yet.

4.2.3.17. Text

4.2.3.17.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.

Configure the 'Text' block

Configure the Text block

  1. Block title: Provide a title for your text.

  2. 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.

  3. You can use full formatting, images, etc. in your instructions.

  4. Block content: Write your text. You can include full formatting.

  5. Tags: Enter tags for this block to find this content more easily. The tags are displayed as part of the page tags.

  6. 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.

  7. 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.

  8. 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.17.2. View the ‘Text’ block

View a 'Text' block on the page

View a Text block on the page

  1. Click Instructions to expand or collapse the instructions for this block.

  2. The instructions are displayed in a grey box to differentiate them from the regular text.

  3. View the content of the block.

4.2.3.17.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.

Use the 'Quick edit' functionality on the 'Text' block

Use the ‘Quick edit’ functionality on the Text block

  1. Click the Details button .

  2. The Quick edit bar

    is displayed.

  3. Click the Quick edit bar to display the block configuration screen. You can make any changes that you wish to make.

4.2.3.18. 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.18.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.

Configure the 'Watched pages' block for your watchlist

Configure the Watched pages block for your watchlist

  1. Block title: The automatic title for this block is ‘Watched pages’. You can set another one if you wish.

  2. Select to display Pages on my watchlist.

  3. Items to show: Decide how many pages shall be shown on your dashboard. You can choose between 1 and 100.

  4. 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.

  5. 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.

  6. 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.

View the 'Watched pages' block

View the Watched pages block

  1. 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.

  2. Title of the watched page. You can click the link to be taken to her.

  3. 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.18.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

Configure the 'Watched pages' block for your friend activity

Configure the Watched pages block for your friend activity

  1. Block title: The automatic title for this block is ‘Watched pages’. You can set another one if you wish.

  2. Select to display Activities of my friends.

  3. Click Additional filters and settings to make additional changes.

  4. 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

  5. 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.

  6. Items to show: Decide how many pages shall be shown on your dashboard. You can choose between 1 and 100.

  7. 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.

  8. 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.

  9. 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.