.. index:: Collection
   pair: Collection; Portfolio

.. _collections:

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.

.. index::
   pair: Collection; Add

Add a collection
~~~~~~~~~~~~~~~~~~~~

You add a collection under *Portfolio* -> *Collections*.

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

   Create a collection

#. Click the *New Collection* button.
#. On the next screen, provide a title for your collection.
#. Optionally, you can also write a short description about your collection. You do not have a visual editor, but just a plain text box.
#. 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 so that you can go from one page to the next.
#. Click the *Next: Edit Collection pages* button.

.. index::
   pair: Collection; Edit

Edit 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::
   pair: 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::
   pair: Collection; Manage collections

Manage your collections
~~~~~~~~~~~~~~~~~~~~~~~~~~~

On the overview page of the collections, you can:

#. Create a new collection by clicking on the *New Collection* button.
#. Click on the collection title to go to the first page of a 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.

.. figure:: /images/collection_overview.*
   :alt: Overview page for collections

   Collections overview page

.. index::
   pair: Collection; Share

Give others access to your collection
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. seealso:: Please refer to the section on :ref:`sharing your pages and collections <share>` for further information.


.. |delete| image:: /images/buttons/remove.*
.. |edit| image:: /images/buttons/edit.*
.. |manage| image:: /images/buttons/manage.*
.. |move_down| image:: /images/buttons/move-down.*
.. |move_up| image:: /images/buttons/move-up.*