Resources are media that can be used to augment and enhance texts or stand alone as items of inquiry or investigation on their own. There are eight resource kinds available in Manifold:
Each of those are discussed in detail in the Preparing Resources section.
In this space, devoted to the
Resource sidebar of the backend project page, we will consider how to add the resources you have already prepared into the system along the following themes:
- Required User Credentials
- Adding Resources Individually
- Adding Resources in Bulk
- Managing Resources
- Searching through Existing Resources
Details on how to place already loaded resources (or collections of resources) in a text is discussed in the Interface section.
Required User Credentials
To access the Resource sidebar a user who has a
Project Creator role will require either
Can Modify Metadata or
Can Modify Project permissions. Note that the former only allows the user to update the metadata for existing resources, not load new resources into the system.
Administrator roles will, by default, be able to update existing and upload new resources to any project in the instance where they have those credentials.
For more information about credentials, see the user accounts section.
Adding Resources Individually
To add Resources to a project one at a time, click the
Add a New Resource button below the resource search bar. The
New Resource page will appear and provide you the option to choose which of the eight kinds of resource you’d like to add.
A small subset of metadata fields specific to your resource will be present below the resource kinds. The fields vary depending on the resource kind in question. Generally you’ll be prompted to provide a
Description, and the actual file you are uploading as a resource. Only the
Title and resource file are required. The exceptions, described below affect the
After you’ve filled out the appropriate fields, click
Save and Continue. Your resource has now been loaded, and you can update the full range of fields and metadata associated with your resource. A table describing what options each resource kind has available to it can be found in the Preparing Resources section.
Videos can be uploaded directly into Manifold or they can be streamed from YouTube and Vimeo. To make the connection from Manifold to the external host, click the slider for
Is This an Externally Linked Video. When toggled on, two new fields appear:
Video ID and
External Video Type.
Video ID describes the unique identifier in the URL bar that is associated with the video in question. On YouTube it will appear after
watch?v= and before any string beginning with an ampersand
&. In the following, the
Video ID would be
On Vimeo the
Video ID is the number following
vimeo.com/. In this example, the
Video ID would be
External Video Type field is a dropdown used to select which service the video is hosted on: YouTube or Vimeo.
Instead of a file to upload,
Link resources require that you input the URL to the site you are using as a resource.
Instead of loading a file to the system, Manifold instead prompts the user to provide the URL of the site in question along with the minimum width and height (in pixels) for the iFrame wrapper. The minimum width and height help Manifold handle the iFrame responsively and determine how the content will render—inline or fullscreen—and whether it may be necessary to substitute the poster image, instead of the interactive element, in slideshows.
If you are unsure of the minimum width or height, leave those fields blank, and Manifold well calibrate the view based on the size of the reader’s screen size.
Adding Resources in Bulk
To add resources in bulk you’ll first need a CSV or Google Sheet describing the files you are uploading. A template for that purpose is provided here as the Manifold Resource Log. Add or adjust columns to suit your needs. Manifold’s upload process can be adapted to map data in different ways.
You will also need to save all your resources in a Google Drive folder with permissions extending viewing access to all those who have possession of the link. At this point only Google Drive is supported as viable means to host resources that are to be imported into the system. Your instance will need to have Google Services configured for this process to be successful. See the customizing external services section for more.
Once your sheet is filled out (and saved as a CSV) and your resources saved to Google, click
Bulk Add Resources to add a collection of resources in one step.
You will be taken to a screen where you can load your CSV file or provide the URL to a shared Google Sheet under the
Step 1: Upload heading. Below the
Step 2: Describe Data you should select from the dropdown the row number where your column headings appear (select
2 for the Manifold Resource Log) and then enter ID for the Google Drive folder where your resources are saved. The ID is the last part of the URL for your Google Drive folder after
When you click continue you’ll be taken to
Step 3: Map Columns to Resource Attributes. The column on the left side lists the column headers found in your spreadsheet. The column on the right lists the attributes that can be set on Manifold resources. Drag the attributes on the right to the corresponding columns on the left. The Resource Import Matrix below serves as a map between those columns.
Automatically Map Attributes button will attempt to automatically match the attributes with the spreadsheet columns. If you are using the Manifold Resource Log you’ll need to only map two attributes manually:
Video ID, and
When you click continue your resources will be uploaded into the system with the information from your sheet populating the appropriate fields for each. This process may take a few moment to complete. As it is working you will see regular updates to the status of your uploads.
To adjust the metadata for a resource that has been loaded into the system, click on the resources name in the list of those in the system. That will take you to that resource’s detail page, where information is spread across three sidebar headings:
Variants sidebar will only appear for
The Preparing Resources section describes all the available fields you can adjust and where they can be found in the system in detail.
Searching through Existing Resources
From the Resource page you can search through all resources that have been added to the project you are viewing. When you click
Show Search Options you’ll have the ability to refine your search by Tags as well as the Kind of resource you are looking for.
Resource Import Matrix
|Manifold Resource Log||Resource Metadata||Resource Attributes|
|Video ID||Video ID||external_id|
|Host Name||External Video Type||external_type|
|Allow Download?||Allow Download?||allow_download|
|Sub Kind||Externally Linked Video?||sub_kind|
|Minimum Width||Minimum Width||minimum_width|
|Minimum Height||Minimum Height||minimum_height|
|Series Title||Series Title||metadata.series_title|
|Original Publisher||Original Publisher||metadata.original_publisher|
|Original Publisher Place||Original Publisher Place||metadata.original_publisher_place|
|Original Title||Original Title||metadata.original_title|
|Publisher Place||Publisher Place||metadata.publisher_place|
|Series Number||Series Number||metadata.series_number|
|Copyright Holder||Rights Holder||metadata.rights_holder|
|Copyright Status||Copyright Status||metadata.copyright_status|
|High Res||High Resolution Image||attachment.high_res|
|File Variant 1||Variant (1)||attachment.variant_format_one|
|File Variant 2||Variant (2)||attachment.variant_format_two|
|Print Color Solution||—||—|
aThis field is automatically populated by the system and cannot be changed manually.