How to Use the Zip Importer to Batch Import Content into Mukurtu

Last Updated: Jul 18, 2017 12:15PM PDT
Note: Mukurtu CMS uses CSV spreadsheets with UTF-8 character encoding. Some spreadsheet tools do not properly implement UTF-8 encoding. We have tested several tools and can recommend the following:
  • Google Sheets on Windows and macOS
  • LibreOffice on Windows and macOS
  • Apache Open Office on Windows and macOS
  • Excel on Windows (note that if a spreadsheet is incorrectly encoded in Excel, and then re-saved with UTF-8 encoding, despite showing the correct setting, the file may not actually be properly encoded. If this happens, copying and pasting the content into another tool such as Google Sheets usually corrects the encoding.)
  • Excel on macOS does NOT properly encode UTF-8 files, and will not work properly.
Note: this tool is only available for Mukurtu CMS 2.0.4 and above. For older versions, see How to Batch Import Digital Heritage Items Only
For a full explanation of all the metadata fields, see Digital Heritage Metadata Fields
From the Dashboard click Import Digital Heritage from Zip Archive in the Batch Import Content box.

Click Download a sample zip file to download a sample file structure CSV spreadsheets to use to stage your media and metadata.

Extract the zip file (varies by operating system).
The zip file contains 4 CSV files (communities.csv, digitalheritage.csv, media_images.csv, protocols.csv), and a media subfolder.
If the communities and protocols into which the digital heritage items will be uploaded already exist on the site, delete those files. They are used to create new communities and cultural protocols.

Within the media folder, ensure there is another subfolder for each media type being uploaded. Separate folders titled image, audio, video, or file will need to be created within the media folder. If only one media type is being uploaded, only create the appropriate folder.
Note: for this article, examples are only given for images.

Within the image subfolder, place the image files that will be uploaded as media assets and included in the digital heritage items.

In the top level folder, open the media_images.csv spreadsheet.

Each image file in the media/image subfolder will need to be entered in this spreadsheet. Required fields are GUID, Title, and Image.

GUID: Global Unique Identifier. A GUID generator can be used to generate as many as needed

Title: A descriptive, unique title is recommended. This is not shown to end users, but can be used to help locate items in the media library.

Image: This field needs to be filled to match the format
Where FILENAME.EXT exactly matches the filename of the image as it appears in the media/image subfolder.
Fill in all other fields as required by your internal workflow and policies.

In the top level folder, open the digitalheritage.csv spreadsheet.
Complete the spreadsheet, following the metadata field guidelines in Digital Heritage Metadata Fields Note: in the Media Assets field for the digital heritage item, enter the GUID of the corresponding image from the media_image.csv spreadsheet that you just entered. This differs from what is specified in the linked document.

Once all fields are complete, zip/compress the top level folder (varies by operating system)

From the Dashboard click Import Digital Heritage from Zip Archive in the Batch Import Content box.

Click Browse.

Locate and select the zipped folder.

Click Upload.

Wait for the folder to upload.
Click Import.

A confirmation message will display the number of atoms (media assets) created, and the number of nodes (digital heritage items) created.

Go to Browse Digital Heritage to view uploaded items.