Commit b1ba1d45 authored by Kristina Hoeppner's avatar Kristina Hoeppner

blocks/context, general: Add sign-off block

New in Mahara 18.10: Sign-off and verification block
to display that info on a page (and in the future
in an overview page) and allow the page owner to
sign off a page and a manager to verify it
(Bug #1786427).
parent a266cae7
......@@ -202,27 +202,27 @@ General
-
-
- |check|
* - :fonticon:`fa fa-creative-commons fa-border fa-2x`
* - :fonticon:`fa fa-comment fa-border fa-2x`
:ref:`Creative Commons license <creative_commons_block>`
:ref:`Comments <comments_block>`
- |check|
- |check|
- |check|
- |check|
-
-
-
- |check|
* - :fonticon:`fa fa-creative-commons fa-border fa-2x`
:ref:`Creative Commons license <creative_commons_block>`
- |check|
- |check|
- |check|
* - :fonticon:`fa fa-comment fa-border fa-2x`
:ref:`Comments <comments_block>`
- |check|
- |check|
- |check|
- |check|
-
-
-
- |check|
* - :fonticon:`fa fa-info fa-border fa-2x`
......@@ -301,7 +301,18 @@ General
- |check|
- |check|
- |check|
* - :fonticon:`fa fa-check-square-o fa-border fa-2x`
* - :fonticon:`fa fa-list-alt fa-border fa-2x`
:ref:`Peer assessment <peer_assessment_block>`
- |check|
- |check|
- |check|
- |check|
-
-
-
- |check|
* - :fonticon:`fa fa-map-o fa-border fa-2x`
:ref:`Plans <plans_block>`
- |check|
......@@ -323,6 +334,17 @@ General
- |check|
- |check|
- |check|
* - :fonticon:`fa fa-check-square-o fa-border fa-2x`
:ref:`Sign-off <sign-off_block>`
- |check|
- |check| *
- |check| *
- |check| *
-
-
-
- |check| *
* - :fonticon:`fa fa-font fa-border fa-2x`
:ref:`Text <text_block>`
......
......@@ -711,7 +711,7 @@ If a peer assessment is in draft mode, only the peer assessor can see it. Once i
Plans
~~~~~~
:fonticon:`fa fa-check-square-o fa-border fa-2x`
:fonticon:`fa fa-map-o fa-border fa-2x`
Display one of your plans in a block.
......@@ -772,6 +772,83 @@ Display a specified number of recent forum posts from one group on a page.
#. 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 |close| 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.
.. index::
pair: Blocks; Sign-off
single: General block; Sign-off
single: New in Mahara 18.10; Sign off and verify a page
.. _sign-off_block:
|new in Mahara 18.10| Sign-off
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:fonticon:`fa fa-check-square-o fa-border fa-2x`
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.
Set up a page for sign-off and verification
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. figure:: /images/page_editor/blocks/signoff_configuration.*
:alt: Configure the "Sign-off" block
Configure the *Sign-off* block
#. **Block title**: Give the block a title. This is not required as the options will sit right below the page heading rather than in a block on the page itself when in view mode.
#. **Sign off**: A sign-off by the portfolo author is always required.
#. **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.
.. _manager_setup:
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.
.. figure:: /images/page_editor/blocks/signoff_verification_access.*
:alt: Give someone manager permissions
Give someone manager permissions
#. In the *Share with* drop-down menu, select "Users" under "Search for...".
#. In the second drop-down menu that becomes available, type the name of the person who shall be the manager and select them.
#. 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 :ref:`peer assessment <peer_assessment_add>`.
#. Click the *Save* button to keep your selection or click the *Cancel* link to abort your changes.
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.
.. figure:: /images/page_editor/blocks/signoff_view.*
:alt: View the sign-off as portfolio autor
View the sign-off as portfolio autor
When you are ready to sign off your page, you can click the red dot icon |not signed off or verified|, and it will turn into a green tick icon |signed off or verified| to indicate that the page has been signed off.
If the page also needs a verification, your manager can now perform it.
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.
.. figure:: /images/page_editor/blocks/signoff_verification_view.*
:alt: Verify a page as manager
Verify a page as manager
When you are ready to verify a page that allows for verification, you can click the red dot icon |not signed off or verified|, and it will turn into a green tick icon |signed off or verified| to indicate that the page has been verified.
.. note::
You cannot revoke the verification. Only the portfolio author can do so by revoking the sign-off.
.. index::
pair: Blocks; Text
single: General block; Text
......
......@@ -315,6 +315,9 @@
.. |page instructions| image:: /images/page_instructions.*
.. |not signed off or verified| replace:: :fonticon:`fa fa-circle fa-lg sign-off_no`
.. |signed off or verified| replace:: :fonticon:`fa fa-check-circle fa-lg sign-off_yes`
.. |smartevidence_nothing| replace:: :fonticon:`fa fa-circle smartevidence_nothing`
.. |smartevidence_begun| replace:: :fonticon:`fa fa-circle-o fa-lg smartevidence_begun`
.. |smartevidence_completed| replace:: :fonticon:`fa fa-check-circle fa-lg smartevidence_completed`
......
Markdown is supported
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