.. 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: New in Mahara 1.6; 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 another user as basis for a new page. #. **Search**: Enter your search term and decide in which context you wish to search it for within your portfolio. Click the *Search* button to start your search. #. 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. #. |new in Mahara 1.6| 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: 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. #. Click the *Save* button to save your changes and to continue to the :ref:`Edit content ` part. .. index:: single: Page; Edit single: New in Mahara 1.6; Custom URL for portfolio pages .. _custom_page_url: Edit an existing page ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can edit an existing page in two ways: #. Click on the *Edit* button |edit| when you are on the *Pages* overview page. #. Click on 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. .. warning:: Links to external content such as embedded external videos and RSS feeds to an external blog are completely deleted when you remove the respective blocks from your portfolio page. You cannot recover them. There is no revision history. All other artefacts are not deleted when you remove them from a page because they reside in your *Content* area. |new in Mahara 1.6| 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 pages**: If there are many pages or collections from which you can choose, either search for a keyword in the page or collection title **or** #. **Search owners**: Search for the author of the page. This can be a user, a group or an institution. #. **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. #. **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 = true;``, copies of new pages and collections will have "Copy of" prepended to the title. .. 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 on 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 the portfolio author. #. The artefacts that have been placed in the page. #. 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 name displayed and can submit your page directly from here. For more information see the section on :ref:`feedback for assessment `. #. Feedback area at the bottom of each page displays comments from users. #. You and others can use the *Place feedback* link to leave comments on the page. #. If a page contains offensive artefacts, users can report them to the administrator by clicking on 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. .. 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.