2. Inleiding

Welcome to the Mahara manual. This 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!

2.1. Wat 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 (back in the old days). 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 web services to integrate with other platforms.


Here’s a short video by Domi Sinclair, formerly at University College London. She explains what Mahara (called “MyPortfolio” at UCL) is and for what it can be used.

2.2. Using a metaphor

It often helps to use a metaphor to explain a new concept. There are many metaphors used for portfolios. Here are two of them to give you an idea of how you could explain portfolios to your learners.


Kate Coleman explores the idea of using metaphors for portfolio work in her PhD thesis.

Would you use any of these metaphors? Do you have your own?

2.2.2. The performance

The performance metaphor

The performance metaphor


This metaphor was introduced by Hazel Owen on her website. She shared her idea in the Mahara Newsletter January 2018.

An important aspect in this metaphor is the human element and that activities happen in communities and are not just things. In the performance metaphor we see that people interact in all matters from the preparation to the final performance and learn from each other.

In the backstage area, projects are discussed and conceptualised, changed, and finalised. A team is often involved in these processes giving feedback, and inviting newcomers / apprentices to try things out and learn from more experienced staff.

Depending on the director, a performance in one theatre may vary widely from that in another as a play can be interpreted many different ways, kept in its classic form, modernised or completely re-imagined. It is up to the company to settle on their interpretation and the way forward, which can include changes to the language, the mood, the back drops, and props used during the performance.

The backstage is only accessible to a group of authorised staff. Outsiders need a pass to be invited into this space.

Rehearsals play a fundamental role when preparing for a performance as they give the performer the time to practice their art, receive feedback from a teacher or also peers. They can practice in a safe space that is not accessible to an audience and thus don’t have to fear premature comments that would only be based on a small extract of the performance rather than its entirety.

Once the performance is deemed to be ready to be shown, often a dress rehearsal is scheduled to invite a select group of people for feedback and giving the troupe a chance to make final adjustments before the show is taken live.

Many different performances can take place within a building attracting different audiences, which in turn have different experiences that they bring to the events and see them through different eyes.

Some performances may require an entrance fee whereas others can be free. Some may also invite people to participate more fully in the performance itself rather than only sit and watch.

In Mahara this translates to:

  • Backstage: Artefact upload and creation and portfolio setup space before the learning evidence is shared with a wider group; portfolios can be created by individuals or in groups collaboratively.

  • Interpretations: Personalisation of each portfolio author in how they want to display their learning evidence, reflections, etc.

  • Rehearsals: Access given to a teacher or peers for feedback; not a one-time thing but iterative and supports growth of the portfolio author

  • Different performances: Being able to set up a variety of portfolios that serve different purposes and may or may not be connected

  • Entrance fee: Access permissions governing who can see which portfolio

2.3. Het Mahara framewerk

Met Mahara controleer jij welke items en welke informatie uit jou portfolio gezien kan worden door andere gebruikers. Zulke items en informatie worden artefacten genoemd. Om deze controlemogelijkheid mogelijk te maken, moeten alle artefacten die je wil delen met andere gebruikers geschikt worden in een bepaalde zone. In Mahara wordt zo’n compilatie van geselecteerde artefacten een ‘pagina’ genoemd. Je kunt zoveel pagina’s hebben als je wil, elk met een verschillend aantal artefacten, doel en publiek. Jouw publiek of de mensen aan wie je toegang wil geven tot jouw pagina, kunnen toegevoegd worden als individu of als lid van een groep. Je kunt je pagina zelfs openbaar maken.

Zou zou je bijvoorbeeld het volgende kunnen maken:

  • een pagina voor jouw vrienden en familie waarop vakantiefoto’s staan een een persoonlijk logboek

  • een pagina voor een tutor, waarop beoordelingen staan en jouw reflectief leerlogboek

  • een pagina om een tentoonstelling te maken van je beste werkstukken en je CV voor mogelijke werkgevers

Je portfolio kan opgebouwd zijn uit een enkele pagina of een collectie van pagina’s. Tot wanneer artefacten op een pagina gezet worden, zijn zij alleen voor jou zichtbaar. Je kunt geüploade bestanden of logboekitems die je geschreven hebt gebruiken op zoveel pagina’s als je maar wil. Je hebt slechts één exemplaar van je artefact nodig.

Beeld je in dat je al je artefacts in een schoendoos hebt verzameld. Wanneer je een nieuw artefact maakt, voeg je dat toe aan je schoendoos. Wanneer je klaar bent om je portfolio te maken, kun je naar de artefacten in je schoendoos kijken en er één of meer uitkiezen die je wil beschikbaar maken op je pagina. Je kunt de artefacten schikken op die pagina zoals jij wil dat het er uitziet.

artefact box

Portfolio work with Mahara

Het onderstaande diagram met voorbeeldartefacten, pagina’s en groepen toont hoe inhoud in Mahara gedeeld en hergebruikt kan worden in verschillende contexten en voor een verschillend publiek.

Mahara framework

Mahara framework

2.4. Hoe past Mahara in het landschap van het e-leren?

If you think of LMSs such as Moodle, Canvas, 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. This is not limited to SSO via MNet. 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.

2.5. Wat als er in Mahara functionaliteit ontbreekt die ik nodig heb?

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. Paid support is available through a network of Mahara Partners should you require it.

2.6. Andere dingen om te doen

Nu je een basisidee hebt van wat Mahara is, kun je:

2.7. Waar kan ik ideeën vinden over hoe Mahara te gebruiken?

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.

You may wish to check the list of books or papers that have been published on Mahara or what users talk about in conference presentations.

2.8. Hulp zoeken

  • Contextual help is available throughout Mahara via the Help icon . Click on it to find out more about the action you are about to perform.

  • You can also ask questions in the forums.

2.9. 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. We endeavour to keep up level AA to continue to provide good navigation of the site to everybody.

The Mahara project can only control the accessibility of the navigation and overall platform. People uploading or creating content are responsible themselves to make their content accessible.

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

2.10. 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:

  1. You can make sure to refer to the correct manual.

  2. You can find out whether you are on a currently supported version of Mahara or on an older one.

  3. If you are on an older version of Mahara, you can check the manual for the new features.

  4. 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.

HTML source with the Mahara version number

The HTML source reveals the Mahara version number

Firefox and Chrome / Chromium:

  1. In your browser, make a right-mouse click in any of your Mahara pages.

  2. Select the option “View Page Source”.

  3. Look for the meta tag “generator”.


  1. Make the “Develop menu” visible: Safari → Preferences → Advanced → select “Show develop menu in menu bar”.

  2. Make a right-mouse click in any of your Mahara pages.

  3. Select the option “Show Page Source”.

  4. Look for the meta tag “generator”.


Only the major version number of Mahara is displayed for security purposes. The minor version number is only visible to the administrator on Administration menu → 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.