pages.rst 30.2 KB
Newer Older
1
2
.. include:: /shortcuts.rstext

3
.. index::
4
   single: Portfolio; Page and collections
Kristina Hoeppner's avatar
Kristina Hoeppner committed
5

6
7
.. _page:

8
Pages and collections
9
-------------------------------------------------------
10

11
12
*Portfolio → Pages and collections*

13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
A *page* contains a selection of artefacts which you arrange and present to others. These may include:

* selected files
* résumé details
* text (your added commentary, instructions or orientation)
* journal posts
* video and audio files
* RSS feed to an external blog
* etc.

You can re-use the artefacts that you collected under *Content* in as many pages as you wish.

.. figure:: /images/content_to_pages.*
   :alt: Content in multiple pages

   The same artefacts can appear in multiple pages

Kristina Hoeppner's avatar
Kristina Hoeppner committed
30
.. index::
31
   single: Portfolios; Overview
Kristina Hoeppner's avatar
Kristina Hoeppner committed
32

33
34
35
Overview page
~~~~~~~~~~~~~~

36
On the landing page of *Portfolio*, you can do the following.
37
38

.. figure:: /images/pages_overview.*
39
   :alt: Overview page of "Portfolio"
40
41

   The landing page of your portfolio
42

43
44
45
46
47
48
49
50
51
52
#. Click the *Add* button to start a new page or collection from scratch.

   .. note::
      A modal opens in which you can choose whether to create a page or collection.

      |add page or collection|

#. Click the *Copy* button to choose an existing page or collection of yours or from another user as basis for a new portfolio.
#. **Search**: Type your search term into the search field.
#. Use the drop-down arrow to limit your search. The available options are:
53

54
55
56
57
58
59
60
61
62
63
64
65
   * **Title, description, tags**: Search for your search term in the title, descirption, and tags of your portfolios.
   * **Title, description**: This is the default option. It searches in the title and description of your portfolios.
   * **Tags**: Search only within the tags of your portfolios.

#. **Sort by**: Decide on the sort order in which you wish to display your portfolios.

   * **Alphabetical**: Portfolios are displayed in alphabetical order.
   * **Date created**: List the portfolios in chronologically reverse order with the newest portfolios first.
   * **Last modified**: Display the portfolios in the order of their last modification with the most recent portfolios that have been changed first. This is the default display option.
   * **Last viewed**: Show the portfolios in the order in which they were viewed by you and others starting with the most recently viewed portfolios.
   * **Most visited**: Display the portfolios that have been visited most first in the list.
   * **Most feedback**: List the portfolios in descending order based on the amount of feedback they have received.
66

67
    .. note::
68
       The search option and the sort order that you choose do not change when you navigate away from the overview page or log out. When you change either setting, that new one will be used until you change it again.
69
70
71
72
73
74
75
76
77
78
79
80

#. Click the *Search* button to search your portfolios based on your search term and / or sorting criteria.
#. Click the *Locked* icon |locked| or the *Unlocked* icon |unlocked| to manage the access to your portfolio.
#. Collections display the number of pages that they contain.
#. Click the *More options* icon |more options icon| to reach more options for the page or collection.
#. If you are on a computer, you can hover over the title of a portfolio and see it in its full length if it needed to be shortened.
#. **Dashboard page**: Click the *More options* icon |more options icon| to make changes to your dashboard page. You cannot delete your dashboard page though.
#. **Profile page**: Click the *More options* icon |more options icon| to make changes to your profile page. You cannot delete your profile page, but you can decide on different sharing options.
#. When you submitted a portfolio to a group, you cannot change a great number of the page's content or delete it until the page is released again. It is displayed with a different colored background to differentiate it quickly from non-submitted portfolios.
#. Click the *Show more* button to display more portfolios.

.. index::
81
   single: Portfolio; Icons on the overview page
82

83
Icons on the overview page
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The page and collection information boxes display a number of icons, which are described in more detail here.

Share your portfolio with others
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you have not yet shared your portfolio with somebody else, you see the *Locked* icon |locked|.

.. figure:: /images/portfolio_access_locked.*
   :alt: Ready to share your portfolio with others

   Ready to share your portfolio with others

#. Click the *Locked* icon |locked| to start sharing your portfolio.
#. The icon turns into a downwards facing menu chevron |menu open|. A drop-down menu opens.
#. Click the *Manage access* option to share your portfolio with others on the site. You are taken to the :ref:`Edit access <edit_access>` screen where you can choose with whom to share your portfolio.
#. Click the *Manage secret URLs* option to create a secret URL for your portfolio. You are taken to the :ref:`Secret URLs <secret_url>` screen where you can set up one or more secret URLs.

Review existing sharing permissions
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you already shared your portfolio with others, you see the *Unlocked* icon |unlocked|.

.. figure:: /images/portfolio_access_unlocked.*
   :alt: Review with whom you already shared your portfolio

   Review with whom you already shared your portfolio

#. Click the *Unlocked* icon |unlocked| to see with whom you have already shared your portfolio.
#. The icon turns into a downwards facing menu chevron |menu open|. A drop-down menu opens.
#. Click the *Manage access* option to edit the existing sharing settings for your portfolio. You are taken to the :ref:`Edit access <edit_access>` screen where you can choose with whom to share your portfolio.
#. Click the *Manage secret URLs* option to create or edit a secret URL for your portfolio. You are taken to the :ref:`Secret URLs <secret_url>` screen where you can set up one or more secret URLs.
#. **Friends**: If you shared your portfolio with all your friends.
#. **Registered users**: If you gave all people with an account on your Mahara instance access to your portfolio.
#. **Public**: If you made your portfolio available to everyone on the internet.
#. **Name of a person**: If you shared your portfolio with a specific person.
#. **Group name (Submitted)**: If you submitted this portfolio to a group.
#. **Group name (Admin / Members / Tutors)**: If you shared your portfolio with only a certain type of group members in that group.
#. **Group name**: If you shared your portfolio with an entire group.
#. **Institution name**: If you shared your portfolio with all people in your institution.
#. **Secret URL**: If you set up a secret URL for your portfolio.
#. The drop-down menu has a scrollbar so you can view all people or groups of people with whom you shared your portfolio.

.. note::
   Start or end dates or whether copying is allowed are not displayed in the drop-down menu. You need to go to the :ref:`Share <share>` screen to see that additional information.

Access pages within a collection
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You can view how many pages are part of a collection and what their titles are by clicking the *Pages* icon |collection pages|.

.. figure:: /images/collection_pages.*
   :alt: View a list of pages within a collection

   View a list of pages within a collection

#. Click the *Pages* icon |collection pages|.

   .. note::
      |collection pages icons|

      The icon depends on how many pages are in your collection:

      * 0-2: One sheet of paper.
      * 3-10: Two stacked sheets of paper.
      * 11 or more: Three stacked sheets of paper.

#. The icon turns into a downwards facing menu chevron |menu open|. A drop-down menu opens.
#. If you have a :ref:`SmartEvidence <smartevidence>` collection, you see that listed first with the *SmartEvidence* page icon |SmartEvidence page|.
#. All other pages are are listed with the *Single page* icon |single page|.
#. Click the page you want to view.

More options
^^^^^^^^^^^^^^^^^^^^^^^^

You can find additional options for pages or collections via the *More options* icon |more options icon|.

.. figure:: /images/portfolio_more_options.*
   :alt: More options for pages and collections

   More options for pages and collections

#. Click the *More options* icon |more options icon| to see additional editing options.
#. The icon turns into a downwards facing menu chevron |menu open|. A drop-down menu opens.
#. If you view the options for a collection, click *Manage* |manage pages icon| to add or remove pages from your collection.
#. Click *Edit* |edit icon| to edit the general information of a page or collection such as title, description, and tags.
#. Click *Delete* |delete icon| to :ref:`delete the page <delete_page>` or delete the collection.

   .. note::
      If you delete a collection, the pages and artefacts within it are not deleted.

#. **Created**: The date and time when you set up the page or collection.
#. **Modified**: The last time you made a change to the page or collection.

If you submitted a portfolio, you cannot edit or delete the page or collection until it has been released. Therefore, you don't see those options anymore. However, you see when you submitted the portfolio to which group.

.. figure:: /images/portfolio_more_options_submitted.*
   :alt: See submitted date and group
183

184
   See submitted date and group
185

186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
.. index::
   single: Profile page

Profile page
~~~~~~~~~~~~~~~~~~~~

Your profile page is visible to other users on Mahara by default. If your administrator allowed it, you can also make it visible to anybody on the Internet.

Per default only the following information is put onto your profile page:

* Your display name (or real name if you do not have a display name)
* Your pages that are visible to the person viewing your profile page
* Your groups
* Your wall
* Your friends

We advise you not to use your profile page as your portfolio because you cannot control who can look at the information you make available on your profile. At minimum it is everybody in your institution or who has an account on Mahara. At maximum it can be everybody online. Always remember to think about your own personal security before releasing contact information on a publicly available page or even just for other Mahara users.

.. note::
   Once you have made your profile page or any portfolio page public, Google and other search engines can index and cache it. Even if you take the public access away at some point, the cached version may still be available online. Pages that are made available via a :ref:`secret URL <secret_url>` are not found by search engines unless you link to them from another page.

207
Use regular pages to create your portfolio and your profile page as a business card or brief introduction to you without disclosing lots of details.
208
209
210
211

.. seealso::
   You can edit your profile page like any other page. You can find more information about editing a page in the :ref:`page editor <page_editor>`.

Kristina Hoeppner's avatar
Kristina Hoeppner committed
212
.. index::
213
   single: Portfolio; Add page
Kristina Hoeppner's avatar
Kristina Hoeppner committed
214

215
216
.. _create_page:

217
Add a page
218
219
~~~~~~~~~~~~~~~~~~~~

220
You add a new page in your portfolio when you want to display artefacts together, e.g. for presenting them to others, for showing your progress in a project etc.
221

222
223
.. figure:: /images/portfolio_page_create.*
   :alt: Create a portfolio page
224

225
   Create a portfolio page
226

227
#. On the *Pages and collections* page, click the *Add* button. In the modal that comes up, click the *Page* button. You are taken to the |new in Mahara 17.10| *Settings* :index:`screen <single: New in Mahara 17.10; Page settings on one screen>`.
228
#. **Page title**: Provide a title for your page. This field cannot be left empty. If you do not enter a title, the default "Untitled" will appear.
229
230
231
232

   .. note::
      |new in Mahara 17.10| The page title, description, and tags appear in the *Basics* panel. If you cannot see them, click the |retracted| icon to make them visible.

233
#. **Page description**: Write a brief description summarising your objective of this page. It will appear on the page itself.
234
235
236
237
238
#. **Tags**: Enter tags to find your page 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.

   .. seealso::
      You can find more information on how to use the tag selector in the :ref:`"Tags" section <tag_add>`.

239
#. **Name display format**: Choose how you want your name to appear on the page to others.
240
#. **Anonymise**: If the site administrator allowed :ref:`anonymous pages <anonymous_pages>`, you can choose this option here. Instead of your (display) name, "Author's name hidden" will be displayed to everyone. Administrators and staff can still see your real name.
241
242
#. |new in Mahara 17.10| **Layout**: Click the |retracted| icon to display all layout options. You can :ref:`change the layout <edit_layout>` to decide the overall distributon of your blocks on the page.
#. |new in Mahara 17.10| **Skins**: Click the |retracted| icon to :ref:`select a skin <choose_skin>` for your page.
243
#. Click the *Save* button to save your changes and to continue to the :ref:`Edit content <page_editor>` part.
244

Kristina Hoeppner's avatar
Kristina Hoeppner committed
245
.. index::
246
   single: Portfolio; Edit a page
247
   single: Custom URL for portfolio pages
Kristina Hoeppner's avatar
Kristina Hoeppner committed
248

249
250
.. _custom_page_url:

251
252
Edit an existing page
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
253
254
255

You can edit an existing page in two ways:

256
257
#. Click the *Edit* button |edit| when you are on the *Pages* overview page.
#. Click the *Edit this page* button when you are on the actual page.
258

259
260
261
.. seealso::
   You find more information on how to edit artefacts on a portfolio page in the :ref:`Edit content <page_editor>` part.

262
If the site administrator activated :ref:`clean URLs <clean_urls>`, your portfolio pages have human-readable URLs which you can change to a certain extend.
263
264
265
266
267
268

.. figure:: /images/portfolio_page_clean_url.*
   :alt: Change the URL for your portfolio page

   Change the URL for your portfolio page

269
#. When you are in the page edit mode, click the |new in Mahara 17.10| *Settings* button.
270
271
272
273
274
275
276
277
#. **Page URL**: Choose the name for your page if you do not like the default one. It must be 3-30 characters long. You can only use lowercase letters from a-z, numbers and - (hyphen).
#. Click the *Save* button at the bottom of the page.

.. warning::
   Though you can change the URL to your page at any point, you shouldn't do that because people who already know the URL to your page will not be able to access it anymore after you have changed it.

   The original, internal Mahara URL, e.g. ``http://mahara-university.org/view/view.php?id=789`` will still work.

278
.. index::
279
  single: Portfolio; Add collection
280

281
282
.. _add_collection:

283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
Add a collection
~~~~~~~~~~~~~~~~~~~~

If you want to organize your portfolio into multiple pages so as to find individual sections more easily, you can create a collection that holds multiple pages.

.. figure:: /images/collection_create.*
  :alt: Create a collection

  Create a collection

#. On the *Pages and collections* page, click the *Add* button. In the modal that comes up, click the *Collection* button. On the next screen...
#. **Collection name**: Provide a title for your collection.
#. **Collection description**: Optionally, you can write a short description about your collection. You do not have a visual editor, but just a plain text box.
#. **Tags**: :index:`Enter tags <single: Tags on collections>` to find your collection 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.
#. **Page navigation bar**: Choose whether you wish to display a tabbed navigation or not. If you choose not to, you will have to include the :ref:`navigation <navigation_block>` block for you to go from one page to the next on the individual pages that belong to this collection.
#. **SmartEvidence framework**: Select the framework that you want to associate with your collection. You can change the collection as long as you have not put an annotation onto a page within the collection.

   .. note::
      This functionality is available if your institution administrator allowed the use of SmartEvidence.

#. Click the *Next: Edit collection pages* button or click *Cancel* if you want to abort adding your collection.

.. index::
  single: Portfolio; Add pages to a collection

Add pages to a collection
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In the next step after you have created your collection, you choose which portfolio pages you wish to include in this collection. You see all the potential pages that you can use. If you had already placed a page into another collection, it is not shown here.

.. figure:: /images/collection_add_pages.*
  :alt: Edit collection pages

  Add pages to a collection

#. On *Portfolio → Pages and collections*, click the *More options* icon |more options icon| for the collection and then the *Manage* icon |manage pages icon|. On the next screen...
#. Put a check mark next to each page that you wish to include in your collection.
#. Alternatively, :index:`you <single: Select all pages at once to be added to a collection>` can click the *All* link to add all pages available to the collection or the *None* link to revert your selection.
#. Click the *Add pages* button to add the pages to your collection.
#. :index:`If <single: Drag and drop pages into a collection>` you do not wish to click all pages, you can also drag and drop them into the collection by clicking their title and dragging them to the area *Pages already in collection*.
#. :index:`A dotted line <single: Drag and drop pages within a collection to sort them>` shows you where you can drag your page so you can already drag the pages into the collection in the order that you prefer.
#. Click the *Done* button to finish this step.

.. index::
  single: Portfolio; Manage pages in a collection

Manage pages in a collection
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Once you have added your pages to your collection. You can move them around or remove them.

.. figure:: /images/collection_manage.*
  :alt: Manage collection pages

  Manage the pages that are displayed within your collection

#. If you are not already in the page management, click the *More options* icon |more options icon| for the collection and then the *Manage* icon |manage pages icon|. On the next screen...
#. Use the *Move up* |move_up| and *Move down* |move_down| buttons to arrange your pages in a different order. Alternatively, you can drag and drop the pages within the list.
#. Click the *Remove* icon |remove| to take a page out of a collection. The page itself is not deleted.
#. Put a check mark next to each page that you wish to include in your collection in addition to the ones already in it.
#. Click the *Add pages* button to add the pages to your collection and then move them around with the *Move up* |move_up| and *Move down* |move_down| buttons. Alternatively, you can drag and drop the pages to the position where you would like to have them in the list.
#. Click the *Done* button.

When you add pages to your collection that have different access permissions than the collection has, the page's access permissions get added to the collection and the page is available under the same access permissions as the entire collection because it is part of the collection.

.. figure:: /images/collection_manage_warning.*
  :alt: Notice about changing permissions

  Notice about changes in permissions

:index:`If <single: Warning about changes in access permissions when adding pages to collection>` there is a change in access permissions, a warning will be displayed so that you are informed that changes have taken place.

View your collection by clicking on the collection title or any page that is part of your collection.

357
358
359
.. note::
   |New in Mahara 17.10| :index:`On <single: New in Mahara 17.10; Swipe to navigate through collection>` a mobile device, you can swipe left and right to navigate through a collection when it has the page navigation bar.

360
361
362
.. figure:: /images/collection_result.*
  :alt: The finished collection

363
  A collection with the page navigation bar
364
365
366
367
368
369

#. Title of the collection.
#. Title of the page you are currently viewing.
#. *Previous page* button to navigate to the previous page.
#. *Next page* button to navigate to the next page.
#. *Navigate to* drop-down menu: Select the page to which you want to jump within the collection.
370

371
.. index::
372
373
374
375
376
377
378
   single: Portfolio; Copy portfolio
   single: Copy; Portfolio

Copy a portfolio
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You can copy a portfolio by:
379

380
381
382
383
* Clicking the *Copy* button when you view a portfolio and are allowed to copy it.
* Searching for it.

Copy a portfolio directly from its location
384
385
386
387
388
389
390
391
392
393
394
395
396
397
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You can copy a page or collection directly when you view it by clicking the *Copy* button when you see it. The button is displayed on your own pages and collections as well as on pages and collections owned by others when you have the permission to copy them.

.. figure:: /images/copy_page_collection.*
   :alt: Copy a page or collection

   Copy a page or collection

#. Click the *Copy* button when you want to copy a page or collection that you can duplicate.
#. If the page is part of a collection, you need to decide in the pop-up window whether you want to copy the entire collection by clicking the *Collection* button...
#. Or just the page that you can see currently by clicking the *Page* button.
#. Edit the page or collection as you would do any other.

398
Copy a portfolio by searching for it
399
400
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

401
402
You can duplicate your own pages or pages of other users if they allowed you to do that.

403
404
.. figure:: /images/portfolio_copy.*
   :alt: Copy a portfolio
405

406
   Copy a portfolio
407

408
#. Click the *Copy* button under *Portfolio → Pages and collections*. On the next screen...
409
#. **Search**: If there are many pages or collections from which you can choose, search here for a keyword in the page or collection title or for the name of the page owner.
410
#. **Collection title**: Click on the title of a collection to preview it before copying it.
411
412

   .. note::
413
      Results are listed alphabetically according to their collection title.
414

415
#. **Page name**: Click on the title of the page to see a preview of it before you copy it.
416
#. **Owner**: Click on the name of the owner to view a larger profile picture and the self description if the owner provided one or to see information about a group it that is the owner.
417
418
419
420

   .. note::
      |page owner info|

421
422
#. Click the *Copy page* button to copy one page only into your own portfolio **or**
#. Click the *Copy collection* button to copy an entire collection with multiple pages into your portfolio. All pages within this collection are copied.
423
424
#. You can navigate through the list of pages and collections to which you have access.
#. You see the total number of pages you can copy.
425
426
#. **Results per page**: Use this drop-down menu to change how many results you want to see per result page.
#. Edit the portfolio.
427
428

.. note::
429
   If your copied pages and collections start with "Copy of", the site administrator decided to have :ref:`copies renamed <config_variable_renamecopies>`.
430

Kristina Hoeppner's avatar
Kristina Hoeppner committed
431
.. index::
432
   single: Portfolio; Display page
Kristina Hoeppner's avatar
Kristina Hoeppner committed
433

434
435
.. _view_page:

436
437
438
View a page
~~~~~~~~~~~~~~

439
You can view a page to check what it looks like when somebody else sees it. Go to the *Pages and collections* overview page and click on the title of a page.
440

441
442
.. figure:: /images/portfolio_page.*
   :alt: A finished portfolio page
443

444
   An example portfolio page.
445

446
447
#. Title of the portfolio page.
#. Author of the portfolio page.
448
#. Tags which you provided for your page.
449
#. Description of the page.
450
451
#. The *Edit this page* button |edit this page| is only visible if you are the page owner or belong to a group of users who can make changes to the page if it is in a group, institution or site level.
#. :index:`The <single: Copy button directly on a page / collection that you can copy>` *Copy* button |copy this page| is visible when you can copy the page or collection that you are viewing. You see it on your own pages as well as pages of others.
452
#. :index:`Click <single: Page; Lesser used functionality on a page is accessible via a button>` the *More options* button |three dots| to reach lesser used functionality on a page.
453
454

   .. note::
455
      On your own pages you can:
456

457
458
      |three dots expanded author|

459
460
      * Click the *Print* link |print icon| to open the print dialogue. Using this print functionality, your portfolio pages are printed in the current layout, with collapsed blocks or artefacts uncollapsed so you can see their content easily. Note: Links are not yet active and linked files or embedded media are not accessible.
      * Click the *Delete* link |delete icon| to delete your page.
461
462

      As someone viewing another person's portfolio, you can:
463
464
465

      |three dots expanded|

466
467
468
      * Add or remove a page from your watchlist: Click the *Add page to watchlist* link if you want to be informed when changes are made to the page. When you make changes to the page or a block on the page, a notification is triggered and sent to anyone who is watching the page. :index:`This <single: Trigger watchlist notification when journal entry is added to a journal in a page>` is also the case when you add a new journal entry to a journal that is displayed on your page even when you do not add the entry via the page. If you no longer wish to receive these notifications, remove the page from your watchlist by clicking the link *Remove page from watchlist*.
      * Report objectionable content for this page: If a page contains offensive artefacts, you can report them to the administrator and provide an explanation why you think the content is offensive.

469
      These functionalities are only available on other people's pages as they are not needed on your own.
470

471
#. The artefacts that you placed in the page.
472
#. Click the *Add a comment* link |add a comment| to be taken to the *Details* page for this artefact to leave a comment.
473
#. Click the *Details* icon |details| to be taken to the *Details* page for this artefact if there is one.
474
#. If you belong to a group which allows the submission of pages for feedback / assessment, you see the group displayed here or can choose it from the drop-down menu and can submit your page directly from here. For more information see the section on :ref:`feedback for assessment <submit_page>`.
475
#. Comments from users is displayed at the bottom of the page unless you display it with the :ref:`comments block <comments_block>` elsewhere on the page. Each comment includes:
476
477

   * Profile picture and name of the commentator that are linked to the profile page.
478
   * The comment itself.
479
480
   * The creation date of the comment and potentially the last update date and time of the comment.
   * Comment rating.
481
   * Any attachments.
482
   * A note if the comment is private only to the commentator and the portfolio page author.
483

484
   .. note::
485
      For more information on giving and receiving comments, please see section :ref:`Feedback <feedback>`.
486
487
488

#. The total number of comments is displayed.
#. You and others can use the *Add comment* section to leave comments on the page.
489
490

   .. seealso::
491
      Please refer to the section on :ref:`making comments <add_comment>` to see how that can be done.
492

493
#. Display the last update date and time of the page.
494
#. View how many times your page was accessed.
495

496
.. index::
497
   single: Portfolio; Share
498

499
500
Give others access to your portfolio
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Kristina Hoeppner's avatar
Kristina Hoeppner committed
501

502
.. seealso::
Kristina Hoeppner's avatar
Kristina Hoeppner committed
503
   Please refer to the section on :ref:`sharing your pages and collections <share>` for further information.
504
505

.. index::
506
   single: Portfolio; Delete a portfolio
507

508
509
510
.. _delete_page:

Delete a portfolio
511
512
~~~~~~~~~~~~~~~~~~~~~~~

513
You can delete a portfolio at any time unless it has been :ref:`submitted for feedback <submit_page>`.
514
515

.. warning::
516
517
518
519
   When you delete a **page**, :ref:`text blocks <text_block>` and :ref:`external content blocks <external_content>` are completely deleted. You cannot recover them. There is no revision history. All other artefacts are not deleted because they reside in your *Content* area.

   When you delete a **collection**, the pages and artefacts within it are not deleted.

520
If you are allowed to delete a page, you see the *Delete this page* option |delete icon| in the *More options* button |three dots| when you view your page directly.
521
522
523
524
525
526
527
528
529
530
531
532

.. figure:: /images/page_delete_link.*
  :alt: Click the "More options" button to find the "Delete" option

  Click the "More options" button to find the "Delete" option

If you want to delete an entire collection, you can do so on *Portfolio → Pages and collections* by clicking the *More options* icon |more options icon| and then the *Delete* icon |delete icon|.

.. figure:: /images/collection_delete.*
  :alt: Delete a collection

  Delete a collection
533

534
When you attempt to delete a page or collection, you get the chance to :ref:`export the portfolio <export>` first so that you can make an archive. :index:`If your page is part of a collection <single: Warning when deleting a page that is in a collection>`, the warning message also contains the title and a link to the collection for you to check whether you really want to delete the page and thus make changes to your collection.
535
536
537
538
539
540

.. figure:: /images/delete_page_in_collection.*
   :alt: Warning when you attempt to delete a page that is in a collection

   Warning when you attempt to delete a page that is in a collection

541
542
543
544
#. The title of the portfolio you are about to delete is displayed so you can double-check it is the correct one.
#. An explicit warning about the deleting of the portfolio is displayed. Deletion cannot be undone.
#. If you delete a page that is part of a collection, the collection is linked so you can view your collection and double-check deleting of the page is OK.
#. If you want to continue deleting your portfolio, you may want to export it first so you have a copy in case you do need it later again. Click the export link to be taken to the options for the :ref:`export <export>`.
545
546

   .. note::
547
      We recommend you export your portfolio in both HTML and Leap2A formats so that you can view them without the need of Mahara (HTML) or can import them back into the same or another Mahara instance or another portfolio software that supports the Leap2A format.
548

549
#.  Click the *Yes* button if you want to continue with the portfolio deletion or the *No* button if you want to keep it.