digitaldu-frontend | Digital Collections DU front end | Awesome List library

Steps to configure Digital Collections app locally... "repository": "thumbnail" path must be a relative uri to DuraCloud resource. Will fetch thumbnail from Duracloud using this uri. "remote": Path in the "thumbnail" field will be sourced remotely. "iiif": IIIF Server will generate thumbnail derivative from the master object derivative. "kaltura": Source thumbnail image from Kaltura thumbnail api. Object index document requires "kaltura_id" or "entry_id" with the Kaltura video ID.
Steps to configure Digital Collections app locally... Clone the application files from Git repository(https://github.com/dulibrarytech/digitaldu-frontend.git") Run "sudo npm install" from the root folder to install dependencies Create a file ".env" in the project root folder. It should contain the following properties: NODE_ENV={production|development|devlog|devlogsearch} NODE_TLS_REJECT_UNAUTHORIZED=1 APP_HOST={nodejs app domain} APP_PORT={nodejs app port} WEB_SOCKET_DOMAIN=ws://localhost WEB_SOCKET_PORT=9007 ENABLE_TEST={if true and NODE_ENV is set to 'development': will include express router in /test folder} API_KEY={frontend api key} CLIENT_HOST={client domain - same as APP_HOST + APP_PORT unless dns is registered for client domain} # Use leading slash CLIENT_PATH={client relative path from domain} CONFIGURATION_FILE={name of main app configuration file} ELASTICSEARCH_HOST={elastic server domain} ELASTICSEARCH_PORT={elastic server port} ELASTICSEARCH_PUBLIC_INDEX={public elastic index} ELASTICSEARCH_PRIVATE_INDEX={private elastic index} REPOSITORY_DOMAIN={duraspace domain} REPOSITORY_PATH={relative duraspace dip-store url} REPOSITORY_PROTOCOL={http|https} REPOSITORY_USER={repository username} REPOSITORY_PWD={repository password} PDF_JS_VIEWER_PORT={port} IIIF_IMAGE_SERVER_URL={cantaloupe api domain} IIIF_IMAGE_SERVER_PATH={relative path to cantaloupe endpoint, blank if none} IIIF_DOMAIN={iiif api domain} IIIF_PATH={relative path to iiif, should be '/iiif'} APP_HOST is the url to the server. Do not add the port to this url, add that to APP_PORT. Set APP_PORT to whatever port the nodejs app should run on. CLIENT_HOST is the url to the client. Add the port to the end if necessary IIIF_URL can be localhost, as the service is included with DigitalCollections. Make sure the port listed here is the port that DigitalCollections is running on. Setup a local instance of Cantaloupe image server and update the CANTALOUPE_URL field in .env Update the settings file in /public/confog/configuration.js Run the app by using "node discovery.js" or "nodejs discovery.js" from the app root folder.
Relative path to Duracloud source file
Uri to remote file
Object Pid
Path includes "http[s]://" -> Absolute url, fetch remote. Assign the absolute url to the remote image to the "thumbnail" field.
Path includes slashes "/" -> Relative url. Only DuraCloud allowed, build DuraCloud Url, fetch via repository (DuraCloud source)
No protocol or slashes -> Assume object id (no filename allowed). Build /datastream uri (ddu frontend) and fetch remote (MUST be a different object than current datastream request object) This makes it possible to use the pid from another object in the repository for the thumbnail image. Assign the pid value directly to "thumbnail" field.
Update the search field object in "searchAllFields": set "isNestedType" property to "true"
If a date field is nested, update the "nestedDateField" config property to true
Update the sort config data in the "searchSortFields" object if the search fields contain "matchField" and "matchPhrase" data
Download and install the Cantaloupe image server (https://cantaloupe-project.github.io/), update the frontend .env file with the Cantaloupe port and url.