Commit 04e9d17c authored by Kristina Hoeppner's avatar Kristina Hoeppner
Browse files

groups/inside_group: Add submissions management screen

New feature in Mahara 21.04. Also added the
information about the submissions screen in
the personal portfolio area.
parent d6a8fbf0
......@@ -653,6 +653,34 @@ You can copy a group portfolio into the accounts of existing group members by se
The portfolio is copied only once. If changes are made to a page, they are not pushed to the copied page automatically. Also, when new members are added to the group and the template pushed automatically into their accounts, members who had already received the template will not get another copy.
.. index::
single: Participation report
.. _participation_reports:
Report
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*Main menu → Engage → Groups → [Name of the group] → Report*
When you are an administrator of a group, you can :ref:`switch on the participation report in the group settings <set_participation_report>`. The report provides you with information on who commented on what pages that were created in or shared with the group.
.. figure:: /images/group/group_participation_report.*
:alt: Participation report for a group
Participation report for a group
#. **Portfolios shared with this group**: List of all the portfolios that group members have shared with this group. submitted portfolios are displayed alongside shared portfolios.
#. **Shared by**: Displays the author of the page.
#. **Members involved**: Shows the group members who have commented on the pages **publicly**.
#. **Non-members involved**: Shows who has commented on the pages **publicly** but is not a member of the group.
#. Next to each person who commented on a page is the count for the number of comments they have left on that page. This also includes private comments.
#. The total count for the comments by members and non-members is displayed separately.
#. **Portfolios owned by this group**: List of all the portfolios that were created within the group.
.. note::
You can sort each of the columns. The column that is currently sorted, has a little ascending triangle |sort-ascend| or descending triangle |sort-descend| next to it.
.. index::
single: Group; Files
single: Group file quota
......@@ -814,29 +842,87 @@ View an assignment plan as ordinary group member
When you view the tasks in your personal plans area via *Main menu → Create → Plans → [Name of the plan]*, you only see that tasks that you activated.
.. index::
single: Participation report
single: Group; Submissions management
.. _participation_reports:
.. _group_submission_management:
Report
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|new in Mahara 21.04| Submissions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*Main menu → Engage → Groups → [Name of the group] → Report*
*Main menu → Engage → Groups → [Name of the group] → Submissions*
When you are an administrator of a group, you can :ref:`switch on the participation report in the group settings <set_participation_report>`. The report provides you with information on who commented on what pages that were created in or shared with the group.
.. note::
**Group administrators** and **group tutors** only see this group menu item if your group allows learners to submit portfolios to it.
.. figure:: /images/group/group_participation_report.*
:alt: Participation report for a group
**Regular group members** do not have access to this screen. Instead, they can see their own submissions across all groups on the site on their :ref:`personal submissions screen <submissions_personal>`.
Participation report for a group
:index:`The <single: New in Mahara 21.04; Submissions management in a group>` submissions management screen in a group allows you to:
#. **Portfolios shared with this group**: List of all the portfolios that group members have shared with this group. submitted portfolios are displayed alongside shared portfolios.
#. **Shared by**: Displays the author of the page.
#. **Members involved**: Shows the group members who have commented on the pages **publicly**.
#. **Non-members involved**: Shows who has commented on the pages **publicly** but is not a member of the group.
#. Next to each person who commented on a page is the count for the number of comments they have left on that page. This also includes private comments.
#. The total count for the comments by members and non-members is displayed separately.
#. **Portfolios owned by this group**: List of all the portfolios that were created within the group.
* see all submitted portfolios
* assign portfolios to different group administrators and tutors
* download a CSV file of basic overview information
* filter the table according to your own criteria to find certain portfolios quickly
.. note::
You can sort each of the columns. The column that is currently sorted, has a little ascending triangle |sort-ascend| or descending triangle |sort-descend| next to it.
.. figure:: /images/group/submissions.*
:alt: View all submissions to a group in one place
View all submissions to a group in one place
#. **Search**: Search for a name, title of a portfolio, or text in feedback to find a particular portfolio.
#. Click the *Configure columns* button |configure columns button| to change the columns that you want to display. Select columns to display and unselect them to hide them. Your select is retained when you navigate away from the page.
#. Click the *PDF* button |PDF button| to download the current display of the table as PDF file.
#. Click the *CSV* button |CSV button| to download the current display of the table as CSV file for further analysis in a spreadsheet.
#. Click *Quick filter* to see all filtering options available to you.
.. note::
The filtering options refer to the columns in the submissions table that you can filter on.
#. If you applied one or more filters and want to reset all options, click the *Undo* button |undo button|.
#. **Task**: If the portfolio was based on a task, you can filter for it here. 'Missing task' means that there is no task assigned to the portfolio.
#. **Assessor**: Lists all current assessors. If a portfolio hasn't been assigned a portfolio yet, the assessor is 'Unassigned'.
#. **Feedback**: Filter for portfolios that have or have not yet received feedback.
#. **Result**: Filter for a particular result. The result options are:
* **Any**: No filter applied.
* **Revise**: Portfolio author can resubmit their portfolio.
* **Pass**: Portfolio author successfully completed their portfolio.
* **Fail**: Portfolio author failed the portfolio task.
* **Missing**: Portfolio hasn't been assessed yet.
#. **Status**: Filter for a particular status. The status options are:
* **Any**: No filter applied.
* **Open**: Portfolio hasn't been fully assessed yet.
* **Completed**: Portfolio has been assessed and a result has been given.
#. **Name**: The name of the person who made the submission. This is their real name. If you want to see their display name, you can add that to the table.
#. **Feedback**: Typically, the feedback doesn't fit into the table. Click the *Downwards facing chevron* icon |menu open| next to a name or the space to the right of the name to expand that record to see the feedback. Click the *Upwards faicing chevron* icon |menu close| next to a name to hide the feedback.
#. You can sort each column in ascending or descending order by clicking the *Sort* icon |sort icon|.
#. **Portfolio**: The title of the portfolio.
* When a **portfolio has been assessed**, you can click its title to download an export of it if it is your own portfolio or if you are the group administrator. Group tutors cannot download portfolios of others.
* If the **portfolio hasn't been assessed** yet, you can view it by clicking the title of the portfolio. If you click the *Preview* button |preview button| of a portfolio that hasn't been assessed yet, the portfolio opens in a modal instead of taking you directly to it. You can then decide whether you want to navigate to the portfolio or not.
.. note::
When you selected to view a portfolio that hasn't been assessed yet, the table row changes its colour. If you then visit the portfolio and use your browser's 'Back' button, you return to the submission management screen, and the portfolio you viewed is still highlighted in the table so you can find it easily.
#. **Date**: The date the portfolio has been submitted.
#. **Task**: If the portfolio was based on a task, you see the title of the task.
#. **Assessor**: Displays the person who is currently assigned as assessor. If the name appears in a box, it can still be changed by clicking on the box to select a different assessor. This is only possible for portfolios that haven't been assessed yet.
#. **Rating**: If feedback was accompanied by a rating, it is displayed.
#. **Result**: The current result is displayed. If it is shown as a button, you can click it to change it instead of going to the portfolio itself and changing it there.
.. note::
If you release a portfolio without giving a result, it can't be submitted again.
You can suggest a result and then change the assessor so that another person can take a nother look before releasing the portfolio.
#. **Status**: There are three statuses that you see:
* **To be released**: This equates to 'Open' in the filter options. It means that the portfolio hasn't been assessed yet and is awaiting a result. Give the portfolio a result and then click this button to release it.
* **Releasing...**: If you require the archiving of portfolios before they can be released back to portfolio authors, this is the status you will see. The cron needs to run in order for the archiving to take place.
* **Released**: The portfolio has been returned to the portfolio author, and they can edit it again.
#. The paginator allows you to navigate between the pages of the submissions if there are lots of them.
#. The number of results are displayed according to the filter options you applied.
#. You can decide how many results you want to see per page.
.. include:: /shortcuts.rstext
.. index::
single: Portfolio; Submissions
single: Submissions
.. _submissions_personal:
|new in Mahara 21.04| Submissions
------------------------------------------------
*Main menu → Share → Submissions*
:index:`With <single: New in Mahara 21.04; Submissions overview - personal>` the new group submissions management, portfolio authors can see all their submissions to groups in a single place. Displayed are also all submissions that are assigned to them to assess.
.. note::
This screen only displays submissions to groups, but not submissions that were made to a learning management system.
.. figure:: /images/submissions.*
:alt: View all your submissions in one place
View all your submissions in one place
#. **Search**: Search for a name, title of a portfolio, or text in feedback that you have given or received on a submitted portfolio.
#. Click the *Configure columns* button |configure columns button| to change the columns that you want to display. Select columns to display and unselect them to hide them. Your select is retained when you navigate away from the page.
#. Click the *PDF* button |PDF button| to download the current display of the table as PDF file.
#. Click the *CSV* button |CSV button| to download the current display of the table as CSV file for further analysis in a spreadsheet.
#. Click *Quick filter* to see all filtering options available to you.
.. note::
The filtering options refer to the columns in the submissions table. Only 'Name' and 'Portfolio' are not options.
#. If you applied one or more filters and want to reset all options, click the *Undo* button |undo button|.
#. **Group**: The group to which a portfolio was submitted.
#. **Role**: The role that you have for a submission. The options are:
* **All**: No filter applied.
* **Assessor**: You are assigned to perform the assessment of the portfolio.
* **Author**: You are the portfolio author who is being assessed.
#. **Task**: If the portfolio was based on a task, you can filter for it here. 'Missing task' means that there is no task assigned to the portfolio.
#. **Assessor**: Lists all current assessors. If a portfolio hasn't been assigned a portfolio yet, the assessor is 'Unassigned'.
#. **Feedback**: Filter for portfolios that have or have not yet received feedback.
#. **Result**: Filter for a particular result. The result options are:
* **Any**: No filter applied.
* **Revise**: Portfolio author can resubmit their portfolio.
* **Pass**: Portfolio author successfully completed their portfolio.
* **Fail**: Portfolio author failed the portfolio task.
* **Missing**: Portfolio hasn't been assessed yet.
#. **Status**: Filter for a particular status. The status options are:
* **Any**: No filter applied.
* **Open**: Portfolio hasn't been fully assessed yet.
* **Completed**: Portfolio has been assessed and a result has been given.
#. You can sort each column in ascending or descending order by clicking the *Sort* icon |sort icon|.
#. Click the group name to see other columns, in particular the feedback, if there are more columns to display.
#. View the feedback for a portfolio.
.. note::
Typically, the feedback is too long to be displayed in the columns themselves. That's why it is displayed below the other columns when you view the entire record.
#. When a portfolio has been assessed, you can click its title to download an export of it if it is your own portfolio or if you are the group administrator. Group tutors cannot download portfolios of others.
#. If the portfolio hasn't been assessed yet, you can view it by clicking the title of the portfolio. If you click the *Preview* button |preview button|, the portfolio opens in a modal instead of taking you directly to it. You can then decide whether you want to navigate to the portfolio or not.
#. If the name is displayed as a button on portfolios that haven't been assessed yet, the assessor can be changed. Click the button to select an assessor.
#. The paginator allows you to navigate between the pages of the submissions if there are lots of them.
#. The number of results are displayed according to the filter options you applied.
#. You can decide how many results you want to see per page.
......@@ -7,3 +7,4 @@ The *Share* menu item holds all parts of Mahara that allow you to share your own
/portfolio/share
/portfolio/shared
/portfolio/submissions
......@@ -525,6 +525,30 @@
.. |peer assessment alert| image:: /images/page_editor/blocks/peerassessment_alert.*
.. Submissions buttons
.. |configure columns button| raw:: html
<button class="btn btn-secondary">
<i class="fas fa-cog fa-lg"></i> Configure columns</button>
.. |PDF button| raw:: html
<button class="btn btn-secondary">
<i class="far fa-file-pdf fa-lg"></i> PDF</button>
.. |CSV button| raw:: html
<button class="btn btn-secondary">
<i class="fas fa-file-csv fa-lg"></i> CSV</button>
.. |sort icon| replace:: :fonticon:`fas fa-sort fa-lg brand-grey`
.. |undo button| raw:: html
<button class="btn btn-secondary btn-sm">
<i class="fas fa-undo fa-lg"></i></button>
.. |language chooser icon| replace:: :fonticon:`fas fa-language fa-fw fa-1x`
.. |remove my access notification| image:: /images/remove_portfolio_access.*
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment