.. include:: /shortcuts.rstext .. _dashboard: Dashboard ----------- .. index:: Login single: Temporarily lock account after too many wrong tries .. _login: Login ~~~~~~~~~~~ You always need a login to authenticate yourself and access your personal information, portfolio pages and groups that you belong to. You can log in on the Mahara homepage. .. figure:: ../images/login.* :alt: Login form Login form #. **Username**: Type your username in this field (not for SSO or Moodle accounts). #. **Password**: Provide your password. If you enter your password incorrectly 5 times in a row during one session, access is locked for 5 minutes before you can try again. #. Click the *Login* button to access your account. #. **Lost username / password**: If you do not remember your username or password to your account, click this link to be taken to a page where you can request an email with your details. It will contain your username and a link to change your password. #. **Register**: If you do not have an account, and your institution allows self-registration for an account, use this link and follow the instructions on the next page. #. **SSO login**: If you log in via your institution's SSO (single sign-on) account, please use this button to be taken to the SSO login. .. note:: The regular login form is only available for internal and LDAP accounts. Internal accounts are accounts for which you registered through your Mahara site or that were created by administrators either :ref:`manually `, or :ref:`by a CSV file upload `. The "Lost username / password" link only works for internal accounts where you use the regular login form. If you log in via SSO or Moodle for example, you must retrieve your password directly from these services. If you do not know how to do that, please ask your administrator. You only see the SSO buttons if SSO has been been enabled on your site for at least one institution. :index:`You ` can :ref:`hide the login form ` entirely from the homepage if your Mahara instance generally only connects to an external authentication method such as MNet or CAS. In these cases, your users will need to log in via a different site and seeing the login form on the homepage may only be confusing. Once you have hidden the login form, only a link to it is displayed on the homepage for an administrator to log into the site. .. figure:: ../images/login_link.* :alt: Link to the login form Link to the login form After you successfully logged in to Mahara, you see your *Dashboard*. This is your homepage where you can see the latest activity of you and other users on Mahara. You can customise the dashboard so that you always see the items that are most important to you. Only you can see your dashboard. Nobody else has access to it. .. index:: single: Accept legal statements on first login .. _login_strict_privacy: Login with strict privacy ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When the site administrator turned on :ref:`strict privacy `, you need to consent to the terms and conditions and the privacy statement of the site and maybe even an institution if you are a member of an institution before you can enter your account. If you don't, you have the opportunity to discuss your issues with them with an administrator. .. note:: When any of the statements changed, you will be presented with them again and need to make a decision about consenting or not. .. figure:: /images/settings_legal_registration.* :alt: Accept legal statements upon first login Accept legal statements upon first login #. Title of the legal statement. .. note:: There can be up to 4 statements that you may need to consent to. This depends on the setup of the site that you use. #. Click the *Retractable* icon |retractable| to close this section. This is helpful if the texts are very long. #. The date the statement was last updated is displayed. #. The text of the statement. #. If you consent to the statement, flip the switch to "Yes". .. note:: Before you consent to a statement, please read it carefully. If you do not understand a section or have questions, do not consent to it but leave it set to "No". When you save your changes, you will have the opportunity to detail why you do not consent and get in touch with the administrator to discuss your concern. #. Click the *Save changes* button to accept your decisions. .. index:: Dashboard single: Username display on the dashboard .. _dashboard_overview: Overview ~~~~~~~~~~~~~~ You can change certain aspects of your dashboard, namely the :ref:`user-specific information `, but a lot of what you see is static to allow you to quickly access other parts of Mahara. .. figure:: /images/dashboard_full.* :alt: the full dashboard Your homepage is your dashboard from which you can access a number of areas in Mahara conveniently. #. **Search**: :index:`Search ` for users who have an account to view their profile page and check which pages they have made accessible to you. If your site has fulltext search available, you can search for anything on the site using this search box. .. note:: In the *User search* box you can most often search for users' :ref:`display name `. Depending on the settings that the site administrator made, you may also be able to search for users' :ref:`real name and username `. If the site administrator allowed users to hide their real name, you can do so in your :ref:`general account options `. To provide you with the most relevant search results, you automatically search only for users within your own institution, but can choose to search for everyone on your Mahara installation on the :ref:`"People" page ` you are taken to. If the site administrator turned on :ref:`exact user search `, you need to provide the correct display name or real name in order to find another user. #. **Inbox**: Click the *Inbox* icon |inbox icon| to view all your notifications and send messages. #. **User menu**: Click the *User menu navigation* icon |menu open| to reach your account settings, profile, profile pictures, legal statements, connected apps, notification settings, and the logout link, or click your profile picture to be taken to your profile page. #. **Main menu**: Use the *Main menu navigation* icon |main menu| to navigate to other areas of your portfolio. .. note:: Administrators and staff who have access to the administration area, see the *Administration menu navigation* icon |admin menu| in addition to the main menu navigation so they can navigate within the administration area. #. **Quick links**: These :ref:`quick links ` take you directly to certain areas of Mahara. #. **Edit dashboard**: The *Edit dashboard* button allows you to jump directly into the edit screen for your dashboard without having to go to *Main menu → Create → Pages and Collections* first. .. note:: You cannot add a :ref:`skin ` to your dashboard page. #. **User-specific information**: You can customise :ref:`this area ` on your dashboard to put blocks there that you want to see every time you log in. #. **Personal information**: This sidebar block contains static and dynamic information: * Your name is linked to your profile page. * :index:`Your profile picture ` is linked to your :ref:`profile pictures page ` for easy uploading of new profile pictures. * If you are a member of any groups, they are displayed here. * Pending friend requests and group invitations are displayed. * If you tagged artefacts or pages with the tag "profile", a link to them is placed here. #. **Online users**: If this sidebar block is enabled, you see users who have been logged in during the last 10 minutes. Depending on the settings for your institution that the administrator chose, you may see all users, only users from your institution(s) or no users at all. #. **Profile completion**: You see this sidebar block if your site or institution administrators turned on the :ref:`profile completion ` functionality. #. **Links and resources**: List of links to websites or documents that are visible to all logged-in users or the public. .. index:: single: Dashboard; Navigation .. _navigation: Navigation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The app-style like navigation makes it easy to distinguish between the main navigation menu, the user menu, and the administration navigation. .. index:: single: Navigation; Main menu navigation .. _ main_menu: Main menu navigation ^^^^^^^^^^^^^^^^^^^^^^^^ The main menu is visible to all users and allows everyone to navigate to their content, portfolios, and groups. .. figure:: /images/navigation_main.* :alt: Main menu navigation The main menu is the same for everyone #. Click the *Main menu navigation* icon |main menu| to see a drop-down menu with the available options. #. Click one of the options to reach them. If there is another level of menu items, clicking the menu item or the the *Arrow down* icon |menu open| will display these. #. Click the title again or the *Arrow up* icon |menu close| to close the second level navigation. .. note:: You can also click anywhere in the entire bar that surrounds the menu item to trigger an action. #. Click a sub menu item to be taken to the appropriate page. .. index:: single: Navigation; Admin menu navigation .. _ admin_menu: Administration menu navigation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ If you have access to administration functionality, you see a second menu, the administration menu. .. note:: Depending on your permissions, you may not see all menu items. The menu displayed here is the one of the site administrator who can see everything in the administration menu. Staff and institution administrators see a subset of these items. .. figure:: /images/navigation_admin.* :alt: Administration menu navigation The administration menu is only available to staff and administrators. #. Click the *Administration menu navigation* icon |admin menu| to see a drop-down menu with the available options. #. Click one of the options to reach them. If there is another level of menu items, clicking the menu item or the the *Arrow down* icon |menu open| will display these. #. Click the title again or the *Arrow up* icon |menu close| to close the second level navigation. .. note:: You can also click anywhere in the entire bar that surrounds the menu item to trigger an action. #. Click a sub menu item to be taken to the appropriate page. .. index:: single: Navigation; User menu navigation .. _ user_menu: User menu navigation ^^^^^^^^^^^^^^^^^^^^^^^^ The user menu is visible to all users. It allows you to acces your account settings, inbox, and profile easily. .. figure:: /images/navigation_user.* :alt: User menu navigation The user menu is available to all users #. Click your profile picture to be taken to your profile page. #. Click the *Arrow down* icon |menu open| in the user menu to see additional options. #. **Your name**: Your name is displayed to indicate who is logged in esp. when viewing portfolio pages where the profile block is not visible. You can click on it to go to your profile page. .. note:: :ref:`If an administrator masquerades as another user `, this name helps to check quickly, in which account actions are undertaken. #. **Profile**: Jump to the settings page of your profile where you can change vital basic information. #. **Profile pictures**: Click this menu item to be taken to the page where you can manage your profile pictures. #. **Settings**: Top level navigation item that gives you access to more options. Click the text or the *Arrow down* icon |menu open| to see the secondary navigation: * **Settings**: This link gives you access to your :ref:`account settings and notifications ` * **Legal**: The legal texts, i.e. the privacy statement and the terms and conditions, are displayed that you have either actively or implicitely agreed to. * **Notifications**: Change your notification preferences. * **Apps**: See which apps you have connected to your account. #. **Logout**: Link to log out of your current session. .. index:: single: Dashboard; Quick links .. _dashboard_quick_links: Quick links ~~~~~~~~~~~~~~~ When you log in to Mahara, you see three new boxes with quick links: * **Create**: Create your electronic portfolio in a flexible personal learning environment. This takes you to *Main menu → Create → Pages and collections*. * **Share**: Share your achievements and development in a space you control. Clicking on this box takes you to *Main menu → Share → Shared by me*. * **Engage**: Engage with other people in discussion forums and collaborate in groups. This takes you to *Main menu → Engage → Groups*. .. figure:: /images/dashboard_boxes.* :alt: Dashboard boxes Mahara usage information and information when you hover over a box with your cursor With the help of these quick links you can reach the different parts of your portfolio directly from your dashboard. .. note:: If you removed these boxes from your dashboard but want to get them back at a later point, you can re-active them under *User menu → Settings → Preferences → Dashboard information*. If you do not see the dashboard boxes and do not have the option to turn this setting on, your site administrator disabled this feature in the :ref:`site configuration `. .. index:: single: Dashboard; Blocks .. _user_specific_information: User-specific information ~~~~~~~~~~~~~~~~~~~~~~~~~~~ The default dashboard includes the following blocks: * Latest changes I can view * My portfolios * Inbox * Topics I'm following These blocks are filled with content once you start using Mahara and create pages, receive messages from other users, have access to others' portfolio pages and use the forums for discussions. You can customize these blocks to your liking by editing your dashboard. Click the *Edit dashboard* button |edit_dashboard| directly on your dashboard or go to *Portfolio* in the navigation menu, click the *Edit* button |edit| next to the dashboard page and change the *blocks* like you would change them on any page in Mahara. .. seealso:: Refer to the :ref:`page editor ` for more information on adding and removing blocks from a page. The site administrator can change the default blocks on the dashboard page for new users in *Administration → Configure site → Pages*. .. _footerlinks: Footer ~~~~~~~~~~~~~~~~~ The footer is displayed on every page. If you have your custom theme, you can also make changes to the footer. .. figure:: /images/footer_links.* :alt: Links in the footer Links in the footer The default footer in a Mahara site can have links to: #. Legal: Terms and conditions and privacy statement(s). When a user is logged in, this page displays the statements that they consented to. They can find that page also via *User menu → Settings → Legal*. #. About: A page that the site administrator can change via :ref:`"Static pages" ` #. Contact us: A form for anyone on the site to contact the site administrator(s). A site administrator may overwrite this form and point to a different page or even an email address in the :ref:`menu configuration