Developer Area/Import//Export/LEAP Export

From Mahara Wiki
< Developer Area‎ | Import//Export
Revision as of 17:56, 9 May 2011 by Brettwilkins (talk | contribs) (Created page with "Mahara's Leap export is implemented as a plugin for Mahara's "Export" plugin type. It allows Mahara to export [http://wiki.cetis.ac.u…")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Mahara's Leap export is implemented as a plugin for Mahara's "Export" plugin type. It allows Mahara to export Leap2A files, which Mahara can also import.

Note:'' A working understanding of the Leap2A spec will help you understand the documentation written here. We suggest you at least partially familiarise yourself with the spec before diving into the code or this documentation.

Architecture

The Leap export plugin lives in htdocs/export/leap/. The core export algorithm is implemented here, as well as other parts necessary to implement the Mahara export API. Most of the work is done by the PluginExportLeap class, which represents the process of producing an export for an individual user.

In addition to this, each artefact plugin can provide the export/leap/lib.php file, which the plugin searches for in order to do most of the heavy lifting. The core Mahara artefact plugins all provide the ability to export their respective artefact types. If you are writing an artefact plugin and your plugin does not supply any artefact type that can be meaningly exported in a Leap file, you don't have to provide the export/leap/ directory at all.

Implementation

The export is generated by building a string containing the Leap2A XML, as well as copying files from their location in dataroot into a temporary directory. The XML is written to a leap2a.xml file, and the entire package is zipped up. The plugin provides the location of the zip file to caller.

Mostly, the XML is built by use of smarty templates.

Artefacts

Artefact plugins have two choices for implementing Leap2A export - either to generate XML for each artefact in turn, or generate XML all in one go for all of their artefacts.

If using the former method, there is a base class - LeapExportElement - provided to give rudimentary export of any artefact. The artefact plugin may have to extend this class to add extra information to the exported XML for artefacts of a given type. If this is the case, the artefact plugin can provide a LeapExportElement class (e.g. LeapExportElementBlog), which the plugin will automatically use when found.

If using the latter method, the artefact plugin needs to provide a LeapExport class that extends LeapExportArtefactPlugin. This class has one contract method - get_export_xml. It is then up to that method to generate all the XML for all artefacts in the plugin. The internal artefact plugin does this to generate the persondata element for the user who is exporting the portfolio.

Views

The plugin exports views itself as selections of the type 'Webpage'.

Exporting from Other Systems

We have documented the results of exporting to other systems, as well as importing, in the Interoperability section.

Subpages