.. include:: /shortcuts.rstext Introduction ---------------- Welcome to the *Mahara user manual*. This user manual is designed to provide documentation for people who use Mahara on a day-to-day basis. It covers the functionalities of Mahara to provide you with information about what you see on the screen. Without further ado, let's begin! .. index:: single: Mahara; What is it? What is Mahara? ~~~~~~~~~~~~~~~~~~ If you're wondering what Mahara or an ePortfolio is, why you might want one and what it can do for you, then read on. You're about to find out. At the simplest level, Mahara is two things: an `ePortfolio `_ and a `social networking `_ system combined. An ePortfolio is a system in which students can record "evidence of lifelong learning" -- such as essays, artwork or other such things they produce that can be stored digitally. Such things are known as *artefacts* in Mahara. Social networking systems need little introduction -- think `Bebo `_, `Facebook `_ or `MySpace `_. Basically, they give a way for people to interact with their friends and create their own online communities. But Mahara is much more than just a place to store files. Mahara also includes blogging, a résumé builder, and `Moodle `_ integration. .. note:: Here's a short video by `Domi Sinclair `_ from `University College London `_. She explains what Mahara (called "MyPortfolio" at UCL) is and for what it can be used. .. raw:: html .. index:: single: Mahara; Framework .. _mahara_framework: The Mahara framework ~~~~~~~~~~~~~~~~~~~~~~ With Mahara, *you* control which items and what information within your portfolio other users see. Such items and information are termed artefacts. To facilitate this access control, all artefacts you wish to show to other users need to be arranged into one area. In Mahara this compilation of selected artefacts is called a 'page'. You can have as many pages as you like, each with a different number of artefacts, intended purpose and audience. Your audience, or the people you wish to give access to your page, can be added as individuals or as a member of a group. It can even be made publicly available. For example you could create: * a page for your friends and family that includes holiday photos and a personal journal * a page for your tutor, which includes assessments and your reflective learning journal * a page to showcase your best pieces of work and your résumé for potential employers * ... A single page or a *collection* of pages can make up your portfolio. Unless artefacts are placed in a page, they are not visible to anybody but you. You can use files that you uploaded or journal entries you wrote in as many pages as you wish. You only need one copy of your artefact. Imagine you collected all your artefacts in a shoe box. Whenever you have a new artefact, you add it to the shoe box. When you are ready to create your portfolio, you take a look at the artefacts in your shoe box and choose those that you want to make available on a portfolio page. You can arrange the artefacts on that page to your liking. .. figure:: /images/artefact_box.* :alt: artefact box :width: 800 px Portfolio work with Mahara The diagram below of example artefacts, pages and groups illustrates how content in Mahara can be shared and reused in different contexts and for different audiences. .. figure:: /images/mahara_framework.* :alt: Mahara framework :width: 600 px Mahara framework .. index:: single: Mahara; E-learning How does Mahara fit in to the e-learning landscape? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you think of `LMSs `_ such as Moodle, Sakai and Blackboard as the formal, structured side of e-learning, then Mahara is the social, reflective side. An LMS and an ePortfolio complement one another in an online learning environment. In particular, while Mahara's APIs are open to all, Mahara can integrate with Moodle natively to provide a streamlined user experience. Since Moodle 2.0 this is not only limited to SSO via MNet, but students are able to export assignments, blogs and much more straight into Mahara to use as artefacts -- which can then, of course, be placed into pages. .. index:: single: Mahara; Enhancing the software What if Mahara does not support a feature I want? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Mahara has been designed from the ground up to be an open, pluggable system. Creating new artefacts, authenticating against a custom system and much more can be implemented simply through writing a plugin that uses the appropriate core API. What this means is that it is free and easy for you to customise almost anything about Mahara to suit your needs -- and `paid support is available `_ through a network of Mahara Partners should you require it. .. index:: single: Mahara; Get involved single: Mahara; Test it Other things to do ~~~~~~~~~~~~~~~~~~~~~~~ Now you have a basic idea of what Mahara is, you could: * Read the list of features that Mahara comes with. * `Explore the demo `_ or `download Mahara `_ for yourself to play with. * `Sign up to the mahara.org community `_ and begin asking questions and contributing in the `forums `_. * Continue reading this user guide. .. index:: single: Mahara; Usage single: Mahara; Books Where can I get ideas of how to use Mahara? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The `Mahara newsletter `_ features individuals and institutions and their use of Mahara. You can subscribe to it or read it online. It is published four times a year, and you can contribute your ideas as well. The `Mahara 1.4 Cookbook `_ by Ellen Marie Murphy was published in September 2011. It has over 50 ideas of how to use Mahara in different settings. The book can be purchased in PDF and paper formats. The `Mahara E-Portfolios: Beginner's Guide `_ by Derrin Kent and Richard Hand is the updated edition of the `Mahara 1.2 E-Portfolios: Beginner's Guide `_ and a great reference for step-by-step instructions on how to create a portfolio and perform other tasks. You may also wish to check what other `books `_ or `papers `_ have been published on Mahara or what users talk about in `conference presentations `_. .. index:: single: Mahara; Help Getting help ~~~~~~~~~~~~~~ * Contextual help is available throughout Mahara. Watch out for the *Help* icon |help|. Click on it to find out more about the action you are about to perform. * You can also ask questions in the `forums `_. .. index:: single: Accessibility Mahara and accessibility ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Mahara aims to be usable by as many individuals as possible, including those with disabilities or special needs. Creating accessible web content is a requirement in many countries. In order to provide international guidelines, the Web Content Accessibility Guidelines (WCAG) were created. There are three conformance levels under the `WCAG 2.0 `_, the latest edition of the guidelines: A, AA, and AAA. Each level requires conformance with previous levels and includes its own specific guidelines for how websites should be made accessible. With version 1.9, Mahara has reached level AA for user-facing areas of the system. The administration of Mahara is predominantly on level AA as well. Only a few things need to be corrected. If you come across accessibility issues, please `file a report in our bug tracker `_ and tag the item "accessibility". If you are a screen reader user, you can use the following access keys to navigate the main menu items in Mahara: **Regular user interface**: * **d**:Dashboard * **c**: Content * **p**: Portfolio * **g**: Groups * **a**: Administration **Administrator interface**: * **a**: Admin home * **c**: Configure site * **u**: Users * **g**: Groups * **i**: Institutions * **e**: Extensions * **h**: Return to site .. index:: single: Mahara; Version number Which version of Mahara do I have? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you do not have access to the administration area, you do not see immediately which version of Mahara you use. Knowing the Mahara version has a couple of advantages: #. You can make sure to refer to the correct user manual. #. You can find out whether you are on a currently supported version of Mahara or on an older one. #. If you are on an older version of Mahara, you can check the user manual for the new features. #. When you `report a bug `_, you are often asked to specify the version of Mahara in which you noticed the problem. You can find out easily which version of Mahara you use by looking at the site's HTML source. It's not as scary as it sounds. .. figure:: /images/mahara_version.* :alt: HTML source with the Mahara version number The HTML source reveals the Mahara version number Firefox and Chrome / Chromium: #. In your browser, make a right-mouse click in any of your Mahara pages. #. Select the option "View Page Source". #. Look for the meta tag "generator". Safari: #. Make the "Develop menu" visible: *Safari → Preferences → Advanced → select "Show develop menu in menu bar"*. #. Make a right-mouse click in any of your Mahara pages. #. Select the option "Show Page Source". #. Look for the meta tag "generator". .. note:: Only the major version number of Mahara is displayed for security purposes. The minor version number is only visible to the administrator on *Administration → Admin home*. We recommend you keep Mahara up-to-date with security updates to ensure that your instance is not vulnerable to known security issues.