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

Last Updated: May 18, 2017 08:56AM PDT
Note: Excel for Mac does not properly encode files in UTF-8 and will result in errors, and cannot be used to prepare content. If working on a Mac, Numbers and Google Sheets both will encode files correctly.

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 https://www.guidgenerator.com/

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
[mukurtu:batch_import_temp_directory]/media/image/FILENAME.EXT
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.