.. include:: /shortcuts.rstext .. index:: single: Portfolio; Share single: Portfolio; Shared by me .. _share: Shared by me --------------- *Portfolio → Shared by me* 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 → Shared by me* or directly from the :ref:`page editor ` when you edit a portfolio page. The *Share* overview page shows you the following. .. figure:: /images/share_overview.* :alt: Share overview page Share overview page #. **Collections**: Your collections are sorted alphabetically. #. **Pages**: Pages that are not in a collection are listed alphabetically below the collections. #. **Access list**: The list of users, groups or institutions who have access to a particular collection or page. #. **Edit access**: The *Edit access* button |edit_access| next to each collection or page allows you to change the permission of who can view a page or collection. #. **Secret URLs**: The *Secret URL* edit button |secret_url| next to each collection or page 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. .. index:: single: Share; Edit access single: Share with institution single: Search for friends on "Edit access" single: Share with "Favourite users" Edit access for users with an account ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The *Edit access* page allows you to set the permissions for a single user or multiple users who should be able to view some of your portfolio pages or collections. You can assign access to a single page or collection at a time or to multiple pages and / or collections 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 for selecting who shall be able to see what. Always click the *Add* button if you want to add a group of people or an individual. #. Click the *Edit access* button |edit_access| next to the collection or page for which you want to give access permissions under *Portfolio → Shared by me*. On the next screen... #. Choose the collection or collections for which you want to give access by placing a check mark in the checkbox next to it / them. If you made a mistake in your selection, either take the check mark off or click *Select all* or *Select none* to check or clear all respectively. #. Choose the page or pages for which you want to give access by placing a check mark in the checkbox next to it / them. If you made a mistake in your selection, either take the check mark off or click *Select all* or *Select none* to check or clear all respectively. #. **Public**: Anybody online who knows the URL(s) can see your selection of pages / collections. .. note:: This option is only available if the site administrator allowed public pages under *Administration → Site options →* :ref:`General settions ` *→ Allow public pages*. If you are on a multi-tennanted site, the institution administrator must also allow public pages in the :ref:`institution settings `. #. **Registered 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. #. **Share with my institutions**: Select your institution(s) with which you want to share your selection of pages / collections. This will allow all members in these institutions to have access to this selection. #. **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 to search for: * Your friends * Any group * Any user #. Type the name of the user or the name of the group you search for. Searching for the first name or last name instead of both names is often best. #. Click the *Go* button to search for that person or group. #. Click on the name of the user or group to verify that it is the correct one. When you clicked on the name of the user or group and want to get back to the access list, close the window. #. Click the *Add* button |add| next to the user(s) or group(s) to whom you wish to give access. #. Click the *Save* button to keep your changes or click the *Cancel* button to abort the action. .. 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 `. :index:`You as page author ` and member of the group with which you shared your pages / collections do not get notified. You do not receive a notification when users share their page with the public, all registered users, an entire institution or friends. .. seealso:: If you use the `web services plugin `_, you can also share pages with "favourite users". For more information, please `refer to the specifications for this feature `_. .. index:: single: Share; Profile page access single: Edit access to profile page Edit access to your profile page ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can restrict full access to your profile page to the members of your institution if the site administrator allowed that in *Administration → Configure site →* :ref:`User settings ` *→ Profile access for all registered users*. If you allow only members of your own institution(s) to see your profile page, other users who have an account can only see basic information, e.g. your name, your institution membership and messaging information. .. figure:: /images/profile_restricted.* :alt: Restricted view of a profile Restricted view of a profile .. index:: single: Share; Time-based 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 type the date and time in the format YYYY/MM/DD HH:MM or click the *Calendar* button |calendar| to select the date. #. You can specify an end date by typing it in manually or selecting it via the *Calendar* button |calendar|. #. You can click the *Remove* button |delete| to completely take a user group off your access list. .. index:: single: Share; Advanced options single: Automatic access to copied page or collection .. _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 checkbox 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 / collection to make a copy of it for themselves. Any *Text* or *Note* block content, files and folders will be transferred to their portfolio. For journals or journal entries :ref:`you decide separately whether they can copy them or not ` via the *Block copy permission*. Profile information, plans and résumé information are not copied. .. seealso:: Check the :ref:`blocks which can be copied `. #. **Retain view access on copied pages or collections**: This option only becomes available when you put a check mark next to the option *Allow copying*. When you tick this checkbox, you as owner of the page / collection will have access to the copied page / collection automatically. However, the owner of the copied page / collection can take that access away at any time. #. **Overriding start / stop dates**: 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. You can type the date and time in the format YYYY/MM/DD HH:MM or click the *Calendar* button |calendar| to select the date. #. Click the *Save* button to keep your changes or click the *Cancel* button to abort the action. If you have not allowed comments in general, you can still choose to allow them 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 or site page, you see the additional option *Copy for new institution members* / *Copy for new members* when you allowed copying. With this option you can place a page or collection directly into the portfolio of a new user. Existing users still have to copy the page or collection themselves. .. index:: single: Share; Secret URL .. _secret_url: Edit access for users without an 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. .. figure:: /images/share_secreturl_add.png :alt: Add a secret URL Add one or more secret URLs to a page or collection You can create a secret URL the following way: when you are on the :ref:`share overview page `: #. Click the *Edit secret URL access* button |secret_url| next to the collection or page for which you want to give access permissions under *Portfolio → Shared by me*. On the next screen... #. Click the *Add* button to generate a new secret URL. You can add as many secret URLs as you wish. #. :index:`Click ` the *Copy* button |copy| to copy the secret URL to your clipboard. You can then paste it into an email to send to somebody. #. You can click the *Edit* button |edit| to add a time restriction for access to your page / collection via this URL. The "From" and "To" date fields become visible when you click the *Edit* button. #. Type a start and / or end date (and time) manually following the pattern of YYYY/MM/DD HH:MM or select the date via the *Calendar* button |calendar|. #. Click the *Save* button to save the date access changes. #. Click the *Delete* button |delete| if you do not want to use this secret URL anymore. .. 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 *Administration → Configure site →* :ref:`User settings `.