10.10. Experimental features

As site administrator you have three experimental features available to you:

  • bulk export of Leap2A files
  • bulk import of Leap2A files
  • usersuniquebyusername variable

You cannot access these features from any navigation, but you must type the URL directly in the case of the bulk options or set up a config.php variable.

Warning

The export and import of portfolios uses quite a lot of computing power. Therefore, these bulk options require even more memory. Please try them first out on a test installation or export / import only a small number of users instead of an entire institution at once.

10.10.1. Bulk export of Leap2A files

[your regular Mahara URL]/admin/users/bulkexport.php

If you need to export the portfolios of multiple users at once, you can do so from the bulk export page. Please remember that this is an experimental feature at the moment.

Experimental feature: Bulk export

Experimental feature: Bulk export

  1. Institution: Choose the institution from the drop-down menu for which you want to export all user portfolios in the Leap2A format.
  2. Usernames to export: Alternatively, choose this option if you only wish to export some users’ portfolios. Each username must be on a separate line.
  3. Click the Export users button to start the export process. This might take a while.

Note

You can look up the usernames on the user search page or if you exported a CSV file of users, you have the usernames in there as well.

10.10.2. Bulk import of Leap2A files

[your regular Mahara URL]/admin/users/bulkimport.php

If you need to import the portfolios of multiple users at once, you can do so from the bulk import page. Please remember that this is an experimental feature at the moment. You must have Leap2A files to import. The import of HTML files is not possible.

The easiest option to import user portfolios in bulk is to use the bulk export file as all information is contained therein. If that is not possible, you can create the necessary ZIP file manually.

10.10.2.1. Bulk import using a bulk export file

Experimental feature: Bulk import

Experimental feature: Bulk import

Ideally, you have exported the users you wish to import using the bulk export functionality on the other Mahara instance. Then the bulk export file already contains all necessary files and mappings.

Note

Before importing these new user accounts, you can change the usernames for these new accounts in the usernames.csv file that is included in the bulk export file.

  1. Institution: Choose the institution in which the users shall become members.
  2. Bulk export file: Choose the bulk export ZIP file which contains all users that shall be created. A new user account will be created for each of them.
  3. Email users about their account: Check this option if the new users shall receive an email about their new account. This is especially important if they do not know that their account has been moved or if you want to change their username. Don’t use this option if you want to use an external authentication method for their account. They would be emailed their internal Mahara account details but then not be able to use them.
  4. Click the Import button to start the process. Please be patient as the import may take some time.

10.10.2.2. Bulk import from scratch

If you want to import user portfolios into one institution using their Leap2A files that you did not receive via the bulk export functionality, you can still import them in bulk.

  1. Create a folder, e.g. mahara-bulk-import.
  2. Create the CSV file usernames.csv in the folder mahara-bulk-import.
  3. Create a line for each user that you are importing that contains the username and the name of the ZIP file that contains the corresponding Leap2A file.
  4. Create the sub folder users in it. Do not choose a different name.
  5. Place all Leap2A files that you wish to import into one institution into the users sub folder. Make sure that each ZIP file has a corresponding entry in usernames.csv.
  6. Create a ZIP file from the folder mahara-bulk-import once you have all users in it.
  7. Go to [your regular Mahara URL]/admin/users/bulkimport.php.
  8. Institution: Choose the institution in which the users shall become members.
  9. Bulk export file: Choose the bulk export ZIP file which contains all users that shall be created. A new user account will be created for each of them.
  10. Email users about their account: Check this option if the new users shall receive an email about their new account. This is especially important if you change their username and if they do not know that their account has been moved.
  11. Click the Import button to start the process. Please be patient as the import may take some time.

Note

The CSV file usernames.csv should look like this and does not have a header row:

"petra","mahara-export-leap-user4-1334451885.zip"
"polly","mahara-export-leap-user5-1334451888.zip"

10.10.3. usersuniquebyusername variable

usersuniquebyusername is a config.php setting that should be used with extreme caution as it could be misused.

Below is the documentation that can be found in the code. This feature is discussed for example in the discussion topics Mahara Moodle integration and bug? and SSO: Mahara to Moodle.

Note

When turned on, this setting means that it does not matter which other application the user SSOs from, they will be given the same account in Mahara.

This setting is one that has security implications unless only turned on by people who know what they are doing. In particular, every system linked to Mahara should be making sure that same username == same person. This happens for example if two Moodles are using the same LDAP server for authentication.

If this setting is on, it must NOT be possible to self register on the site for ANY institution - otherwise users could simply pick usernames of people’s accounts they wished to steal. That is why you should not see the registration checkboxes in any institution if you have this feature turned on.