.. include:: /shortcuts.rstext .. index:: single: Portfolio; Collection .. _collections: Collections ------------ *Portfolio → Collections* A *collection* is a set of pages that are linked to one another and have the same access permissions. You can create as many collections as you like, but a page cannot appear in more than one collection. You can create a collection from scratch or copy an existing one - either one of your own or one from another user that is copyable to you. .. index:: single: Collection; Manage collections Manage your collections ~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you are on the overview page of the collections you can do several things. .. figure:: /images/collection_overview.* :alt: Overview page for collections Collections overview page #. Create a new collection by clicking on the *New collection* button. #. Copy an existing collection by clicking on the *Copy a collection* button. #. Click on the collection title to go to the first page of the collection. #. Click on any title of a page within a collection to jump directly to it. #. Click on the *Manage* button |manage| to move pages within a collection, add to or delete pages from a collection. #. Click on the *Edit* button |edit| to change the title and description of a collection. #. Click on the *Delete* button |delete| to delete the collection. The pages will still exist. .. index:: single: Collection; Add collection Add a collection ~~~~~~~~~~~~~~~~~~~~ .. figure:: /images/collection_create.* :alt: Create a collection Create a collection #. Click the *New collection* button under *Portfolio → Collections*. #. **Collection title**: On the next screen, provide a title for your collection. #. **Collection description**: Optionally, you can also write a short description about your collection. You do not have a visual editor, but just a plain text box. #. **Page navigation**: Choose whether you wish to display a tabbed navigation or not. If you choose not to, you will have to include the :ref:`navigation ` block for you to go from one page to the next. #. Click the *Next: Edit collection pages* button. .. index:: single: Collection; Copy collection single: New in Mahara 1.5; Copy collection |new15| Copy a collection ~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can duplicate your own collections or collections of other users if they allowed you to do that. As every page can only be in one collection at a time, your own pages will be copied when you copy a collection. .. figure:: /images/collection_copy.* :alt: Copy a collection Copy a collection #. Click the *Copy a collection* button under *Portfolio → Collections*. #. **Search pages and collections**: If there are many collections from which you can choose, either search for a keyword in the collection title or #. **Search owners**: Search for the author of the collection. #. **Collection title**: Click on the title of the collection 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. #. Click the *Copy collection* button to copy the collection into your own portfolio. #. Edit the collection and its pages as you would do any other collection or page. .. note:: |new15| 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. .. seealso:: You can `watch a demo of this feature `_ in action. .. index:: single: Collection; Add pages Add collection pages ~~~~~~~~~~~~~~~~~~~~~ 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 pages that you can use potentially. If you had already placed a page into another collection, it is not an option here. .. figure:: /images/collection_add_pages.* :alt: Edit collection pages Add pages to a collection #. Put a check mark next to each page that you wish to include in your collection. #. Click the *Add pages* button to add the pages to your collection. #. Click the *Done* button to finish this step. .. index:: single: Collection; Manage pages Manage collection pages ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 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 #. Use the *move up* |move_up| and *move down* |move_down| buttons to arrange your pages in a different order. #. Click the *Remove* button to take a page out of a collection. The page itself is not deleted. #. Click the *Save* button. You can add more pages to a collection from the *Add pages to collection* box. .. figure:: /images/collection_result.* :alt: The finished result A collection with the tabbed navigation .. index:: single: Collection; Share Give others access to your collection ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. seealso:: Please refer to the section on :ref:`sharing your pages and collections ` for further information.