.. 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:: 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. #. |new in Mahara 17.04| **Navigation**: 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. #. |new in Mahara 17.04| **User navigation**: Click the *User menu navigation* icon |menu open| to reach your account settings, inbox, and logout link, or click your profile picture to be taken to your profile page. #. **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:`"Find people" search 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. #. **Quick links**: These :ref:`quick links ` take you directly to certain areas of Mahara. #. **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. #. **Edit dashboard**: The *Edit dashboard* button allows you to jump directly into the edit screen for your dashboard without having to go to *Portfolio → Pages* first. .. note:: You cannot add a :ref:`skin ` to your dashboard page. #. **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 single: New in Mahara 17.04; App-style navigation .. _navigation: |new in Mahara 17.04| Navigation ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The navigation changed in Mahara 17.04 to a more app-style like one that users already know from mobile devices. The navigation makes it easier to distinguish between the main navigation menu and the administration navigation. .. note:: If you want to use the old navigation a little while longer, you can base your custom theme on the "Old raw" theme as parent theme. It was updated with a number of changes prior to moving to the app-style navigation so you can take advantage of more theme variables. You will need to make some changes to your custom theme to accommodate these improvements. The built-in themes are `available for download `_ using the old-style navigation. It is a snapshot taken before the new navigation was added. No future changes are made to these themes. You may need to make some changes in future yourself if you want to continue the old-style 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 or #. Click the *Arrow down* icon |menu open| to reach the second level navigation. You can then click the *Arrow up* icon |menu close| to close the second level navigation. .. index:: single: Navigation; Admin menu navigation .. _ admin_menu: Administration menu navigation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. note:: This menu is only available to staff and administrators. If you have access to administration functionality, you see a second menu, the administration menu. .. 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. Depending on your role, you may not see all the options shown in the screenshot. #. Click one of the options to reach them or #. Click the *Arrow down* icon |menu open| to reach the second level navigation. You can then click the *Arrow up* icon |menu close| to close the second level navigation. .. 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. #. **Settings**: Top level navigation item that gives you access to more options: * **Settings**: This link gives you access to your :ref:`account settings and notifications ` * **Notifications**: Change your notification preferences. * **Apps**: See which apps you have connected to your account. #. **Inbox**: Go to your Mahara inbox to check for new messages. When you have unread messages, the counter displays the number of unread messages. #. **Logout**: Link to log out of your current session. #. Click the *Arrow down* icon |menu open| to reach the second level navigation. You can then click the *Arrow up* icon |menu close| to close the second level navigation. .. 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 *Portfolio → Pages*. * **Share**: Share your achievements and development in a space you control. Clicking on this box takes you to *Portfolio → Shared by me*. * **Engage**: Engage with other people in discussion forums and collaborate in groups. This takes you to *Groups → Find 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 *Settings → 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 pages * My pages * 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*.