.. include:: /shortcuts.rstext .. index:: single: Portfolio; Page .. _page: Pages ------- *Portfolio → Pages* 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 .. index:: single: Page; Overview single: Flexibility in number of portfolio pages shown on overview page Overview page ~~~~~~~~~~~~~~ On the landing page of the portfolio, you can do the following. .. figure:: /images/pages_overview.* :alt: Overview pages of "Portfolio" The landing page of your portfolio #. Click the *Create page* button to start a new page from scratch. #. Click the *Copy a page* button to choose an existing page of yours or from another user as basis for a new page. #. **Search**: Enter your search term that you want to search for within your portfolio pages. #. Decide whether you want to search within the title, description and tags or just within the tags that you associated with a page. #. |new in Mahara 1.10| **Sort by**: :index:`Decide ` on the sort order in which you wish to display your pages. * None (blank): The default sort order lists the dashboard and profile pages before all other pages. Pages are displayed in alphabetical order. * Date created: List the pages in chronologically reverse order with the newest pages first. * Last modified: Display the pages in the order of their last modification with the most recent pages that have been changed first. * Last viewed: Show the pages in the order in which they were viewed by you and others starting with the most recently viewed pages. * Most visited: Display the pages that have been visited most first in the list. * Most feedback: List the pages in descending order based on the amount of feedback they have received. #. Click the *Search* button to search your pages based on your search and / or sorting criteria. #. Click the *Edit* button |edit| to make changes to your dashboard page. You cannot delete your dashboard page. #. Click the *Edit* button |edit| to make changes to your profile page. You cannot delete your profile page. #. Click the *Edit* button |edit| to update your portfolio pages. #. Click the *Delete* button |delete| to remove your pages. #. When you submitted a portfolio page to a group, you cannot change a great number of the page's content or delete it until the page is released again. #. You can choose how many portfolio pages you wish to display on the overview page at once. Your options are 10, 20, 50, 100 or 500 results. All remaining pages can be reached via the pager. .. 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 ` are not found by search engines unless you link to them from another page. Use regular pages to create your portfolio, and then use your profile to make these pages accessible to other people and to establish your digital identity. .. 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 `. .. index:: single: Page; Create .. _create_page: Create a new page ~~~~~~~~~~~~~~~~~~~~ You create a new page in your portfolio when you want to display artefacts together, e.g. for presenting it to others, for showing your progress in a project etc. .. figure:: /images/portfolio_page_create.* :alt: Create a portfolio page Create a portfolio page #. On the *Pages* page, click the *Create page* button. #. **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. #. **Page description**: Write a brief description summarising your objective of this page. It will appear on the page itself. #. **Tags**: Enter tags to find your page 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 page as well. They will be entered into the text field for you. #. **Name display format**: Choose which of your names you want to appear on the page as author. #. |new in Mahara 1.10| **Anonymise**: :index:`If ` the site administrator allowed :ref:`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. #. Click the *Save* button to save your changes and to continue to the :ref:`Edit content ` part. .. index:: single: Page; Edit single: Custom URL for portfolio pages .. _custom_page_url: Edit an existing page ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can edit an existing page in two ways: #. 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. .. seealso:: You find more information on how to edit artefacts on a portfolio page in the :ref:`Edit content ` part. If the site administrator activated :ref:`clean URLs `, your portfolio pages have human-readable URLs which you can change to a certain extend. .. figure:: /images/portfolio_page_clean_url.* :alt: Change the URL for your portfolio page Change the URL for your portfolio page #. When you are in the page edit mode, click on *Edit title and description*. #. **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. .. index:: single: Page; Copy page single: Copy page Copy a page ~~~~~~~~~~~~ You can duplicate your own pages or pages of other users if they allowed you to do that. .. figure:: /images/page_copy.* :alt: Copy a page Copy a page #. Click the *Copy a page* button under *Portfolio → Pages*. On the next screen... #. **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 |new in Mahara 1.10| :index:`the name of the page owner `. #. **Collection title**: Click on the title of a collection to preview it before copying it. #. **Page name**: Click on the title of the page to see a preview of it before you copy it. .. note:: The sort order on the screen is according to page names in alphabetical order. #. **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. #. 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. #. Edit the page as you would do any other page. .. note:: The site administrator can decide to leave out "Copy of..." for copied pages or collections. This setting needs to be made in the config.php file. If ``$cfg->renamecopies = false;``, copies of new pages and collections will not have "Copy of" prepended to their titles. .. index:: single: Page; Display page .. _view_page: View a page ~~~~~~~~~~~~~~ You can view a page to check what it looks like when somebody else sees it. Go to the *Pages* overview page and click on the title of a page. .. figure:: /images/portfolio_page.* :alt: A finished portfolio page An example portfolio page. When you are the author, you can click the *Edit* button and make changes. #. Title of the portfolio page. #. Author of the portfolio page. #. Description of the page. #. The *Edit this page* button is only visible to you as portfolio author. #. The artefacts that you placed in the page. #. |new in Mahara 1.10| :index:`Click ` the *Details* icon |details| to be taken to the *Details* page for this artefact if there is one. #. |new in Mahara 1.10|:index:`Click ` the block title or the *Retracted* icon |retracted| to show the entire block content. Click the block title again or the *Retractable* icon |retractable| to only show the block title. #. Tags which you provided for your page. #. 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 `. #. Feedback from users is displayed at the bottom of the page unless you display it with the :ref:`feedback block ` elsewhere on the page. Each feedback includes: * Profile picture and name of the commentator that are linked to the profile page. * The feedback itself. * The creation date of the feedback and potentially the last update date and time of the feedback. * Feedback rating. * Any attachments. * A note if the feedback is private only to the commentator and the portfolio page author. #. If you (owner) or the commentator (author) removed feedback, this is mentioned. #. Your commentators can give a rating in addition to their written feedback if the site adminstrator enabled :ref:`comment ratings `. #. If feedback is set to "private" by the feedback author, you can decide to make it public by clicking the *Make public* button. #. You and the feedback author can delete feedback by clicking the *Delete* button |delete|. The feedback text is not displayed anymore, but a line is still visible where the old feedback was so you know that you deleted feedback. In addition, if you delete the feedback by someone else, they will receive a notification about it, which includes their feedback text. #. Your commentators can upload one or more files in addition to their written feedback, e.g. a file with inline comments, an audio or video file with feedback. #. The total number of individual pieces of feedback is displayed. #. You and others can use the *Place feedback* link to leave feedback on the page. .. seealso:: Please refer to the section on :ref:`giving feedback ` to see how that can be done. #. If a page contains offensive artefacts, users can report them to the administrator by clicking the *Report objectionable material* link. #. Click the *Print* link to print the page. #. Click the *Add page to watchlist* link if you want to be informed when changes are made to the page. #. View how many times your page was accessed. .. index:: single: Page; Share Give others access to your page ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. seealso:: Please refer to the section on :ref:`sharing your pages and collections ` for further information. .. index:: single: Page; Delete Delete a page ~~~~~~~~~~~~~~~~~~~~~~~ You can delete a page at any time unless it or a collection it is in has been :ref:`submitted for feedback `. .. warning:: When you delete a page, links to external content such as embedded external videos and RSS feeds to an external blog 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 attempt to delete a page, you get the chance to :ref:`export the page ` first so that you can make an archive. :index:`If your page is part of 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. .. 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 #. The title of the page you are about to delete is displayed so you can double-check it is the correct one. #. The collection of which the page is a part of is displayed, and you can use the link to view your collection. #. If you want to continue deleting your page, 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 `. .. note:: We recommend you export your portfolio pages / collections 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. #. Click the *Yes* button if you want to continue with the page deletion or the *No* button if you want to keep your page.