.. index:: Share .. _share: Share ------- When you have created portfolio pages (and collections), you may wish to share them with others, e.g. to receive feedback. You can set the access permissions on the *Edit access* page. It is accessible via *Portfolio* -> *Share* or directly from the :ref:`page editor ` when you edit a portfolio page. The *Share* overview page shows you the following: #. Your collections and pages sorted alphabetically. #. The list of users and or groups who have access to a particular collection or page. #. The *Edit Access* button |edit_access| which allows you to change the permission of who can view a page or collection. #. The *Secret URL* edit button |edit| which allows you to set up one or more :ref:`secret URLs ` for a page or collection. The number of secret URLs that you have generated is displayed next to the button. .. figure:: /images/share_overview.* :alt: Share overview page Share overview page .. index:: pair: Share; Edit access Edit access for users with an account ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The *Edit Access* page allows you to set the permissions for a single user or multiple users for if and when they should be able to view your portfolio pages or collections. You can assign access to a single page or collection at a time or to multiple pages and / or collection at once. .. figure:: /images/share_access_users_groups.* :alt: Edit access permissions Users and groups to whom you can give access to pages and / or collections You have a number of choices of selecting who shall be able to see what: #. Choose the *collection* or collections for which you want to give access. If you made a mistake in your selection, either take the checkmark off or select *All* or *None* to check or clear all respectively. #. Choose the *page* or pages for which you want to give access. If you made a mistake in your selection, either take the checkmark off or select *All* or *None* to check or clear all respectively. #. **Public**: anybody online who knows the URL(s) can see your selection of pages / collections. #. **Logged-in users**: all users who have an account on the Mahara instance you are using can view your selection of pages / collections. #. **Friends**: all your friends on Mahara can view your selection of pages / collections. #. **All my groups**: every member in the groups to whom you belong can view your selection of pages / collections. #. A particular group: all members of that group can view your selection of pages / collections. #. If none of the above choices are what you are looking for, you can search for specific users or groups. Make your selection. #. Type the name of the user or the name of the group you search for. A partial name is often best. #. Add the user or group. You can click on the name of the user or group to verify that it is the correct one. .. note:: Your friends or individual users with whom you shared your pages / collections receive a notification. Group members also receive a notification that you shared a page with them if the group administrator :ref:`allowed that `. You do not receive a notification when a user shared his page with the public or al logged-in users. .. index:: pair: Share; Restrict access Restrict access based on time ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ In addition to controlling who shall have access to your pages / collections, you can further restrict that access for a specific period of time. .. figure:: /images/share_access_time.* :alt: Restrict access time Restrict access to your pages / collections further #. Each user or group of people can receive their own time restrictions that are independent of other access groups. You can specify a start date. #. You can also specify an end date. #. You can click the *Remove* button |remove| to completely take a user group off your access list. .. index:: pair: Share; Advanced options .. _share_advanced_options: Choose advanced options ~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can choose a number of additional options which are applied to all pages and / or collections that are selected. .. figure:: /images/share_access_options.* :alt: Advanced access options Advanced options for editing access to pages / collections #. **Allow comments**: This check box is selected by default to encourage you to allow others to comment on your pages. #. **Moderate comments**: If you wish to see any comment before it is made public, i.e. can be see by others who have access to the page on which the comment is made, place a check mark here. #. **Allow copying**: Place a check mark in this box if you want to allow the users who can view your page to make a copy of it for themselves. Any text box content, files and folders will be transferred to their portfolio. For journals you decide whether they can copy them or not. Profile information, plans and résumé information are not copied. #. **Overriding Start / stop dates**: Here you set the time frame for when all users who have access to your page / collection can view your page. The dates here override any individual dates you may have set. If you have not allowed copying in general, you can still choose to allow comments for a certain person or group of people who are in your access list. That way you can regulate very flexibly who shall be able to place comments on a page / collection and who cannot. .. figure:: /images/share_access_comments.* :alt: Comments per user Allow comments on a user-by-user basis .. note:: If you edit an institution page, you see an additional option when you allowed copying. With this option you can place a page directly into the portfolio of a new user. Existing users still have to copy the page themselves. .. index:: pair: Share; Secret URL .. _secret_url: Edit access for users with no account ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Besides giving users who have a login or the entire public access to your portfolio, you can also give users who do not have an account on Mahara access to your portfolio pages and / or collections without making your work publicly available and searchable by search engines. This can be interesting, e.g. * when you create a portfolio for a job application and the prospective employer does not have a login and cannot get one. * when you want to share your portfolio with your parents and also get feedback from them. * when an external assessor shall evaluate your work. You can create a secret URL the following way when you are on the :ref:`share overview page ` and click on the *Edit* button |edit|: #. Click the *Add* button to generate a new secret URL. #. You can now copy this URL and put it into an email to send to somebody. #. You can click on the *Edit* button |edit| to add a time restriction for access to your page / portfolio via this URL and then click the *Save* button. #. Click on the *Delete* button |remove| if you do not want to use this secret URL anymore. #. Click on the *Add* button to generate another secret URL for this page to which you can assign different time restrictions. .. figure:: /images/share_secreturl_add.png :alt: Add a secret URL Add one or more secret URLs to a page or collection .. note:: Logged-out users or those who do not have an account can only leave comments on public pages or pages which they can access via a secret URL if the site administrator turned on the *Anonymous Comments* function under *Site Administration* -> *Configure Site* -> *User Settings*. .. |edit_access| image:: /images/buttons/edit_access.* .. |edit| image:: /images/buttons/edit.* .. |remove| image:: /images/buttons/remove.*