.. include:: /shortcuts.rstext .. index:: single: Page; Feedback single: Portfolio; Feedback single: Page; Comments single: Portfolio; Comments .. _feedback: Commenting ------------- *Commenting* or giving feedback is an essential component for portfolio work. You can give feedback not only on individual artefacts but on entire portfolio pages. The author of an artefact or portfolio page decides whether you can leave comments or not. Find the comment options for: * **files**: when :ref:`editing a file `. * **journal entries**: when :ref:`editing a journal entry `. * **notes**: when :ref:`editing a note `. * **pages**: in the :ref:`advanced options `. .. note:: "Feedback" and "comments" are used interchangeably. It can be argued that feedback and comments denote different qualities of responding. From Mahara 15.10 on, "comments" are used throughout instead of having a mix of "feedback" and "comments". .. index:: single: Feedback; View feedback single: Comments; View comments .. _view_feedback: View page comments ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can see the comments left so far at the bottom of each portfolio page or the artefact page that contains the artefact's metadata. .. figure:: /images/feedback_viewing.* :alt: View comments on a page View comments on a page #. The profile picture and name of the author of the comment are shown. The name links to the author's profile. #. You can see when the comment author wrote the comment and also when the last change to it was made. #. The comment is displayed. #. If comment or portfolio authors decide to remove comments, they are marked as such. .. note:: Deleted comments retain the section "Comment removed by author / owner" if more comments come after them as they could have been referenced. Without that indicator, some conversations may not be easy to follow as context would be missing. If no additional comment comes after a deleted one, the deleted comment is removed entirely. If a deleted comment needs to be retrieved, it can be undeleted in the database as comments are not deleted from the database itself, but only set to be hidden. #. Comments can contain a rating which shows quickly how well the person commenting likes your page or artefact. .. note:: This feature is only available if the site administrator turned it on in the :ref:`extensions `. #. As page / artefact owner you see all comments. A comment marked as private by the comment author is only displayed to you and the person commenting. #. You or the comment author can make a private comment public by clicking the *Make public* link. #. Comment authors can attach a file to their comment to give you longer feedback or oral or video feedback. The files that they add are placed into your personal *Files* area so you can use that feedback later on. #. You and the comment author can delete a comment by clicking the *Delete* button |delete|. The comment text is not displayed anymore. In addition, if you delete the comment by someone else, they will receive a notification about it, which includes their comment text. #. :index:`You can reply directly to a comment ` when this functionality was :ref:`enabled for your institution `. .. note:: When you reply to a **public comment** then your reply can be seen by anyone with access to the page. They also receive a notification about the comment when they had previously left a comment themselves. When you reply to a **private comment** or reply privately, then only you and the comment author to whom you are replying can see your reply and are notified about it. #. You can edit your own comments, and comment authors can edit their comment if it is the last comment and / or the editing time of 10 minutes has not elapsed yet. #. :index:`If ` a comment is less than a day old, its time is displayed in seconds, minutes or hours. As owner of a page or artefact, you receive a notification about new comments that have been placed on it. Others will receive notifications if they placed a comment themselves. View artefact comments ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :index:`You ` do not have to go to the artefact's details page to view comments left on an artefact. Instead, you can view them directly on a page. .. figure:: /images/feedback_viewing_artefact.* :alt: View artefact comments on a page View artefact comments on a page #. See how many comments this content item has already received. If you click it... #. You will see the comments directly on the page in the separate modal window. If you have permissions, you can perform certain actions on the comments, such as deleting them or making them public. #. Click the *Close* icon |close| to collapse all comments. #. Click the *Add comment* link to leave a comment on the artefact's details page. .. note:: You can also simply click the *Add comment* link |add a comment| at the bottom of the block, and you'll be taken directly to the artefact's details page where you can view all other comments. If you want to have all feedback management options available, please click the little *Details* icon |details| at the bottom of the block. That will take you to the details page of the artefact where you have more options available for viewing your feedback. .. note:: If you do not see "Comments" and / or "Add comment" on an artefact, then you are not allowed to leave comments (anymore). If comments have already been left, you can still view them, but you may not be able to add your own. .. index:: single: Feedback; Give feedback single: Comments; Comment on content and portfolios .. _add_comment: Comment on portfolios ~~~~~~~~~~~~~~~~~~~~~~~~~~ You can comment on a page and individual artefacts if the page / artefact author allowed that. Leave comments being logged in ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. figure:: /images/comments.* :alt: Leave a comment Leave a comment #. **Add comment**: Write your comment into the editor window. .. note:: At the bottom of the editor window, you see a line that usually contains some letters (in the screenshot that is "p"). That's just the HTML notation of the current style that you are working in. #. Click the *Window resizer* icon |tinymce resizer| to make the editor window larger. #. **Rating**: If the site administrator :ref:`turned on comment ratings `, you can use the 5-star rating scale **in addition** to your written comments and / or an uploaded file. #. **Make public**: Switch this to "Yes" if you want everyone, who has access to this page or artefact, to see your comment. If you do not make your comment public, only you and the page / artefact author can see it. This setting is switched on by default. #. **License**: You see this field if the site administrator turned on :ref:`license metadata `. Choose the license for your feedback. You can set your default license in your :ref:`account settings `. #. **Advanced licensing**: You see this option if the site administrator turned on :ref:`license metadata `. If you click it, you see two additional license fields, "Licensor" and "Original URL", that you can fill in if this is not your own feedback. .. note:: At the moment, you cannot display that license information on a portfolio page, but it is stored for future use when the functionality is expanded. #. **Attach file**: Click the *Browse* button to attach a feedback file from your computer. This file is placed into the *Files* area of the author of the page. #. Click the *Add attachment* button |add attachment| to add another file. #. Click the *Comment* button to save your feedback or click *Cancel* to abort your changes. #. Once you have commented, the author receives a notification about it. .. note:: :index:`Those who comment ` receive notifications about additional comments made by others after they submitted theirs on portfolio pages when that comment is public. A person leaving a comment is added automatically to the watchlist for the page. .. index:: single: Feedback; Give feedback anonymously Give feedback when you are not logged in ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. note:: When you are not logged in, you can only give feedback on public pages and pages with secret URLs if the site administrator allowed :ref:`anonymous feedback / comments `. .. figure:: /images/comment_anonymous.* :alt: Comment anonymously Comment anonymously #. **Name**: You must provide your name to identify yourself. This field is required. #. Write your comment into the editor window. .. note:: You have a simple text box available but no advanced editing tools for security reasons and because you wouldn't be able to use the full image selector. #. **Rating**: If the site administrator :ref:`turned on comment ratings `, you can use the 5-star rating scale **in addition** to your written comments. #. **Make public**: Switch this to "No" if you don't want everyone who has access to this page to see your comment. If you do not make your comment public, only you and the page / artefact author can see your comment. This setting is set to "Yes" by default. .. note:: Comments that are left on portfolios shared publicly or via secret URL by people who do not have an account are always moderated. They are only made public if the portfolio author wishes to do so. #. **License**: You see this field if the site administrator turned on :ref:`license metadata `. Choose the license for your feedback. You can set your default license in your :ref:`account settings `. #. **Advanced licensing**: You see this option if the site administrator turned on :ref:`license metadata `. If you click it, you see two additional license fields, "Licensor" and "Original URL", that you can fill in if this is not your own feedback. .. note:: At the moment, you cannot display that license information on a portfolio page, but it is stored for future use when the functionality is expanded. #. Click the *Comment* button to save your comment or click *Cancel* to abort your changes. #. Once you have commented, the author receives a notification about it. .. index:: single: Page; Assessment single: Collection; Assessment single: Portfolio; Assessment single: Page; Lock page single: Submit a collection for assessment .. _submit_page: Feedback for assessment -------------------------- Submit a page or collection for assessment ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you are a member of a group that allows submissions, you can submit portfolio pages and collections for feedback / assessment. This allows an instructor to view the portfolio with much of the content locked into place. .. note:: You do not have to give the group permission to access your page or collection when you want to submit your page or collection for feedback or assessment. When you submit your page or collection, the group administrators and tutors are able to see them and give you feedback whereas regular group members do not have access to them. During the feedback phase, you **cannot** make any changes to * files * journal entries * text boxes * notes * links to external content You **can** still * edit plans * update profile information * change résumé information * add new journal entries to a journal * any external content on the source site, e.g. adding comments to a YouTube video, adding audio to a SlideShare presentation etc. or deleting the media .. index:: single: Page; Feedback on a submitted page single: Portfolio; Feedback on a submitted page single: Collection; Feedback on a submitted collection single: Portfolio; Feedback on a submitted collection Submit from the group homepage ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. figure:: /images/group/submit_portfolio.* :alt: Submit a page or collection to a group Submit a page or collection to a group #. Go to the group homepage of the group in which you want to submit a page or collection. #. You can choose the **collection** from the drop-down menu under **Submit a page or collection to this group**. #. Alternatively, you can select a **page**, which is not part of a collection, from the drop-down menu. #. Click the *Submit* button to lock page content. On the next page you are asked whether you really want to submit your page as your content will be locked at least temporarily. #. You see all the portfolios you submitted to this group, but won't be able to see other people's portfolios Submit from the page itself ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You can also display the page or collection that you wish to submit and click the *Submit* button right above the comments and the select the group to which you want to submit your work. .. figure:: /images/submit_portfolio_from_page.* :alt: Submit a page or collection to a group from the page or collection itself Submit a page or collection to a group from the page or collection itself #. Go to the page / collection that you want to submit. #. Right above the *Comments* section, choose to which group you want to submit the page. #. Click the *Submit* button. #. On the next page you are asked whether you really want to submit your page as your content will be locked at least temporarily. .. _instructor_feedback: Instructor feedback ~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you have the role of a tutor or group administrator in a group that allows submissions, you can see all submitted pages and collections with a time stamp on the group's homepage. .. figure:: /images/group/submitted_portfolio.* :alt: Submitted porfolios with time stamp Submitted portfolios with time stamp #. Title of the portfolio. This can be either a page or a collection. #. Owner of the portfolio. You can click the name in order to view the profile page. #. Time when the portfolio was submitted to this group. You can now give feedback on the submitted individual pages or pages in a collection and then click on the *Release page* / *Release collection* button so that the authors can continue working on them. .. figure:: /images/feedback_tutor.* :alt: Provide feedback as tutor or group administrator on a submitted page Provide feedback as tutor or group administrator on a submitted page #. **Add comment**: Write your comment into the editor window. .. note:: At the bottom of the editor window, you see a line that usually contains some letters (in the screenshot that is "p"). That's just the HTML notation of the current style that you are working in. #. Click the *Window resizer* icon |tinymce resizer| to make the editor window larger. #. **Rating**: If the site administrator :ref:`turned on comment ratings `, you can use the 5-star rating scale **in addition** to your written comments and / or an uploaded file. #. **Make public**: Switch this to "Yes" if you want everyone, who has access to this page or artefact, to see your comment. If you do not make your comment public, only you and the page / artefact author can see it. This setting is set to "No" by default to prevent accidental publishing of assessment comments that should be kept private. #. **License**: You see this field if the site administrator turned on :ref:`license metadata `. Choose the license for your feedback. You can set your default license in your :ref:`account settings `. #. **Advanced licensing**: You see this option if the site administrator turned on :ref:`license metadata `. If you click it, you see two additional license fields, "Licensor" and "Original URL", that you can fill in if this is not your own feedback. .. note:: At the moment, you cannot display that license information on a portfolio page, but it is stored for future use when the functionality is expanded. #. **Attach file**: Click the *Browse* button to attach a feedback file from your computer. This file is placed into the *Files* area of the author of the page. #. Click the *Add attachment* button |add attachment| to add another file. #. Click the *Comment* button to save your feedback or click *Cancel* to abort your changes. #. Once you have commented, the author receives a notification about it. #. Click the *Release page* / *Release collection* button to unlock the portfolio for the owner to be able to make changes again. .. note:: |new in Mahara 18.10| :index:`While ` a portfolio is submitted, the portfolio owner cannot delete any feedback from the page.